← Back to directory
O

OKX Agent Trade Kit

Official
Connect AI assistants to OKX trading and account operations through MCP.
GitHub source repository ↗
★ 411 Stars Category · Other Very popular Source revision e46b378f2f26
51FMRS · D
Reliability
8/20
Security and permissions
8/20
Maintenance
10/20
Documentation
13/20
Setup experience
12/20

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.

Read the FMRS scoring method →

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.

Tools

The tool list has not been reviewed yet.

Setup

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.

Fit and risk

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

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

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 DesktopFull support
CursorFull support
Claude CodeFull support
Visual Studio CodeFull support
WindsurfPartial support