🆗 OKX MCP Server

<!-- mcp-name: io.github.aahl/mcp-okx -->

📲 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", # Optional
        "MCP_AUTH_TOKEN": "your-custom-token"  # Default same as OKX_API_KEY
      }
    }
  }
}

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
      "headers": {
        "Authorization": "Bearer your-okx-api-key-or-custom-token"
      }
    }
  }
}

⚙️ 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
• MCP_AUTH_TOKEN: Custom token for authentication. Default same as OKX_API_KEY

🛠️ Available Tools

<details> <summary><strong>Account Tools</strong></summary>

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

</details>

<details> <summary><strong>Trading Tools</strong></summary>

• 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

</details>

<details> <summary><strong>Market Data</strong></summary>

• market_tickers - Get cryptocurrency rankings

</details>