Integrations
Allows interaction with cryptocurrency exchanges like Binance, providing tools for fetching balances, market data, creating and canceling orders, managing positions, setting leverage, and handling withdrawals.
CCXT MCP Server
This project provides a Model Context Protocol (MCP) server that exposes various functions from the CCXT library as tools for Large Language Models (LLMs).
It allows LLMs to interact with cryptocurrency exchanges for tasks like fetching balances, market data, creating orders, and more, in a standardized and asynchronous way.
This server is built using FastMCP, which simplifies the process of creating MCP servers in Python.
Features
- CCXT Integration: Wraps common CCXT functions for exchange interaction.
- Asynchronous: Built using
asyncio
andccxt.async_support
for efficient non-blocking operations. - Clear Tool Definitions: Uses
typing.Annotated
andpydantic.Field
for clear parameter descriptions and constraints, making it easier for LLMs (and developers) to understand and use the tools. - Authentication Handling: Supports API key, secret, and passphrase authentication for private endpoints.
- Public & Private Tools: Provides separate tools for public market data and private account actions.
Installation
- Clone the repository (if you haven't already):Copy
- Create and activate a virtual environment (recommended):Copy
- Install dependencies:
The required libraries are listed in
requirements.txt
. You can install them usingpip
oruv
.- Using
pip
:Copy - Using
uv
(if installed):Copy
- Using
Running the Server
Once the dependencies are installed, you can run the MCP server directly:
You should see output indicating the server has started, similar to:
The server will then be available for MCP clients to connect to (typically on a default port managed by FastMCP, unless configured otherwise).
Available MCP Tools
This server exposes the following tools, categorized by whether they require API authentication.
Tools Requiring API Authentication (Private)
fetch_account_balance
: Fetches the current account balance.fetch_deposit_address
: Fetches the deposit address for a currency.withdraw_cryptocurrency
: Withdraws cryptocurrency to a specified address.fetch_open_positions
: Fetches open positions (primarily for futures/derivatives).set_trading_leverage
: Sets leverage for a trading symbol (primarily for futures).create_spot_limit_order
: Places a new spot limit order.create_spot_market_order
: Places a new spot market order.create_futures_limit_order
: Places a new futures limit order.create_futures_market_order
: Places a new futures market order.cancel_order
: Cancels an existing open order.fetch_order_history
: Fetches the history of orders (open/closed).fetch_my_trade_history
: Fetches the history of trades executed by the user.
Tools for Public Data (No Authentication Required)
fetch_ohlcv
: Fetches historical OHLCV (candlestick) data.fetch_funding_rate
: Fetches the funding rate for a perpetual futures contract.fetch_long_short_ratio
: Fetches the long/short ratio (requires exchange-specificparams
).fetch_option_contract_data
: Fetches market data for an options contract.fetch_market_ticker
: Fetches the latest price ticker data for a symbol.fetch_public_market_trades
: Fetches recent public trades for a symbol.
Each tool has detailed parameter descriptions available via the MCP protocol itself, thanks to the use of Annotated
and pydantic.Field
.
Usage Notes
- Futures/Options: When using tools related to futures or options (e.g.,
fetch_open_positions
,create_futures_limit_order
,fetch_funding_rate
), ensure you correctly configure the CCXT client via theparams
argument, specifically passing{'options': {'defaultType': 'future'}}
(or'swap'
,'option'
as needed) if the exchange requires it or doesn't default to the desired market type. fetch_long_short_ratio
: This is not a standard CCXT unified method. You must provide the specific exchange method name and its parameters within theparams
argument (e.g.,params={'method_name': 'fapiPublicGetGlobalLongShortAccountRatio', 'method_params': {'symbol': 'BTCUSDT', 'period': '5m'}}
for Binance futures).- Error Handling: Tools return a dictionary with an
"error"
key if an issue occurs during the CCXT call.
This server cannot be installed
A Model Context Protocol server that enables LLMs to interact with cryptocurrency exchanges through CCXT, allowing for tasks like fetching balances, market data, creating orders, and trading operations in a standardized way.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.Last updated -313232TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that enables LLMs to access Binance Smart Chain data, perform blockchain queries, and create Four.meme tokens.Last updated -TypeScript
- -securityAlicense-qualityA Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.Last updated -PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that exposes Binance cryptocurrency exchange data to LLMs, allowing agents to access real-time prices, order books, and historical market data without requiring API keys.Last updated -4PythonMIT License