CCXT MCP Server
Version



High-performance cryptocurrency exchange integration using MCP (Model Context Protocol) and CCXT.
Features
- Exchange Support: Connects to 20+ cryptocurrency exchanges
- Market Types: Supports spot, futures, swap markets and more
- Proxy Configuration: Options for accessing exchanges through proxies
- Fast & Reliable: Optimized caching and rate limiting
- MCP Standard: Compatible with LLMs like Claude and GPT via MCP
CCXT MCP Server Integration Architecture
CCXT MCP Server Integration Architecture
The CCXT MCP Server connects language models to cryptocurrency exchanges through the Model Context Protocol. It serves as a bridge that allows LLMs to access real-time market data and execute trading operations across multiple exchanges through a unified API.
The architecture includes:
- LLM clients (Claude and other MCP-compatible models) that send requests
- The Model Context Protocol (MCP) that standardizes communication
- The CCXT MCP Server that processes requests and manages exchange interactions
- The CCXT Library that provides unified access to exchange APIs
- Connections to multiple cryptocurrency exchanges
CCXT MCP Server Code Architecture
CCXT MCP Server Code Architecture
The server is organized into three main modules for better maintainability and extensibility:
- Exchange: Manages exchange instances, credentials, and symbol validation
- Utils: Provides caching, rate limiting, and logging functionality
- Tools: Implements MCP tools and resources for exchange interaction
Quick Start
Installing via Smithery
To install mcp-server-ccxt for Claude Desktop automatically via Smithery:
NPM Package (Recommended)
You can install CCXT MCP Server from npm:
Or run directly:
Manual Installation
Alternatively, you can clone and build the repository:
Configuration
- Create an environment file
- Edit the
.envfile to add your exchange API keys
Usage
Note: If you encounter any issues with MCP communication, please see the Troubleshooting Guide for solutions.
Running the Server
Start the server:
Using with Claude for Desktop
- Add the server to your
claude_desktop_config.json:
If installed via npm (globally):
If installed manually:
- Restart Claude for Desktop
Using as a Module in Another Project
You can also use this package as a module in your own Node.js projects:
Example Queries
Here are some example queries you can use with the MCP server:
- "What's the current price of Bitcoin on Binance?"
- "Show me the order book for ETH/USDT on Coinbase"
- "Get the 1-hour OHLCV data for BTC/USDT on Binance for the last 24 candles"
- "Compare the price of SOL/USDT across different exchanges"
- "What's my current balance on Binance?" (requires API keys)
- "Place a market buy order for 0.1 ETH on Kraken" (requires API keys)
Available Tools
Public API Tools
list-exchanges: List all available cryptocurrency exchanges
get-ticker: Get current ticker information for a trading pair
batch-get-tickers: Get ticker information for multiple trading pairs at once
get-orderbook/get-order-book: Get market order book for a trading pair
get-ohlcv: Get OHLCV candlestick data for a trading pair
get-trades: Get recent trades for a trading pair
get-markets: Get all available markets for an exchange
get-exchange-info: Get exchange information and status
get-leverage-tiers: Get futures leverage tiers
get-funding-rates: Get current funding rates
get-positions: Get open positions information
get-open-orders: Get all open orders
get-order-history: Get order history
Private API Tools (requires API keys)
account-balance: Get your account balance from a crypto exchange
place-market-order: Place a market order on an exchange
place-limit-order: Place a limit order on an exchange
cancel-order: Cancel an existing order
cancel-all-orders: Cancel all open orders
set-leverage: Set leverage for futures
set-margin-mode: Set margin mode for futures
place-futures-market-order: Place futures market orders
place-futures-limit-order: Place futures limit orders
transfer-funds: Transfer funds between accounts (e.g., spot to futures)
Configuration & Utility Tools
cache-stats: Get CCXT cache statistics
clear-cache: Clear CCXT cache
set-log-level: Set logging level
get-proxy-config: Get proxy settings
set-proxy-config: Configure proxy settings
set-market-type: Set default market type
set-default-exchange: Change the default exchange
system-info: Get system and environment information
Performance Optimizations
MCP-CCXT includes several optimizations to ensure high performance:
- LRU Caching System:
- Adaptive Rate Limiting:
- Exchange Connection Management:
Security Best Practices
API Key Security
- Create Dedicated API Keys:
- Limit API Key Permissions:
- Secure Storage:
Risk Disclaimer
This software is provided for informational purposes only. Using this software to interact with cryptocurrency exchanges involves significant risks:
- Financial Risk: Cryptocurrency trading involves risk of loss
- API Security: Ensure your API keys have appropriate permission limits
- No Investment Advice: This tool does not provide investment advice
- No Warranty: The software is provided "as is" without warranty of any kind
License
This project is licensed under the MIT License - see the LICENSE.txt file for details.
Copyright and Attribution
This project uses the CCXT library (https://github.com/ccxt/ccxt), which is:
CCXT is released under the MIT License, which is included below:
For issues, feature requests, or contributions, please visit the GitHub repository.
CCXT MCP Server
Version



High-performance cryptocurrency exchange integration using MCP (Model Context Protocol) and CCXT.
Features
- Exchange Support: Connects to 20+ cryptocurrency exchanges
- Market Types: Supports spot, futures, swap markets and more
- Proxy Configuration: Options for accessing exchanges through proxies
- Fast & Reliable: Optimized caching and rate limiting
- MCP Standard: Compatible with LLMs like Claude and GPT via MCP
CCXT MCP Server Integration Architecture
CCXT MCP Server Integration Architecture
The CCXT MCP Server connects language models to cryptocurrency exchanges through the Model Context Protocol. It serves as a bridge that allows LLMs to access real-time market data and execute trading operations across multiple exchanges through a unified API.
The architecture includes:
- LLM clients (Claude and other MCP-compatible models) that send requests
- The Model Context Protocol (MCP) that standardizes communication
- The CCXT MCP Server that processes requests and manages exchange interactions
- The CCXT Library that provides unified access to exchange APIs
- Connections to multiple cryptocurrency exchanges
CCXT MCP Server Code Architecture
CCXT MCP Server Code Architecture
The server is organized into three main modules for better maintainability and extensibility:
- Exchange: Manages exchange instances, credentials, and symbol validation
- Utils: Provides caching, rate limiting, and logging functionality
- Tools: Implements MCP tools and resources for exchange interaction
Quick Start
Installing via Smithery
To install mcp-server-ccxt for Claude Desktop automatically via Smithery:
NPM Package (Recommended)
You can install CCXT MCP Server from npm:
Or run directly:
Manual Installation
Alternatively, you can clone and build the repository:
Configuration
- Create an environment file
- Edit the
.envfile to add your exchange API keys
Usage
Note: If you encounter any issues with MCP communication, please see the Troubleshooting Guide for solutions.
Running the Server
Start the server:
Using with Claude for Desktop
- Add the server to your
claude_desktop_config.json:
If installed via npm (globally):
If installed manually:
- Restart Claude for Desktop
Using as a Module in Another Project
You can also use this package as a module in your own Node.js projects:
Example Queries
Here are some example queries you can use with the MCP server:
- "What's the current price of Bitcoin on Binance?"
- "Show me the order book for ETH/USDT on Coinbase"
- "Get the 1-hour OHLCV data for BTC/USDT on Binance for the last 24 candles"
- "Compare the price of SOL/USDT across different exchanges"
- "What's my current balance on Binance?" (requires API keys)
- "Place a market buy order for 0.1 ETH on Kraken" (requires API keys)
Available Tools
Public API Tools
list-exchanges: List all available cryptocurrency exchanges
get-ticker: Get current ticker information for a trading pair
batch-get-tickers: Get ticker information for multiple trading pairs at once
get-orderbook/get-order-book: Get market order book for a trading pair
get-ohlcv: Get OHLCV candlestick data for a trading pair
get-trades: Get recent trades for a trading pair
get-markets: Get all available markets for an exchange
get-exchange-info: Get exchange information and status
get-leverage-tiers: Get futures leverage tiers
get-funding-rates: Get current funding rates
get-positions: Get open positions information
get-open-orders: Get all open orders
get-order-history: Get order history
Private API Tools (requires API keys)
account-balance: Get your account balance from a crypto exchange
place-market-order: Place a market order on an exchange
place-limit-order: Place a limit order on an exchange
cancel-order: Cancel an existing order
cancel-all-orders: Cancel all open orders
set-leverage: Set leverage for futures
set-margin-mode: Set margin mode for futures
place-futures-market-order: Place futures market orders
place-futures-limit-order: Place futures limit orders
transfer-funds: Transfer funds between accounts (e.g., spot to futures)
Configuration & Utility Tools
cache-stats: Get CCXT cache statistics
clear-cache: Clear CCXT cache
set-log-level: Set logging level
get-proxy-config: Get proxy settings
set-proxy-config: Configure proxy settings
set-market-type: Set default market type
set-default-exchange: Change the default exchange
system-info: Get system and environment information
Performance Optimizations
MCP-CCXT includes several optimizations to ensure high performance:
- LRU Caching System:
- Adaptive Rate Limiting:
- Exchange Connection Management:
Security Best Practices
API Key Security
- Create Dedicated API Keys:
- Limit API Key Permissions:
- Secure Storage:
Risk Disclaimer
This software is provided for informational purposes only. Using this software to interact with cryptocurrency exchanges involves significant risks:
- Financial Risk: Cryptocurrency trading involves risk of loss
- API Security: Ensure your API keys have appropriate permission limits
- No Investment Advice: This tool does not provide investment advice
- No Warranty: The software is provided "as is" without warranty of any kind
License
This project is licensed under the MIT License - see the LICENSE.txt file for details.
Copyright and Attribution
This project uses the CCXT library (https://github.com/ccxt/ccxt), which is:
CCXT is released under the MIT License, which is included below:
For issues, feature requests, or contributions, please visit the GitHub repository.