Skip to main content
Glama
Sign In
OKX MCP Server

OKX MCP Server

by aahl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

🆗 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", # 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

Related MCP server: okx-trade-mcp

🛠️ Available Tools

  • account_config - Get account configuration

  • account_balance - Get account balance

  • account_positions - Get account positions

  • account_position_risk - Get account position risk

  • 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

  • market_tickers - Get cryptocurrency rankings

Available Tools

11 tools
account_balanceGet account balanceA

Retrieve a list of assets (with non-zero balance), remaining balance, and available amount in the OKX trading account

Inputs: ccy.

account_configGet account configurationA

Retrieve current OKX account configuration. It is recommended to use this tool to obtain account configuration information before using all other tools

Inputs: no named parameters.

account_position_riskGet account position riskC

Obtain the overall holding risk of the OKX account

Inputs: instType.

account_positionsGet account positionsA

Retrieve information on your OKX positions. When the account is in net mode, net positions will be displayed, and when the account is in long/short mode, long or short positions will be displayed. Return in reverse chronological order using ctime.

Inputs: instType, instId, posId.

cancel_orderCancel an incomplete orderC

Cancel an incomplete order on OKX

Inputs: instId (required), ordId, clOrdId.

close_positionsClose positionsA

Liquidate all positions in the designated trading product at market price on OKX

Inputs: instId (required), mgnMode (required), posSide, ccy, +3 more.

get_order_listGet incomplete order listC

Retrieve all incomplete orders under the current OKX account. For a detailed schema of the output object, please read the resource at: schema://trade/order

Inputs: instType, instFamily, instId, state, +1 more.

get_orders_historyGet Order HistoryB

Get completed orders on OKX which are placed in the last 7 days, including those placed 7 days ago but completed in the last 7 days.The incomplete orders that have been canceled are only reserved for 2 hours. For a detailed schema of the output object, please read the resource at: schema://trade/order

Inputs: instType (required), instFamily, instId, state, +3 more.

get_trade_orderGet order detailsC

Retrieve order details on OKX. For a detailed schema of the output object, please read the resource at: schema://trade/order

Inputs: instId (required), ordId, clOrdId.

market_tickersGet market tickersC

Retrieve the latest price snapshot, best bid/ask price, and trading volume in the last 24 hours.Get the ranking of coins with the highest increase or the largest trading volume.

Inputs: instType, instFamily, sortBy, limit.

place_orderPlace a new orderC

Place a new order on OKX for trading

Inputs: instId (required), tdMode (required), side (required), ordType (required), +13 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.2/5.0

    Scored across 11 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as account_balance for balances, place_order for trading, and market_tickers for market data. However, get_order_list, get_orders_history, and get_trade_order could cause confusion as they all retrieve order information with overlapping scopes, though descriptions clarify differences like incomplete vs. completed orders.

    Naming Consistency5/5

    Tool names consistently follow a verb_noun or noun_verb pattern with snake_case throughout, such as account_balance, cancel_order, and market_tickers. This uniformity makes the set predictable and easy to navigate for an agent.

    Tool Count5/5

    With 11 tools, the server is well-scoped for an OKX trading platform, covering account management, order handling, and market data. Each tool serves a clear purpose without being overly sparse or bloated, fitting typical expectations for such a domain.

    Completeness4/5

    The tool set provides comprehensive coverage for core trading operations, including account info, order placement, cancellation, and market data. A minor gap exists in lacking tools for modifying existing orders or positions beyond cancellation and liquidation, but agents can work around this with the available tools.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • okx-trade-mcp

      PlaceNL2026
      A
      license
      Not graded
      quality
      C
      maintenance
      Connects AI assistants to OKX cryptocurrency exchange for trading, market data, account management, and more via the Model Context Protocol.
      30
      MIT

    • okx-trade-mcp

      dex-original
      A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with OKX cryptocurrency exchange, providing tools for market data, trading, account management, and more through the Model Context Protocol.
      116
      MIT

    • hvip MCP Server

      okx-wallet-H
      A
      license
      D
      quality
      C
      maintenance
      Enables AI agents to access the full OKX exchange API for trading, market data, account management, and more through 300+ MCP tools.
      100
      99 npm
      1
      MIT