CoinEx MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact seamlessly with the CoinEx cryptocurrency exchange. This server provides comprehensive access to market data, trading operations, and account management through a standardized MCP interface.

Key Features

• Market Data Access: Retrieve real-time tickers, order books, K-lines, and recent trades for both spot and futures markets
• Futures Analytics: Access funding rates, premium indices, basis history, position tiers, and liquidation data
• Account Management: Query account balances and manage trading positions
• Order Operations: Place, cancel, and track orders with full history access
• Flexible Deployment: Supports multiple transport protocols (stdio, HTTP, SSE) for various integration scenarios

Quick Start

Installation via http (Recommended)

just add this url https://mcp.coinex.com/mcp to your mcp configuration in agent. for example, use this command to add it to your claude code:

claude mcp add --transport http coinex-mcp-server https://mcp.coinex.com/mcp

Installation via uvx (Support get balance / place order by API key)

Configure your MCP client (e.g., Claude Desktop) with the following JSON:

{
  "mcpServers": {
    "coinex": {
      "command": "uvx",
      "args": ["coinex-mcp-server"],
      "env": {
        "COINEX_ACCESS_ID": "your_access_id_here",
        "COINEX_SECRET_KEY": "your_secret_key_here"
      }
    }
  }
}

HTTP Mode Deployment by source code

• install pip install coinex-mcp-server

• start the server in HTTP mode:

python -m coinex_mcp_server.main --transport http --host 127.0.0.1 --port 8000 --path /mcp --enable-http-auth

Pass credentials via HTTP headers:

• X-CoinEx-Access-Id: <your_access_id>
• X-CoinEx-Secret-Key: <your_secret_key>

Usage Examples

• Get Market Tickers: list_markets(market_type="spot") or get_tickers(symbol="BTCUSDT")
• Query Order Book: get_orderbook(symbol="BTCUSDT", limit=20)
• Check Account Balance: get_account_balance()
• Place Order: place_order(symbol="BTCUSDT", side="buy", type="limit", amount="0.01", price="50000")

Security Notes

⚠️ Important:

• Never expose HTTP authentication in public services
• Deploy with HTTPS/TLS in production environments