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
- Stars
- 403★
- Forks
- 63
- Language
- TypeScript
- License
- MIT
- Created
- 2026-03-03
- Last push
- 2026-07-29