What is Ccxt Mcp

ccxt-mcp is a Model Context Protocol (MCP) server that enables trading functionalities for cryptocurrencies using the CCXT library.

Use cases

Use cases include automated trading strategies, portfolio management, market analysis, and developing trading applications that interact with multiple cryptocurrency exchanges.

How to use

To use ccxt-mcp, clone the GitHub repository, navigate to the folder, install the MCP server, and configure your environment variables in the Claude desktop settings.

Key features

Key features include fetching ticker data, accessing order book data, viewing recent trades, creating and canceling orders, fetching account balance, trading analysis prompts, order management guidance, testnet support, and performance optimization through cached exchange instances.

Where to use

ccxt-mcp can be used in cryptocurrency trading platforms, trading bots, and financial applications that require real-time trading data and order management.

CCXT MCP Server

A Model Context Protocol (MCP) server that provides trading functionality through the CCXT library.

Features

• Fetch ticker data for any symbol
• Get order book data
• View recent trades
• Create orders (market, limit, etc.)
• Cancel orders
• Fetch account balance
• Trading analysis prompts
• Order management guidance
• Testnet support
• Supports any exchange that CCXT supports
• Cached exchange instances for better performance

Project Structure

src/ccxt_mcp/
├── __init__.py              # Main server file
├── utils/
│   └── exchange.py          # Exchange management with testnet support
├── tools/
│   ├── fetch_ticker.py      # Ticker data tool
│   ├── fetch_order_book.py  # Order book tool
│   ├── fetch_trades.py      # Trades tool
│   ├── create_order.py      # Order creation tool
│   ├── cancel_order.py      # Order cancellation tool
│   └── fetch_balance.py     # Balance fetching tool
└── prompts/
    ├── trading_analysis.py  # Trading analysis prompt
    ├── order_management.py  # Order management prompt
    └── testnet_guidance.py  # Testnet guidance prompt

Setup to run MCP server

Prerequisites:

These are instructions for Claude Desktop but this mcp server could be used for any MCP Client.

1. Download github repo:

git clone https://github.com/pcriadoperez/ccxt-mcp.git

2. Enter folder
   cd ccxt-mcp

3. Install mcp server
   mcp install run.py

4. Open Claude desktop -> Settings -> Developer -> Edit config

• Add your env variables
• You may have Replace in command you uv location (You can find it running which uv)
• It should look like the below config

{
  "mcpServers": {
    "CCXT Trading Server": {
      "command": "/Users/pablo/.local/bin/uv",
      "args": [
        "run",
        "--with",
        "ccxt",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/Users/pablo/github/ccxt-mcp-2/run.py"
      ],
      "env": {
        "BINANCE_APIKEY": "BINANCE_APIKEY",
        "BINANCE_SECRET": "BINANCE_SECRET"
      }
    }
  }
}

5. Close and open claude

Setup for contributing

1. Clone the repository:

git clone https://github.com/pcriadoperez/ccxt-mcp.git
cd ccxt-mcp

2. Install dependencies:

uv pip install -e .

3. Set up environment variables:

# Copy the example environment file
cp .env.example .env

# Edit .env with your API keys
# Add your exchange API keys in the format:
# {EXCHANGE_ID}_API_KEY=your_api_key
# {EXCHANGE_ID}_SECRET=your_secret

Dev usage

1. Run the Dev MCP server:

mcp dev run.py

Security

• Never commit your .env file
• Use environment variables for API keys
• Consider using a secrets management service for production
• Testnet is recommended for development and testing

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

MIT