An MCP server that provides real-time and historical cryptocurrency market data through integration with major exchanges, powered by CCXT.
A Model Context Protocol (MCP) server that provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
Features
-
Real-time Market Data
- Current cryptocurrency prices
- Market summaries with bid/ask spreads
- Top trading pairs by volume
- Multiple exchange support
-
Historical Analysis
- OHLCV (candlestick) data
- Price change statistics
- Volume history tracking
- Customizable timeframes
-
Exchange Support
- Binance
- Coinbase
- Kraken
- KuCoin
- HyperLiquid
- Huobi
- Bitfinex
- Bybit
- OKX
- MEXC
Available Tools
-
get-price
- Get current price for any trading pair
- Example: "What's the current price of BTC/USDT on Binance?"
-
get-market-summary
- Fetch detailed market information
- Example: "Show me a market summary for ETH/USDT"
-
get-top-volumes
- List top trading pairs by volume
- Example: "What are the top 5 trading pairs on Kraken?"
-
list-exchanges
- Show all supported exchanges
- Example: "Which exchanges are supported?"
-
get-historical-ohlcv
- Get historical candlestick data
- Example: "Show me the last 7 days of BTC/USDT price data in 1-hour intervals"
-
get-price-change
- Calculate price changes over different timeframes
- Example: "What's the 24-hour price change for SOL/USDT?"
-
get-volume-history
- Track trading volume over time
- Example: "Show me the trading volume history for ETH/USDT over the last week"
Example Queries
Here are some example questions you can ask Claude once the server is connected:
- What's the current Bitcoin price on Binance?
- Show me the top 5 trading pairs by volume on Coinbase
- How has ETH/USDT performed over the last 24 hours?
- Give me a detailed market summary for SOL/USDT on Kraken
- What's the trading volume history for BNB/USDT over the last week?
Technical Details
Dependencies
mcp: Model Context Protocol SDKccxt: Cryptocurrency Exchange Trading Library- Python 3.9 or higher
Architecture
The server uses:
- CCXT's async support for efficient exchange communication
- MCP's tool system for LLM integration
- Standardized data formatting for consistent outputs
- Connection pooling for optimal performance
Error Handling
The server implements robust error handling for:
- Invalid trading pairs
- Exchange connectivity issues
- Rate limiting
- Malformed requests
- Network timeouts
Troubleshooting
Common Issues
-
Exchange Connection Errors
- Check your internet connection
- Verify the exchange is operational
- Ensure the trading pair exists on the selected exchange
-
Rate Limiting
- Implement delays between requests
- Use different exchanges for high-frequency queries
- Check exchange-specific rate limits
-
Data Formatting Issues
- Verify trading pair format (e.g., BTC/USDT, not BTCUSDT)
- Check timeframe specifications
- Ensure numerical parameters are within valid ranges