OKX MCP Server

OKX_API_KEY: API key of your OKX account. Please refer to my api page regarding API Key creation. Its 11 documented tools cover account, order, positions. It runs locally over stdio via the published package.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2025-11-10 · ★ 2 · #166 OF 283 MAINTAINED FINANCE · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install OKX MCP Server

before you install - you'll need

Set OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE, OKX_TRADE_FLAG before connecting. OKX_BASE_URL, MCP_AUTH_TOKEN are optional or environment-specific per the README.

Claude Code

claude mcp add aahl-mcp-okx -- uvx mcp-okx

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

pypi package mcp-okx - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.aahl is GitHub-verified and matches the repo owner

03 · What OKX MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get account configuration, get account balance, get account positions, and get account position risk.

Capability map

Tools grouped from the project's README - what OKX MCP Server lets an agent do.

Account

4 tools - e.g. Get account configuration; Get account balance; Get account positions

account_config · account_balance · account_positions · account_position_risk

Order

4 tools - e.g. Place a new order; Cancel an incomplete order; Get order details

place_order · cancel_order · get_trade_order · get_order_list

read & search

1 tool - e.g. Get Order History

get_orders_history

1 tool - e.g. Liquidate all positions

close_positions

Market

1 tool - e.g. Get cryptocurrency rankings

market_tickers

Latest releases

0.1.0 · 2025-11-10

04 · Who maintains OKX MCP Server

OKX MCP Server is maintained by aahl. We track 4 MCP servers from aahl - 4 actively maintained, 450 combined GitHub stars, oldest repo from Oct 2025. Full record: all servers from aahl.

05 · Facts

repository: github.com/aahl/mcp-okx
category: finance - ranked #166 of 283 actively-maintained finance servers as of 2026-08-25.
registry: io.github.aahl/mcp-okx (active, first published 2025-11-10)
packages: pypi:mcp-okx · oci:ghcr.io/aahl/mcp-okx:latest

06 · OKX MCP Server FAQ

Is OKX MCP Server still maintained?

Yes - as of 2026-08-25, its last commit was 2025-11-10. We re-verify nightly.

What can OKX MCP Server do?

With this server connected, an agent can get account configuration, get account balance, get account positions, and get account position risk.

How do I install OKX MCP Server?

Run `uvx mcp-okx`. The README documents 6 environment variables (OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE…) to set first. Set OKX_API_KEY, OKX_API_SECRET, OKX_PASSPHRASE, OKX_TRADE_FLAG before connecting. OKX_BASE_URL, MCP_AUTH_TOKEN are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does OKX MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to OKX MCP Server

Alternatives to OKX MCP Server

Maintained finance servers if OKX MCP Server isn't the fit.

Pairs well with

Servers that cover what OKX MCP Server doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Receipt Extraction · Aegis Gov Contracts · AgentBodega MCP · Agent Fund · Agirails MCP Server

More Python MCP servers · Server for Binge-watch · Dekko · Hotin · Promptheus · Waggle MCP · see all