← Back to directory
O

OKX Agent Trade Kit

Official
Connect AI assistants to OKX trading and account operations through MCP.
Category
Other #142 of 230
Stars
★ 470 Very popular
Transport
stdio (local process)
Runtime
Node.js 18+
Credentials
Optional API key
License
MIT
Last commit
51FMRS · D

The source identifies this as an OKX-maintained MIT-licensed project using a local stdio process. Its README describes 11 modules and 167 tools for trading, account, earn, bot, news, and analytics workflows, with client setup commands, read-only mode, module filtering, and rate limiting. The server manifest was not cached, so specific tool identifiers cannot be listed.

Strongest · Documentation 13/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
8/20
Maintenance
10/20
Documentation
13/20
Setup experience
12/20
Why each score
Reliability 8/20
The README describes 167 tools, module filtering, rate limiting, read-only mode, and structured error examples, but the server manifest, source files, tests, and CI workflow contents are absent. MCP initialization, tool-list consistency, and actual behavior therefore cannot be statically verified; the README also contains inconsistent repository/path naming. The plausible happy path receives limited credit, with deductions for missing execution evidence and boundary-case validation.
Security and permissions 8/20
The README claims API keys remain local and presents read-only mode, module filtering, and local stdio execution, indicating some awareness of permission and data boundaries. However, the server exposes high-risk write operations across spot, derivatives, options, earn, and trading bots, while the supplied material does not verify mandatory confirmations, least-privilege API scopes, credential-storage implementation, or external dependency data flows. No explicit red-line behavior is evidenced in the prompt, but substantial security evidence is missing.
Maintenance 10/20
The project is marked MIT, not archived, and references SECURITY.md, contribution guidance, a changelog, and npm packages, providing basic maintenance and security-response signals. There is no evidence here of commit cadence, release history, dependency updates, CI contents, or issue-response quality. Stars and open issues are discovery signals only, so the score remains moderate.
Documentation 13/20
The README offers a broad feature and module overview, installation commands, multiple client examples, configuration scenarios, read-only usage, agent skills, error examples, and a documentation index. Points are deducted because the manifest and linked document contents are unavailable, leaving parameters, limits, costs, platform compatibility, confirmation behavior, and failure boundaries unreviewable; the build example also has repository/directory naming inconsistencies.
Setup experience 12/20
The README specifies a Node.js requirement, global npm installation, interactive configuration, client-registration commands, module selection, and read-only startup examples, making the mainstream path fairly clear. The manifest, actual client configuration, platform compatibility details, and verifiable tests are absent, and the referenced one-line installer is not shown. Static evidence therefore does not support a high setup score.

Static review · not runListed 2026-08-14

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

  • OKX users who want access through an AI client
  • Developers who need a local trading MCP server
  • Users who need combined market, trading, account, and earn capabilities

Not for

  • Users who do not use OKX
  • Users seeking only static documentation or offline data
  • Users unwilling to expose trading or account API permissions to an AI client

Required permissions

  • OKX API credentials are required for authenticated features
  • Some market functionality is available without authentication
  • The --read-only flag can restrict the server to query tools
  • Modules must be selected with --modules

Risks and side effects

  • Enabled trading or earn modules allow an AI client to initiate real operations
  • The permissions assigned to the API credentials affect account and trading access
  • Trading, bot, and earn operations can involve financial loss and market risk
  • OKX Outcomes requires a separate okx-outcomes binary and includes dry-run-gated trading functionality

Setup

Before you start

Runtime:Node.js 18+

Node.js 18 or newer is required. Install the packages with npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli, then configure OKX API credentials with okx config init. Register the MCP server using okx-trade-mcp setup --client claude-desktop, okx-trade-mcp setup --client cursor, okx-trade-mcp setup --client claude-code, or okx-trade-mcp setup --client vscode.

Check that it works

Run okx-trade-mcp setup --client claude-desktop to register the server, then check the client's tool list for the market module's tools (no auth needed); asking for the BTC-USDT ticker should confirm the connection works.

Troubleshooting

  1. Verify that Node.js is version 18 or newer
  2. Run okx config init to check API credential configuration
  3. Confirm that the selected modules include the requested capability
  4. Use --read-only to investigate write-permission or trading-call issues
  5. Inspect structured MCP errors, including tool, code, message, and endpoint fields
  6. CLI subcommands use spaces, while MCP tool names use underscores; do not interchange them
  7. For Outcomes, confirm that the external okx-outcomes binary was installed through install.sh

Things to try

Once connected, you can ask your AI assistant things like:

  • Show me the latest ticker and funding rate for BTC-USDT
  • Check my account balance and current positions
  • Place a market buy order for 100 USDT of BTC-USDT
  • Compute the RSI and MACD technical indicators for BTC-USDT

Use cases

Query market data, order books, candles, funding rates, and technical indicators
Manage spot, perpetual, delivery-futures, and options orders
Inspect balances, positions, fills, and fee information
Configure grid and DCA trading bots
Query crypto news, sentiment, and smart-money signals
Use Simple Earn, on-chain staking, or Dual Currency Deposit features

Supported clients

Claude Desktop
Cursor
Claude Code
VS Code
WindsurfPartial support

Listed from the project's documentation, not tested by this site.

Overview

OKX Agent Trade Kit is a locally run OKX trading MCP server covering market data, spot, perpetual swaps, futures, options, accounts, earn products, trading bots, event contracts, news, and smart-money analytics. It connects Claude, Cursor, and other MCP-compatible clients through the Model Context Protocol while keeping API keys on the local machine.

Similar servers

BioMCP 75 · B

One binary. One grammar. Evidence from the biomedical sources you already trust.

★ 653 · Tools 11 Compare with this →

Source revision 1278636c3c16 Data synced 2026-10-11 Read the FMRS scoring method