Crypto Trader MCP Tool for Claude Desktop

1# Crypto Trader MCP Tool for Claude Desktop
2 
3An MCP (Model Context Protocol) tool that provides cryptocurrency market data using the CoinGecko API, specifically designed for Claude Desktop.
4 
5## Tutorial
6 
7For a detailed guide on setting up and using this tool, check out our Medium tutorial:
8[Tutorial: Using Claude Desktop with Crypto Trader MCP Tool to Get Real-Time Cryptocurrency Data](https://medium.com/@saintdoresh/tutorial-using-claude-desktop-with-crypto-trader-mcp-tool-to-get-real-time-cryptocurrency-data-4df25ecede33)
9 
10## Features
11 
12- Real-time cryptocurrency price data
13- Detailed market information for cryptocurrencies
14- Historical price charts
15- Cryptocurrency search functionality
16- Trending cryptocurrencies tracking
17- Global market statistics
18 
19## Setup
20 
211. Ensure you have Python 3.10 or higher installed
22 
232. Install dependencies:
24```bash
25pip install -r requirements.txt
26```
27 
28## Integration with Claude Desktop
29 
301. Configure your MCP settings in Claude Desktop by adding the following to your MCP configuration:
31 
32```json
33{
34  "mcpServers": {
35    "crypto-trader": {
36      "command": "py",
37      "args": ["-3.13", "C:\\Path\\To\\Your\\Crypto-Trader-MCP-ClaudeDesktop\\main.py"]
38    }
39  }
40}
41```
42 
432. Replace the path with the full path to your main.py file
443. Run the server using:
45```bash
46py -3.13 main.py
47```
484. Keep the server running while using Claude Desktop
49 
50## Available Tools
51 
52### 1. get_crypto_price
53Get real-time cryptocurrency price information:
54```json
55{
56    "symbol": "BTC",
57    "name": "bitcoin",
58    "price": 65423.12,
59    "change_24h": 2.5,
60    "volume_24h": 28345678901,
61    "market_cap": 1234567890123,
62    "timestamp": "2025-03-15T10:30:00"
63}
64```
65 
66### 2. get_crypto_market_data
67Get detailed market information for a cryptocurrency:
68```json
69{
70    "symbol": "ETH",
71    "name": "Ethereum",
72    "market_cap_rank": 2,
73    "current_price": 3521.48,
74    "market_cap": 423456789012,
75    "total_volume": 15834567890,
76    "high_24h": 3580.25,
77    "low_24h": 3475.62,
78    "price_change_24h": 45.86,
79    "price_change_percentage_24h": 1.32,
80    "circulating_supply": 120283456,
81    "total_supply": 120283456,
82    "max_supply": null,
83    "ath": 4878.26,
84    "ath_date": "2021-11-10T14:24:11.849Z",
85    "atl": 0.432979,
86    "atl_date": "2015-10-20T00:00:00.000Z"
87}
88```
89 
90### 3. get_crypto_historical_data
91Get historical price data for a cryptocurrency:
92```json
93{
94    "symbol": "BTC",
95    "name": "bitcoin",
96    "days": 30,
97    "prices": [
98        {
99            "date": "2025-02-15T00:00:00",
100            "price": 62150.23
101        },
102        {
103            "date": "2025-02-16T00:00:00",
104            "price": 63421.15
105        }
106        // ... more data points
107    ]
108}
109```
110 
111### 4. search_crypto
112Search for cryptocurrencies:
113```json
114{
115    "results": [
116        {
117            "id": "bitcoin",
118            "symbol": "BTC",
119            "name": "Bitcoin"
120        },
121        {
122            "id": "bitcoin-cash",
123            "symbol": "BCH",
124            "name": "Bitcoin Cash"
125        }
126        // ... more results
127    ]
128}
129```
130 
131### 5. get_trending_crypto
132Get trending cryptocurrencies:
133```json
134{
135    "trending_coins": [
136        {
137            "id": "pendle",
138            "name": "Pendle",
139            "symbol": "PENDLE",
140            "market_cap_rank": 85,
141            "price_btc": 0.00002356
142        }
143        // ... more trending coins
144    ]
145}
146```
147 
148### 6. get_global_crypto_data
149Get global cryptocurrency market data:
150```json
151{
152    "active_cryptocurrencies": 12875,
153    "markets": 892,
154    "total_market_cap_usd": 2347890123456,
155    "total_volume_usd": 89723456789,
156    "market_cap_percentage": {
157        "BTC": 52.4,
158        "ETH": 18.2
159        // ... more cryptocurrencies
160    },
161    "updated_at": "2025-03-15T10:30:00"
162}
163```
164 
165## Sample Queries
166 
167You can ask Claude Desktop questions like:
168- "What's the current price of Bitcoin?"
169- "Show me detailed market data for Ethereum"
170- "What's the price history of Dogecoin for the last 30 days?"
171- "Search for cryptocurrencies related to 'sol'"
172- "Which cryptocurrencies are trending today?"
173- "What's the total cryptocurrency market capitalization right now?"
174 
175## Error Handling
176 
177All tools include proper error handling and will return an error message if something goes wrong:
178```json
179{
180    "error": "Failed to fetch price for INVALID_SYMBOL"
181}
182```
183 
184## Troubleshooting
185 
186If the MCP server is not working in Claude Desktop:
1871. Make sure the server is running - you should see output when you start the script
1882. Verify the path in your settings is correct and absolute
1893. Make sure Python 3.10+ is in your system PATH
1904. Check that all dependencies are installed
1915. Try restarting Claude Desktop
1926. Check logs for any error messages
193 
194## Rate Limits
195 
196This tool uses the free CoinGecko API which has rate limits. Please be aware that very frequent requests may be throttled by the API.
197 
198## License
199 
200MIT License