CCXT MCP Server
The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets
Install
claude mcp add ccxt -- npx -y ccxt-mcpThis is third-party code. Review the repository files before installing.
What it does
The server runs locally and gives the agent unified exchange access through the ccxt library. Out of the box it serves only public data: tickers, order books, candles, trades, market and event search, plus WebSocket streams. Adding an account to the config file enables balances, orders and positions, while trading, withdrawals and raw write calls are enabled separately per account with caps and confirmation. Keys live only in the config and are never passed to the model. Alongside the server the repository has skills for using ccxt in TypeScript, Python, PHP, Go, C#, Java, Rust and the CLI.
Who it is for. For trading bot developers and crypto market analysts who want to work with exchanges through an agent.
Good fit when
- You need to compare prices and order books across exchanges
- You want to review balances and open orders across your accounts
- You want to test a strategy on an exchange testnet
Not a fit when
- You need traditional brokers rather than crypto exchanges
- You are not prepared to review every trading action the agent takes
Example request
Show the BTC/USDT spread on Binance, OKX and Bybit and order book depth within 1%Limitations
Requires Node.js 18+. Many exchanges block cloud and VPN addresses; a proxy can be set in account options. Live trading requires the explicit live value and a per-order cap. Any local agent with file access can read the config file, so create keys without withdrawal rights and with an IP allowlist.
How to disable. Run claude mcp remove ccxt or remove the ccxt block from the MCP config; delete the config.json with keys manually.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| CCXT_MCP_CONFIG | Path to the accounts config file if it is not in the default location. |
| <EXCHANGEID>_APIKEY secret | Exchange key such as BINANCE_APIKEY; fills missing account credentials. |
| <EXCHANGEID>_SECRET secret | Exchange secret such as BINANCE_SECRET. |
Security check
- Can place orders and withdraw funds when enabled in config
- Handles exchange API keys
README in short
The main README covers the ccxt library for more than a hundred exchanges in eight languages. The server README in the mcp folder starts with the security model, then covers setup for Claude Code, Claude Desktop, Cursor, VS Code and Windsurf, a sample config.json with testnet and live accounts, a capability tier table and the tool list. A Claude Code plugin bundles the server with the ccxt-mcp skill. MIT licensed.
FAQ
Does the model see my keys?
No, tools never accept keys as parameters, accounts are referenced by name and output passes a secret redaction filter.
Can trading be enabled from chat?
No, capability tiers change only in the config file; the conversation cannot change them.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio
Official Alpha Vantage MCP server: quotes, historical series, indicators and company data