okx/agent-trade-kit

View on GitHub ↗

OKX trading MCP server — connect AI agents to spot, swap, futures, options & grid bots via the Model Context Protocol.

403 ★63 forksTypeScriptUpdated 2mo ago

What you need to know

OKX's official AI trading toolkit: an MCP server (okx-trade-mcp) and CLI (okx-trade-cli) that connect AI assistants directly to OKX - market data, spot/swap/futures/options/event trading, earn, trading bots, news and smart-money signals, running as a local process with keys kept on your machine.

Install

npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli
okx config init
okx-trade-mcp setup --client claude-desktop

Usage

  • •Requires Node.js >= 18; configure credentials with the interactive 'okx config init' wizard
  • •Register the MCP server with okx-trade-mcp setup --client claude-desktop|cursor|claude-code|vscode
  • •Filter modules and risk: okx-trade-mcp --modules market (no auth) or --read-only (query tools only)
  • •CLI subcommands use spaces (okx swap algo place), not the underscored MCP tool names (swap_place_algo_order)

Key features

  • ✓167 tools across 11 modules (17 sub-modules): market, spot, swap, futures, option, account, event, earn, bot, news, smartmoney
  • ✓Built-in algo orders: conditional, OCO take-profit/stop-loss, trailing stop
  • ✓Safety controls: --read-only flag, per-module filtering, built-in rate limiter
  • ✓Pre-built Agent Skills for AI frameworks in the skills/ directory (market, trade, portfolio, bot, earn, smartmoney, outcomes)
  • ✓Zero infrastructure - local stdio process, no server or database; MIT licensed

Best for

Letting AI agents (Claude, Cursor, etc.) place and manage trades on OKX with explicit read-only/module safety controls

Caveats

  • ⚠Requires OKX API credentials and involves real trading/financial risk
  • ⚠The outcomes module wraps a separate external okx-outcomes binary installed via install.sh from github.com/okx/outcomes-cli
  • ⚠Only market-data module works without authentication
Platforms: LocalClients: Claude Desktop · Cursor · Claude Code · VS Code · Windsurf

Reviewed 2026-08-18

Topics

ai-agentcrypto-tradingmcpmodel-context-protocolokxtypescript
Stars
403★
Forks
63
Language
TypeScript
License
MIT
Created
2026-03-03
Last push
2026-07-29