Agent Trade Kit

v1.0.0Finance & Fintechstable

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

ai-agentcrypto-tradingmcpmodel-context-protocolokx
Share:
308
Stars
0
Downloads
0
Weekly
0/5

What is Agent Trade Kit?

Agent Trade Kit is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to okx trading mcp server — connect ai agents to spot, swap, futures, options & grid bots via the model context protocol.

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

This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • OKX trading MCP server — connect AI agents to spot, swap, fu

Use Cases

Trade on OKX with AI agents.
Execute spot and options trading.
Run grid bot strategies.
okx

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx agent-trade-kit

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Agent Trade Kit

OKX Agent Trade Kit (okx-trade-mcp) is an MCP server that connects AI assistants directly to your OKX exchange account, exposing 164 tools across 11 modules covering the full trading lifecycle — from live market data and spot/swap/futures/options order placement to algorithmic orders, trading bots, earn products, and smart money analytics. It runs as a local stdio process so your API credentials never leave your machine. Developers and traders use it to describe what they want in natural language and let Claude or Cursor execute the trades without switching between an AI client and the exchange UI.

Prerequisites

  • Node.js >= 18 installed
  • An OKX account with API credentials (API key, secret key, and passphrase) created at okx.com
  • An MCP-compatible AI client such as Claude Desktop, Cursor, or VS Code with MCP support
  • npm or npx available on your PATH
1

Install the MCP server and CLI packages

Install both the MCP server package and the companion CLI globally using npm. The CLI provides the interactive configuration wizard.

npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli
2

Configure your OKX API credentials

Run the interactive wizard to enter your OKX API key, secret key, and passphrase. Credentials are stored locally on your machine and never sent to any cloud service.

okx config init
3

Register the MCP server with your AI client

Use the setup command to automatically write the correct configuration to your AI client's config file. Choose the flag that matches your client.

okx-trade-mcp setup --client claude-desktop
# Or for Cursor:
okx-trade-mcp setup --client cursor
# Or for Claude Code:
okx-trade-mcp setup --client claude-code
4

Start the server with specific modules (optional)

By default the server loads spot, swap, and account modules. You can restrict or expand the module set at startup. Use --read-only to prevent any write operations.

okx-trade-mcp --modules market          # market data only, no auth required
okx-trade-mcp --modules spot,account    # spot trading + account
okx-trade-mcp --read-only               # query tools only, no order placement
5

Verify the connection in your AI client

Open your AI client and check that the OKX MCP tools appear in the tools list. Try asking for your account balance or BTC price to confirm the integration is working.

Agent Trade Kit Examples

Client configuration

Manual Claude Desktop configuration using the okx-trade-mcp package with spot and account modules enabled.

{
  "mcpServers": {
    "okx-trade": {
      "command": "okx-trade-mcp",
      "args": ["--modules", "spot,swap,account"],
      "env": {}
    }
  }
}

Prompts to try

After connecting, use these natural language prompts in your AI client to interact with OKX markets and your account.

- "What is the current BTC-USDT price and 24h volume?"
- "Show me my account balance across all assets"
- "Place a limit buy order for 0.01 BTC at $60,000 on the spot market"
- "Show me the RSI and MACD for ETH-USDT on the 4h chart"
- "List my open positions and unrealized PnL"
- "Start a spot grid bot on BTC-USDT with a price range of $55,000 to $70,000"

Troubleshooting Agent Trade Kit

API authentication error when placing orders

Re-run 'okx config init' and verify your API key has trading permissions enabled on the OKX API management page. Ensure the IP whitelist on the API key includes your machine's IP or is set to allow all IPs.

Market data tools work but trading tools are unavailable

The server may have been started with '--modules market' only. Restart with '--modules spot,swap,account' or '--modules all' to enable trading tools. Trading modules require valid API credentials.

MCP server not appearing in Claude Desktop

Re-run 'okx-trade-mcp setup --client claude-desktop' to overwrite the config, then fully quit and restart Claude Desktop. Check ~/Library/Application Support/Claude/claude_desktop_config.json to confirm the entry was written correctly.

Frequently Asked Questions about Agent Trade Kit

What is Agent Trade Kit?

Agent Trade Kit is a Model Context Protocol (MCP) server that okx trading mcp server — connect ai agents to spot, swap, futures, options & grid bots via the model context protocol. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Agent Trade Kit?

Follow the installation instructions on the Agent Trade Kit GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Agent Trade Kit?

Agent Trade Kit works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Agent Trade Kit free to use?

Yes, Agent Trade Kit is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Finance & Fintech MCP Servers

Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "agent-trade-kit": { "command": "npx", "args": ["-y", "agent-trade-kit"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Agent Trade Kit?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides