saintdoresh/Crypto-Trader-MCP-ClaudeDesktop

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
1. Ensure you have Python 3.10 or higher installed
2. Install dependencies:
bash
pip install -r requirements.txt
## Integration with Claude Desktop
1. Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:
json
"mcpServers": {
"crypto-trader": {
"command": "py",
"args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
2. Replace the path with the full path to your main.py file
3. Run the server using:
bash
py -3.13 main.py
4. Keep the server running while using Claude Desktop
## Available Tools
### 1. getcryptoprice
Get real-time cryptocurrency price information:
json
"symbol": "BTC",
"name": "bitcoin",
"price": 65423.12,
"change24h": 2.5,
"volume24h": 28345678901,
"marketcap": 1234567890123,
"timestamp": "2025-03-15T10:30:00"
### 2. getcryptomarketdata
Get detailed market information for a cryptocurrency:
json
"symbol": "ETH",
"name": "Ethereum",
"marketcaprank": 2,
"currentprice": 3521.48,
"marketcap": 423456789012,
"totalvolume": 15834567890,
"high24h": 3580.25,
"low24h": 3475.62,
"pricechange24h": 45.86,
"pricechangepercentage24h": 1.32,
"circulatingsupply": 120283456,
"totalsupply": 120283456,
"maxsupply": null,
"ath": 4878.26,
"athdate": "2021-11-10T14:24:11.849Z",
"atl": 0.432979,
"atldate": "2015-10-20T00:00:00.000Z"
### 3. getcryptohistoricaldata
Get historical price data for a cryptocurrency:
json
"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. searchcrypto
Search for cryptocurrencies:
json
"results": [
"id": "bitcoin",
"symbol": "BTC",
"name": "Bitcoin"
},
"id": "bitcoin-cash",
"symbol": "BCH",
"name": "Bitcoin Cash"
// ... more results
### 5. gettrendingcrypto
Get trending cryptocurrencies:
json
"trendingcoins": [
"id": "pendle",
"name": "Pendle",
"symbol": "PENDLE",
"marketcaprank": 85,
"pricebtc": 0.00002356
// ... more trending coins
### 6. getglobalcryptodata
Get global cryptocurrency market data:
json
"activecryptocurrencies": 12875,
"markets": 892,
"totalmarketcapusd": 2347890123456,
"totalvolumeusd": 89723456789,
"marketcappercentage": {
"BTC": 52.4,
"ETH": 18.2
// ... more cryptocurrencies
},
"updatedat": "2025-03-15T10:30:00"
## Sample Queries
You can ask Claude Desktop questions like: