CCXT

The CCXT MCP Server lets AI models interact with cryptocurrency exchange APIs through the Model Context Protocol (MCP). By wrapping CCXT’s broad exchange access in MCP, you enable automated trading queries, market data retrieval, and account actions to be driven by AI in a scalable, standardized way.

How to use

You connect an MCP client (such as Claude Desktop or another MCP-enabled interface) to the CCXT MCP Server and issue requests that cover market data, trading actions, and analytics. The server translates your requests into CCXT calls to supported exchanges and returns structured responses back through MCP.

Typical workflows you can perform include checking prices across exchanges, querying order books, placing and managing orders, and retrieving historical OHLCV data. You can also run trading analyses like performance metrics and risk metrics, then adjust positions using dynamic sizing and risk controls.

For authentication and account-specific actions, you provide account credentials in a structured configuration (as described in the configuration options). You can embed these accounts directly in the client’s Claude Desktop settings or reference them from a separate configuration file passed to the server via the --config option.

How to install

Prerequisites: you need Node.js and npm installed on your system.

Install the CCXT MCP Server package globally so you can run the mcp from anywhere.

# Install the package globally
npm install -g @lazydino/ccxt-mcp

# Run with default settings
ccxt-mcp

# or run without installation
npx @lazydino/ccxt-mcp

Additional configuration and usage notes

You can register the CCXT MCP Server in your MCP client by configuring a server entry named ccxt-mcp. You have two practical options for providing account information and configuration.

Option 1: Include account information directly in your client’s configuration (basic method). This embeds CCXT account details in the client configuration file.

Option 2: Use a separate configuration file that contains accounts and is referenced by the server through the --config option.

Configuration examples

Option 1 shows account details embedded in the client configuration. The server is started via a command that uses npx to run the CCXT MCP server and includes the --config path.

{
  "mcpServers": {
    "ccxt_mcp": {
      "command": "npx",
      "args": ["-y", "@lazydino/ccxt-mcp", "--config", "/path/to/config.json"]
    }
  }
}

Security and best practices

Limit access to your MCP client and secure your configuration files since credentials appear in the accounts section. Consider using a separate configuration file for sensitive data and manage permissions at the file level.

Troubleshooting

If the server fails to start, verify that Node.js and npm are installed, and that the npx command resolves to the correct package. Ensure the --config path points to a valid JSON file that contains an accounts array when using the separate-configuration approach.

Notes on tools and capabilities

The CCXT MCP Server exposes a broad set of capabilities through MCP, including market data retrieval, trading actions, and comprehensive analytics. You can leverage these features through MCP-enabled AI prompts to perform exchanges operations programmatically.

Available tools

List exchanges

Retrieve the list of available exchanges supported by CCXT MCP Server.

Market data by exchange

Query trading pairs, price data, and market info for a specific exchange.

Price by symbol

Get real-time price information for a specific symbol across configured exchanges.

Order book

Fetch the current order book for a given symbol on a chosen exchange.

OHLCV history

Search and retrieve historical OHLCV data for given symbols and timeframes.

Place orders

Create market or limit orders on a selected exchange account.

Cancel and check orders

Cancel active orders and query their status.

Balances and history

View account balances and trading history.

Performance analytics

Compute daily/weekly/monthly performance metrics and win/loss statistics.

Risk and position controls

Set risk parameters, stop losses, take profit, and position sizing rules.