PlugWiki
CCXT logo

CCXT MCP Server: Setup for Claude Code, Cursor and Other Apps

OfficialLocal
Getnpmccxt-mcpccxt/ccxt

Lets Claude, Cursor and other assistants read prices and order books on 100+ crypto exchanges and prediction markets, and trade if you switch it on.

CCXT MCP lets your assistant look up prices, order books, candles and prediction market events on more than 100 exchanges. With no setup it serves public market data only. Add exchange API keys in a local config file and it can also read balances, orders and positions.

It is made by the CCXT project and runs on your computer. Trading and withdrawals are off until you turn them on for each account in the config file. Live trading needs the word "live" and an order size cap you set.

Good for

  • Traders who want live prices, order books and candles in a chat
  • Developers testing trading ideas on exchange testnets
  • Researchers comparing markets and prediction events
  • Cautious users who want trading and withdrawals off by default

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install CCXT MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the CCXT MCP server to Claude Code. Run this command:
    
    claude mcp add ccxt -- npx -y ccxt-mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists the exchanges and prediction markets you can query

    Lists every exchange CCXT supports, so the assistant can pick valid exchange names.

    Try: “Which exchanges can you query?”

    Network · list_exchanges

  • Shows what one exchange supports

    Describes one exchange: its features, limits and which functions it offers.

    Try: “What does Kraken support?”

    Network · describe_exchange

  • Looks up how a CCXT function works on an exchange

    Searches CCXT methods and shows their signatures, per-exchange parameters and links to the docs.

    Try: “How do I fetch funding rates on Bybit?”

    Read · describe_method

  • Finds trading pairs on an exchange

    Searches an exchange's markets so the assistant uses real symbols such as BTC/USDT instead of guessing.

    Try: “Find BTC perpetual contracts on Binance.”

    Network · search_markets

  • Gets current prices for one or more pairs

    Fetches the latest price, high, low and volume for the pairs you name.

    Try: “What are BTC/USDT and ETH/USDT trading at on Binance?”

    Network · get_tickers

  • Shows the buy and sell orders waiting on a pair

    Fetches the order book for a pair, with the best bids and asks.

    Try: “Show the top 10 bids and asks for BTC/USDT on OKX.”

    Network · get_orderbook

  • Gets price history as candles

    Fetches open, high, low, close and volume candles for a pair over a time range.

    Try: “Get hourly candles for ETH/USDT on Binance for the last 24 hours.”

    Network · get_ohlcv

  • Lists recent trades on a pair

    Fetches the latest public trades for a pair on an exchange.

    Try: “Show the last 50 trades for SOL/USDT on Coinbase.”

    Network · get_trades

  • Finds prediction market events

    Searches prediction markets such as Polymarket and Kalshi and returns outcome handles you can use in other tools.

    Try: “Find prediction markets about the next Fed rate decision.”

    Network · search_events

  • Quotes the best way to convert one asset to another

    Quotes the best route to convert an asset at a given size across about 50 exchanges using the CCXT order router. It is a quote only and needs no keys.

    Try: “What is the best route to swap 5 ETH to USDC?”

    Network · fetch_route

  • Runs any other read-only CCXT lookup

    Runs any fetch or load method not covered by a dedicated tool, such as funding rates, ledger or open interest. Only read methods are accepted.

    Try: “Fetch the open interest for BTC on Bybit.”

    Network · call_read_method

  • Calls a raw GET endpoint on an exchange

    Calls an exchange-specific GET endpoint directly, for data the unified tools do not cover.

    Try: “Call the exchange's raw status endpoint.”

    Network · call_implicit_get

Read from the source code

Permissions

low risk · 4 things to watch

Low risk

On the default install it reads public market data and cannot trade. Keep trading, funds and raw writes off, and use exchange keys without withdrawal rights if you ever add accounts.

What it can do

Watch out for

  • Trading and withdrawals can move real money

    Once you enable them for an account, create_order, withdraw and transfer act on it. Keep them off, use sandbox accounts first, and turn off withdrawal rights on the exchange key. github.com

  • Keys sit in a plain config file

    The README says to chmod 600 the file, and warns that a local agent with file access could read it. Use the host's secret storage and an IP allowlist on the key. github.com

  • Raw write endpoints can change anything the key allows

    call_implicit_write sends raw POST, PUT or DELETE calls, including key management. Leave it off unless you need it. github.com

  • Unavailable tools still appear in the list

    By default every tool is listed and errors if its tier is off. Set hideDisabledTools for a leaner list. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyTrading, funds and raw-write tiers are off by default and can only be enabled in the config file. Set settings.hideDisabledTools to true to hide the tools that are not enabled.
Talks toExchange APIs of the exchanges you query
Sign-in and keysNone for public data. Exchange keys live in a local config file (or environment variables) and are never passed through the model.

Questions

Is the CCXT MCP server official?

Yes. It ships in the CCXT repository and its README calls it the official CCXT MCP server.

Does it need an API key?

No, not for public market data. For balances and orders you add exchange keys to a local config file or environment variables, and the model never sees them.

Can it trade or withdraw funds?

Only if you allow it. Trading, withdrawals and raw writes are off by default and can only be switched on in the config file. Live orders also need a size cap you set and a confirmation.

Can I run it read-only?

Yes. That is the default. Do not enable trading, funds or raw writes, and optionally hide the unused tools with the hideDisabledTools setting.

Does it run locally or hosted?

Locally. It runs on your machine and talks straight to the exchanges. The README says nothing is hosted and your keys never pass through a third-party service.

Which exchanges does it support?

More than 100 exchanges and prediction markets, including Binance, OKX, Polymarket and Kalshi. Ask the assistant to list exchanges for the full set.

How do I add it to Claude Code?

Use the Claude Code command in the install box. It needs Node.js 18 or newer. Accounts are optional and set up afterwards in the config file.

Information

updated Nov 2, 2026

Publisher
Official
Package
ccxt-mcp
Registry
npm
Transport
stdio
Auth
API key
Version
0.1.3
License
MIT
Last commit
Oct 30, 2026
Open issues
257
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.