MCP server

• 115 tools across market data, spot trading, collateral trading, wallet, lending, sub-accounts, mining pool, and currency conversion
• Runs as a local Docker container — API keys never leave the machine
• Credentials are passed per tool call and are not stored or logged by the server

​

Prerequisites

• Docker installed and running, or Python 3.10+ for the no-Docker option
• A WhiteBIT account with an API key (for trading tools) — see API key generation
• A supported AI client: Claude Code, Cursor, Claude Desktop, Codex, or OpenClaw

​

Quick start

​

Start the server

git clone https://github.com/whitebit-exchange/whitebit-mcp
cd whitebit-mcp

docker compose up -d

docker compose ps

docker compose down

​

Run without Docker

pip install -r requirements.txt
python server.py

​

Connect an AI client

claude mcp add --transport http --scope user whitebit http://localhost:8080/mcp

claude mcp list
# whitebit: http://localhost:8080/mcp (http)

{
  "mcpServers": {
    "whitebit": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

{
  "mcpServers": {
    "whitebit": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

[mcp_servers.whitebit]
url = "http://localhost:8080/mcp"

{
  "mcp_servers": {
    "whitebit": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

​

API keys

​

Example: provide credentials at session start

API key is YOUR_API_KEY and secret is YOUR_SECRET. Show the spot balance.

​

Example prompts

​

Market data — no API key required

• “What is the current BTC_USDT price?”
• “Show the order book for ETH_USDT”
• “List all available markets”
• “What are the deposit fees for USDT?”
• “What is the funding rate history for BTC_USDT?”
• “Is WhiteBIT in maintenance mode?”

​

Spot trading — API key required

• “Show the spot balance”
• “List open orders on BTC_USDT”
• “Place a limit buy order for 0.001 BTC at 90000 on BTC_USDT”
• “Cancel all open orders on ETH_USDT”
• “Show order history for the last 30 days”

​

Wallet — API key required

• “What is the deposit address for USDT on TRC20?”
• “Show recent deposits and withdrawals”
• “Transfer 100 USDT from the main account to spot trading”
• “Create a WhiteBIT code for 50 USDT”

​

Collateral trading — API key required

• “List open collateral positions”
• “Place a collateral limit buy for 0.01 BTC on BTC_USDT”
• “What is the current leverage?”
• “Close the BTC_USDT position”

​

Sub-accounts — API key required

• “List all sub-accounts”
• “Show the balance of sub-account ID 123”
• “Transfer 200 USDT to sub-account ID 456”

​

Configuration reference

WHITEBIT_BASE_URL=https://whitebit.com docker compose up

​

Safe account practices

• Create a dedicated sub-account with a separate API key for AI tool access.
• Fund the sub-account with only the amount allocated for AI-assisted trading.
• Generate API keys with the minimum required permissions — use read-only keys for monitoring.
• Use IP whitelisting on the API key to restrict access to the machine running the server.
• Test with a small amount before executing larger trades.

​

What’s next

• CLI — Trade and query account data directly from the terminal without an AI client
• AI tools FAQ — Answers to common questions about API key safety, supported clients, and account practices
• AI tools overview — All WhiteBIT AI tools in one place
• Authentication — How to generate and manage WhiteBIT API keys
• API Reference Overview — Full REST API endpoint listing