Mcp Server Ccxt

Cryptocurrency Market Data MCP Server

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.

[](https://modelcontextprotocol.io) [](https://www.python.org) [](https://github.com/ccxt/ccxt) [](https://smithery.ai/server/mcp-server-ccxt)

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

Installation

Installing via Smithery

To install Cryptocurrency Market Data Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-server-ccxt --client claude

Installing Manually

# Using uv (recommended)
uv pip install mcp ccxt

# Using pip
pip install mcp ccxt

Usage

Running the Server

python crypto_server.py

Connecting with Claude Desktop

1. Open your Claude Desktop configuration at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

1. Add the server configuration:

{
    "mcpServers": {
        "crypto": {
            "command": "python",
            "args": ["/path/to/crypto_server.py"]
        }
    }
}

1. Restart Claude Desktop

Available Tools

1. get-price

• Get current price for any trading pair
• Example: "What's the current price of BTC/USDT on Binance?"

1. get-market-summary

• Fetch detailed market information
• Example: "Show me a market summary for ETH/USDT"

1. get-top-volumes

• List top trading pairs by volume
• Example: "What are the top 5 trading pairs on Kraken?"

1. list-exchanges

• Show all supported exchanges
• Example: "Which exchanges are supported?"

1. get-historical-ohlcv

• Get historical candlestick data
• Example: "Show me the last 7 days of BTC/USDT price data in 1-hour intervals"

1. get-price-change

• Calculate price changes over different timeframes
• Example: "What's the 24-hour price change for SOL/USDT?"

1. 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 SDK
• ccxt: 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

Development

Running Tests

# To be implemented
pytest tests/

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Local Development

# Clone the repository
git clone [repository-url]
cd crypto-mcp-server

# Install dependencies
uv pip install -e .

Troubleshooting

Common Issues

1. Exchange Connection Errors

• Check your internet connection
• Verify the exchange is operational
• Ensure the trading pair exists on the selected exchange

1. Rate Limiting

• Implement delays between requests
• Use different exchanges for high-frequency queries
• Check exchange-specific rate limits

1. Data Formatting Issues

• Verify trading pair format (e.g., BTC/USDT, not BTCUSDT)
• Check timeframe specifications
• Ensure numerical parameters are within valid ranges

License

MIT License - See LICENSE file for details

Acknowledgments

• CCXT for exchange integrations
• Model Context Protocol for the MCP specification
• The cryptocurrency exchanges for providing market data APIs

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Nayshins
• Source: Nayshins/mcp-server-ccxt
• License: MIT

Install and usage instructions live in the source repository linked above.