coinex_mcp_server

CoinEx MCP Server A Model Context Protocol (MCP) server that enables AI agents to interact seamlessly with the CoinEx cryptocurrency exchange.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Get Ticker: Get trading pair's recent price, 24h price and volume information (spot). Parameters: - base: Optional, base currency like "BTC", "ETH". When not provided, returns top 5 entries. - quote:
  • Get Orderbook: Get order book (depth) information (supports spot/futures). Parameters: - base: Required, base currency. Example: "BTC", "ETH". - quote: Optional, quote currency, default "USDT". - limi
  • Get Kline: Get K-line data (supports spot/futures). Parameters: - base: Required, base currency. Example: "BTC", "ETH". - quote: Optional, quote currency, default "USDT". - period: Optional, K-line pe

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

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:
  • X-CoinEx-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

Как подключить

Как подключить coinex_mcp_server к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://coinex_mcp_server--helix-song.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить coinex_mcp_server к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://coinex_mcp_server--helix-song.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить coinex_mcp_server к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://coinex_mcp_server--helix-song.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (12)

Технические названия из tools/list. Нужны только разработчикам.

get_tickerGet trading pair's recent price, 24h price and volume information (spot). Parameters: - base: Optional, base currency like "BTC", "ETH". When not provided, returns top 5 entries. - quote: Optional, quote currency, default "USDT". Returns: {code, message, data}; when base is not provided, only returns top 5 items.
get_orderbookGet order book (depth) information (supports spot/futures). Parameters: - base: Required, base currency. Example: "BTC", "ETH". - quote: Optional, quote currency, default "USDT". - limit: Optional, number of price levels to return, default 20; valid values: [5, 10, 20, 50]. - market_type: Optional, market type, default "spot"; valid values: "spot" | "futures". - interval: Optional, merge granularity, default "0"; valid values include "0", "0.00000001", ..., "1", "10", "100", "1000" (according to official documentation). Returns: {code, message, data}.
get_klineGet K-line data (supports spot/futures). Parameters: - base: Required, base currency. Example: "BTC", "ETH". - quote: Optional, quote currency, default "USDT". - period: Optional, K-line period, default "1hour"; - Spot/futures common period whitelist: "1min","5min","15min","30min","1hour","4hour","1day","1week". - limit: Optional, number of records, default 100. - market_type: Optional, market type, default "spot"; options: "spot" | "futures". Error: When period is not in whitelist, returns {code:-1, message:"Unsupported time period"}. Returns: {code, message, data}.
list_marketsList market status (spot/futures). Parameters: - market_type: Optional, default "spot"; options: "spot" | "futures". - base: Optional, base currency to filter. - quote: Optional, quote currency, default "USDT". Returns: {code, message, data} (list).
get_dealsGet recent trades (deals). Parameters: - base: Required, base currency. - quote: Optional, quote currency, default "USDT". - market_type: Optional, default "spot"; options: "spot" | "futures". - limit: Optional, return quantity, default 100, max 1000 (per official documentation). Returns: {code, message, data} (list).
get_index_priceGet market index price (spot/futures). Supports batch; returns top N entries when base not provided. Parameters: - market_type: Optional, default "spot"; options: "spot" | "futures". - base: Optional, base currency; returns multi-market index when not provided. - quote: Optional, quote currency, default "USDT". - top_n: Optional, only effective when base not provided; default 5. Returns: {code, message, data}.
get_funding_rateGet current funding rate (futures only). Parameters: - base: Required, futures base currency, e.g. "BTC", "ETH". - quote: Optional, quote currency, default "USDT". Returns: {code, message, data}.
get_funding_rate_historyGet funding rate history (futures only). Parameters: - base: Required, futures base currency. - quote: Optional, quote currency, default "USDT". - start_time: Optional, start timestamp (milliseconds). - end_time: Optional, end timestamp (milliseconds). - page: Optional, default 1. - limit: Optional, default 100. Returns: {code, message, data}.
get_premium_index_historyGet premium index history (futures only). Parameters: - base: Required, futures base currency. - quote: Optional, quote currency, default "USDT". - start_time: Optional, start timestamp (milliseconds). - end_time: Optional, end timestamp (milliseconds). - page: Optional, default 1. - limit: Optional, default 100. Returns: {code, message, data}.
get_basis_historyGet basis history (futures only). Parameters: - base: Required, futures base currency. - quote: Optional, quote currency, default "USDT". - start_time: Optional, start timestamp (milliseconds). - end_time: Optional, end timestamp (milliseconds). - page: Optional, placeholder parameter (currently unused by client). - limit: Optional, placeholder parameter (currently unused by client). Returns: {code, message, data}.
get_margin_tiersGet margin tiers/ position levels (futures only). Parameters: - base: Required, futures base currency. - quote: Optional, quote currency, default "USDT". Returns: {code, message, data}.
get_liquidation_historyGet liquidation history (futures only). Parameters: - base: Required, futures base currency. - quote: Optional, quote currency, default "USDT". - start_time: Optional, start timestamp (milliseconds). - end_time: Optional, end timestamp (milliseconds). - page: Optional, page number, default 1. - limit: Optional, number of records, default 100. Returns: {code, message, data}.