Connects Claude to the OKX cryptocurrency exchange API, exposing both trading operations and market data retrieval. You get account management tools for checking balances, positions, and risk metrics, plus order execution capabilities including placing orders, canceling them, and liquidating positions. The server supports both production and demo trading modes through environment flags, and can run via uvx or Docker with HTTP transport. Includes market ticker data for tracking cryptocurrency rankings. Requires OKX API credentials with key, secret, and passphrase. Useful when you need Claude to monitor crypto positions, execute trades based on analysis, or pull real-time market data from OKX without switching contexts.
{
"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
}
}
}
}
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"
}
}
}
}
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 tradingOKX_BASE_URL: Base URL of OKX. Default: https://www.okx.comMCP_AUTH_TOKEN: Custom token for authentication. Default same as OKX_API_KEYaccount_config - Get account configurationaccount_balance - Get account balanceaccount_positions - Get account positionsaccount_position_risk - Get account position riskplace_order - Place a new ordercancel_order - Cancel an incomplete orderget_trade_order - Get order detailsget_order_list - Get incomplete order listget_orders_history - Get Order Historyclose_positions - Liquidate all positionsmarket_tickers - Get cryptocurrency rankings