How to add CCXT MCP Server to Windsurf

Community server bridging LLMs to 100+ crypto exchanges via the CCXT library for data and trading. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 140★ · stdio · apikey

Windsurf config for CCXT MCP Server

npx -y @mcpfun/mcp-server-ccxt

{
  "mcpServers": {
    "ccxt-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpfun/mcp-server-ccxt"
      ],
      "env": {
        "BINANCE_SECRET": "<your-binance-secret>",
        "BINANCE_API_KEY": "<your-binance-api-key>",
        "DEFAULT_EXCHANGE": "binance"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the CCXT MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5CCXT MCP Server's tools become available to Cascade.

Before you start

Node.js (install via npm/npx)
Exchange API keys only if you want to trade or read private account data — public market data needs none
Per-exchange credentials set as environment variables, e.g. `BINANCE_API_KEY` / `BINANCE_SECRET`, or `KUCOIN_API_KEY` / `KUCOIN_SECRET` / `KUCOIN_PASSPHRASE` for exchanges that require a passphrase
An MCP-compatible client (Claude Desktop, Cursor, etc.)

What CCXT MCP Server can do in Windsurf

list-exchanges

List supported/available exchanges

get-ticker

Get the latest ticker for a symbol

batch-get-tickers

Fetch tickers for multiple symbols at once

get-orderbook

Retrieve the order book for a market

get-ohlcv

Fetch OHLCV candlestick data

get-funding-rates

Get perpetual funding rates

account-balance

Read account balances (requires API keys)

place-market-order

Place a spot market order

Security

Exchange API keys with trading/withdrawal permissions can move real funds; create keys without withdrawal rights and IP-restrict them. Use read-only keys if you only need market data.

CCXT MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the CCXT MCP Server config there under the "mcpServers" key and restart the client.

Is CCXT MCP Server safe to use with Windsurf?

Exchange API keys with trading/withdrawal permissions can move real funds; create keys without withdrawal rights and IP-restrict them. Use read-only keys if you only need market data.

How many exchanges does it support?

The README states it connects to 20+ cryptocurrency exchanges via CCXT, including Binance, Coinbase, Kraken, and KuCoin. CCXT itself supports many more, but this server documents 20+.

Do I need API keys to use it?

Not for public market data (tickers, order books, OHLCV). API keys are only required for private/trading tools like balances and placing orders.

Is it official?

No. It's a community project (published as @mcpfun/mcp-server-ccxt) built on top of the open-source CCXT library, not maintained by any single exchange.

View repo Full CCXT MCP Server page