mcp-okx 0.1.0a1

OKX MCP Server

🆗 OKX MCP Server

📲 Install

Method 1: uvx

{
  "mcpServers": {
    "mcp-okx": {
      "command": "uvx",
      "args": ["mcp-okx"],
      "env": {
        "OKX_API_KEY": "your-okx-api-key",
        "OKX_API_SECRET": "api-secret-key",
        "OKX_PASSPHRASE": "api-passphrase",
        "OKX_TRADE_FLAG": "1", # 0: Production trading, 1: Demo trading
        "OKX_BASE_URL": "https://www.okx.com"
      }
    }
  }
}

Method 2: Docker

mkdir /opt/mcp-okx
cd /opt/mcp-okx
wget https://raw.githubusercontent.com/aahl/mcp-okx/refs/heads/main/docker-compose.yml
docker-compose up -d

{
  "mcpServers": {
    "mcp-okx": {
      "url": "http://0.0.0.0:8811/mcp" # Streamable HTTP
    }
  }
}

⚙️ Environment variables

• OKX_API_KEY: API key of your OKX account. Please refer to my api page regarding API Key creation.
• OKX_API_SECRET: API secret key of your OKX account.
• OKX_PASSPHRASE: API passphrase of your OKX account.
• OKX_TRADE_FLAG: 0: Production trading, 1: Demo trading
• OKX_BASE_URL: Base URL of OKX. Default: https://www.okx.com

🛠️ Available Tools

Account Tools

• account_config - Get account configuration
• account_balance - Get account balance
• account_positions - Get account positions
• account_position_risk - Get account position risk

Trading Tools

• place_order - Place a new order
• cancel_order - Cancel an incomplete order
• get_trade_order - Get order details
• get_order_list - Get incomplete order list
• get_orders_history - Get Order History
• close_positions - Liquidate all positions