Crypto Trader MCP Tool

Crypto Trader MCP Tool for Claude Desktop

An MCP (Model Context Protocol) tool that provides cryptocurrency market data using the CoinGecko API, specifically designed for Claude Desktop.

Tutorial

For a detailed guide on setting up and using this tool, check out our Medium tutorial: Tutorial: Using Claude Desktop with Crypto Trader MCP Tool to Get Real-Time Cryptocurrency Data

Features

Real-time cryptocurrency price data
Detailed market information for cryptocurrencies
Historical price charts
Cryptocurrency search functionality
Trending cryptocurrencies tracking
Global market statistics

Setup

Ensure you have Python 3.10 or higher installed
Install dependencies:

pip install -r requirements.txt

Integration with Claude Desktop

Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:

{
  "mcpServers": {
    "crypto-trader": {
      "command": "py",
      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
    }
  }
}

Replace the path with the full path to your main.py file
Run the server using:

py -3.13 main.py

Keep the server running while using Claude Desktop

Available Tools

1. get_crypto_price

Get real-time cryptocurrency price information:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "price": 65423.12,
    "change_24h": 2.5,
    "volume_24h": 28345678901,
    "market_cap": 1234567890123,
    "timestamp": "2025-03-15T10:30:00"
}

2. get_crypto_market_data

Get detailed market information for a cryptocurrency:

{
    "symbol": "ETH",
    "name": "Ethereum",
    "market_cap_rank": 2,
    "current_price": 3521.48,
    "market_cap": 423456789012,
    "total_volume": 15834567890,
    "high_24h": 3580.25,
    "low_24h": 3475.62,
    "price_change_24h": 45.86,
    "price_change_percentage_24h": 1.32,
    "circulating_supply": 120283456,
    "total_supply": 120283456,
    "max_supply": null,
    "ath": 4878.26,
    "ath_date": "2021-11-10T14:24:11.849Z",
    "atl": 0.432979,
    "atl_date": "2015-10-20T00:00:00.000Z"
}

3. get_crypto_historical_data

Get historical price data for a cryptocurrency:

{
    "symbol": "BTC",
    "name": "bitcoin",
    "days": 30,
    "prices": [
        {
            "date": "2025-02-15T00:00:00",
            "price": 62150.23
        },
        {
            "date": "2025-02-16T00:00:00",
            "price": 63421.15
        }
        // ... more data points
    ]
}

4. search_crypto

Search for cryptocurrencies:

{
    "results": [
        {
            "id": "bitcoin",
            "symbol": "BTC",
            "name": "Bitcoin"
        },
        {
            "id": "bitcoin-cash",
            "symbol": "BCH",
            "name": "Bitcoin Cash"
        }
        // ... more results
    ]
}

Get trending cryptocurrencies:

{
    "trending_coins": [
        {
            "id": "pendle",
            "name": "Pendle",
            "symbol": "PENDLE",
            "market_cap_rank": 85,
            "price_btc": 0.00002356
        }
        // ... more trending coins
    ]
}

6. get_global_crypto_data

Get global cryptocurrency market data:

{
    "active_cryptocurrencies": 12875,
    "markets": 892,
    "total_market_cap_usd": 2347890123456,
    "total_volume_usd": 89723456789,
    "market_cap_percentage": {
        "BTC": 52.4,
        "ETH": 18.2
        // ... more cryptocurrencies
    },
    "updated_at": "2025-03-15T10:30:00"
}

Sample Queries

You can ask Claude Desktop questions like:

"What's the current price of Bitcoin?"
"Show me detailed market data for Ethereum"
"What's the price history of Dogecoin for the last 30 days?"
"Search for cryptocurrencies related to 'sol'"
"Which cryptocurrencies are trending today?"
"What's the total cryptocurrency market capitalization right now?"

Error Handling

All tools include proper error handling and will return an error message if something goes wrong:

{
    "error": "Failed to fetch price for INVALID_SYMBOL"
}

Troubleshooting

If the MCP server is not working in Claude Desktop:

Make sure the server is running - you should see output when you start the script
Verify the path in your settings is correct and absolute
Make sure Python 3.10+ is in your system PATH
Check that all dependencies are installed
Try restarting Claude Desktop
Check logs for any error messages

Rate Limits

This tool uses the free CoinGecko API which has rate limits. Please be aware that very frequent requests may be throttled by the API.

License

MIT License

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides cryptocurrency market data using the CoinGecko API

Related MCP Servers

coincap-mcp
QuantGeekDev
A
security
A
license
A
quality
Real-time cryptocurrency market data integration using CoinCap's public API, providing access to crypto prices and market information without API keys
Last updated -
3
147
37
TypeScript
MIT License
Coinmarket
anjor
-
security
A
license
-
quality
Coinmarket API integration to fetch cryptocurrency listings and quotes
Last updated -
2
21
Python
MIT License
CoinGecko MCP Server
crazyrabbitLTC
A
security
A
license
A
quality
Enables interaction with the CoinGecko Pro API to access cryptocurrency data including price history and market metrics through both MCP and OpenAI function calling.
Last updated -
5
5
JavaScript
MIT License
CoinMarketCap MCP Server
szcharlesji
-
security
A
license
-
quality
Real-time access to cryptocurrency data from the CoinMarketCap API.
Last updated -
24
1
TypeScript
MIT License

View all related MCP servers

Crypto Trader MCP Tool