🔐 Crypto MCP Server

The first blockchain & cryptocurrency MCP server - Connect AI agents to Ethereum, Solana, Bitcoin, and cryptocurrency markets.

🚀 Features

• Multi-Chain Support: Ethereum, Solana, and Bitcoin

• Wallet Balance Queries: Check balances for any address

• Transaction History: Get detailed transaction data

• Real-Time Prices: Live cryptocurrency prices from CoinGecko

• Gas Price Monitoring: Track Ethereum gas prices

• Whale Tracking: Monitor large wallet movements

• Token Information: ERC-20 token balances and data

• Market Data: Top tokens, price history, and search

Related MCP server: Armor Crypto MCP

📦 Installation

Prerequisites

• Node.js 18.0.0 or higher

• npm or yarn

• API keys (see API Keys section)

Quick Start

1. Clone or download this repository

git clone https://github.com/rex-automata/crypto-mcp-server.git
cd crypto-mcp-server

2. Install dependencies

npm install

3. Configure environment variables

cp .env.example .env
# Edit .env and add your API keys

4. Build the project

npm run build

5. Test the server

npm start

🔑 API Keys

Required APIs (Free Tier)

Etherscan API

• Get it at: https://etherscan.io/apis

• Free tier: 5 calls/second, 100,000 calls/day

• Add to .env: ETHERSCAN_API_KEY=your_key_here

CoinGecko API

• Get it at: https://www.coingecko.com/en/api/pricing

• Free tier: Works without API key (50 calls/minute)

• Pro tier: Higher rate limits available

• Add to .env: COINGECKO_API_KEY=your_key_here (optional)

Solana RPC

• Default: Uses public endpoint (https://api.mainnet-beta.solana.com)

• Free upgrades: Alchemy (https://www.alchemy.com) or QuickNode (https://www.quicknode.com)

• Add to .env: SOLANA_RPC_URL=your_rpc_url (optional)

Blockchain.info (Bitcoin)

• No API key required for basic usage

• Higher limits available at https://www.blockchain.com/api

🛠️ Usage

MCP Client Configuration

Add to your MCP client settings (e.g., Claude Desktop):

{
  "mcpServers": {
    "crypto": {
      "command": "node",
      "args": ["/path/to/crypto-mcp-server/dist/index.js"],
      "env": {
        "ETHERSCAN_API_KEY": "your_key_here",
        "COINGECKO_API_KEY": "your_key_here",
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
      }
    }
  }
}

Available Tools

Ethereum Tools

• get_eth_balance - Get ETH balance for an address

• get_eth_transactions - Get transaction history

• get_gas_price - Get current gas prices

• get_token_balance - Get ERC-20 token balance

Solana Tools

• get_sol_balance - Get SOL balance for an address

• get_sol_transactions - Get transaction history

Bitcoin Tools

• get_btc_balance - Get BTC balance for an address

• get_btc_transactions - Get transaction history

• get_btc_stats - Get Bitcoin network statistics

Price Tools

• get_token_price - Get current price for a cryptocurrency

• get_multiple_prices - Get prices for multiple tokens

• get_top_tokens - Get top cryptocurrencies by market cap

• search_token - Search for a cryptocurrency

• get_price_history - Get historical price data

Whale Tracking Tools

• is_whale_address - Check if an address is a whale

• get_whale_transactions - Get large transactions for an address

• get_known_whale_addresses - Get list of known whale addresses

💡 Example Usage

// Get Ethereum balance
{
  "tool": "get_eth_balance",
  "arguments": {
    "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
  }
}

// Get Bitcoin price
{
  "tool": "get_token_price",
  "arguments": {
    "coinId": "bitcoin"
  }
}

// Check if address is a whale
{
  "tool": "is_whale_address",
  "arguments": {
    "address": "0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8",
    "chain": "ethereum"
  }
}

// Get top 10 cryptocurrencies
{
  "tool": "get_top_tokens",
  "arguments": {
    "limit": 10
  }
}

📁 Project Structure

crypto-mcp-server/
├── index.ts                 # Main MCP server
├── tools/
│   ├── ethereum.ts         # Ethereum tools
│   ├── solana.ts           # Solana tools
│   ├── bitcoin.ts          # Bitcoin tools
│   ├── prices.ts           # Price tracking tools
│   └── whale.ts            # Whale tracking tools
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

🚧 Roadmap

Phase 1: Core Features (Current)

• ✅ Multi-chain balance queries

• ✅ Transaction history

• ✅ Price tracking

• ✅ Gas monitoring

• ✅ Basic whale tracking

Phase 2: Premium Features (Planned)

• 🔲 Real-time transaction monitoring webhooks

• 🔲 Advanced whale alerts (Telegram/Discord notifications)

• 🔲 Portfolio tracking across chains

• 🔲 NFT balance and floor price tracking

• 🔲 DeFi protocol integration (Uniswap, Aave, etc.)

• 🔲 Custom alert conditions

• 🔲 Historical data export

Phase 3: Enterprise Features

• 🔲 Multi-user support with API key management

• 🔲 Rate limiting and quota management

• 🔲 Advanced analytics and reporting

• 🔲 Custom RPC endpoints

• 🔲 White-label deployment options

💰 Monetization Strategy

1. Freemium Model

   • Free tier: Basic queries with public APIs

   • Pro tier ($9/month): Higher rate limits, more chains

   • Enterprise tier ($99/month): Custom features, dedicated support

2. API Access

   • Sell API access to the MCP server

   • Volume-based pricing

3. Premium Features

   • Real-time alerts: $5/month

   • Advanced whale tracking: $15/month

   • Portfolio analytics: $10/month

4. Consulting/Custom Development

   • Custom blockchain integrations

   • Private deployment

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/AmazingFeature)

3. Commit your changes (git commit -m 'Add some AmazingFeature')

4. Push to the branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• GitHub: https://github.com/rex-automata/crypto-mcp-server

• MCP Documentation: https://modelcontextprotocol.io

• Issues: https://github.com/rex-automata/crypto-mcp-server/issues

⚠️ Disclaimer

This software is provided for informational purposes only. It does not constitute financial advice. Always do your own research before making any investment decisions.

📧 Contact

• GitHub: @rex-automata

• Issues: GitHub Issues

Built with ❤️ for the MCP community