Skip to main content
Glama
rex-automata

Crypto MCP Server

by rex-automata
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Remote

šŸ” Crypto MCP Server

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

License: MIT TypeScript MCP

šŸš€ 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

šŸ“¦ 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

  1. Install dependencies

npm install

  1. Configure environment variables

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

  1. Build the project

npm run build

  1. Test the server

npm start

šŸ”‘ API Keys

Required APIs (Free Tier)

Etherscan API

CoinGecko API

Solana RPC

Blockchain.info (Bitcoin)

šŸ› ļø 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

āš ļø 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

Built with ā¤ļø for the MCP community