OKX MCP Server

Name: OKX MCP Server
Author: aahl

@aahlMCP server · External

MCP Server for okx.com

Tradingv0.1.0MITPython

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

At most: moves money, runs code or commands, deletes data, or sends messages for you.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

PyPImcp-okxv0.1.0

Run

uvx mcp-okx

MCP client config

{
  "mcpServers": {
    "okx-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-okx"
      ]
    }
  }
}

Dockerghcr.io/aahl/mcp-okx:latest

Run

docker run -i --rm ghcr.io/aahl/mcp-okx:latest

MCP client config

{
  "mcpServers": {
    "okx-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/aahl/mcp-okx:latest"
      ]
    }
  }
}

README1 min readView on GitHub

📲 Install

Method 1: uvx

yaml

{
  "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

bash

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

yaml

{
  "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