Dex Trade Agent Kit

Community

Local MCP server that connects OKX trading to AI assistants

How to install ↓ Compare GitHub source repository ↗

Category: Other #217 of 230
Stars: ★ 128 Popular
Transport: stdio (local process)
Runtime: Node.js 18+
Credentials: Optional API key
License: MIT
Last commit: 28 days ago
Tools: 100

30FMRS · D

This MCP server provides comprehensive trading functionality across multiple modules, runs locally for privacy, and is suitable for technical users. However, caution is needed when dealing with real funds.

Strongest · Documentation 9/20 Weakest · Reliability 4/20

Reliability

4/20

Security and permissions

5/20

Maintenance

5/20

Documentation

9/20

Setup experience

7/20

Why each score

Reliability 4/20: Only the README and metadata were supplied; there is no source code, CI configuration, or test files, so clean startup, MCP handshake completion, and tool behavior matching declarations cannot be verified. The server manifest is uncached, and the repository name (Dennis-bv/dex-trade-agent-kit) conflicts with the npm package names (@okx_ai/okx-trade-mcp) in the README, further lowering confidence. Score is very low.
Security and permissions 5/20: The README claims local-only API keys, no cloud services, and safety controls such as --read-only and module filtering, but none of this is verifiable from source. There is no evidence of human confirmation for dangerous operations like placing orders, least-privilege enforcement, or data-flow disclosure. Since trading tools can be executed by the AI, the lack of confirmation is concerning; conservative deduction applies.
Maintenance 5/20: The repo has an MIT license, is not archived, has 0 open issues, and 127 stars, but these metadata alone cannot demonstrate commit activity, release cadence, or issue responsiveness. The README references a CHANGELOG and CONTRIBUTING without providing them, and the codecov badge links to another repository, suggesting possible governance or provenance issues.
Documentation 9/20: The README is well-structured with installation, quick start, a module table, CLI examples, and issue-reporting guidance, but linked docs are absent, so tool parameters and limitations cannot be verified. Obvious inconsistencies exist: repository name vs npm package name, badges pointing to a different repo, and a likely typo 'openCxxW'. These reduce documentation reliability.
Setup experience 7/20: The setup steps appear simple in the README: npm global install, okx config init, then client registration. However, there is no execution evidence, and the install commands reference npm packages that may not correspond to the actual repository output. Only a few mainstream clients have commands, and platform-specific or troubleshooting details are missing. Conservative score.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessUses the networkChanges third-party account data

Best for

Traders using AI assistants like Claude or Cursor
Traders needing automation and algorithmic orders
Users who prefer local execution and no cloud dependency
Analysts needing unauthenticated market data and indicators

Not for

Users who don't want to run a local terminal or dislike CLI
Non-OKX users (only supports OKX exchange)
Users needing mobile or web interfaces rather than local process
Users with strict security requirements on API keys (though keys are stored locally)

Required permissions

Requires OKX API keys (read and write) for trading operations
No authentication needed for market data modules
May require specific API permissions enabled depending on modules used, such as trade, withdraw, earn, etc.
Runs as local stdio process, no external network services (but may make requests to OKX API)

Risks and side effects

Real money trading risk: AI may execute orders incorrectly
API keys stored locally; ensure your machine is secure
Tools can change account state in real time (e.g., leverage, position mode)
Dependency on OKX API stability, potential rate limits or service outages
Misconfiguration can result in invalid order parameters or unintended trades

Setup

Before you start

Runtime：Node.js 18+

Ensure Node.js >= 18.
Install globally: npm install -g @okx_ai/okx-trade-mcp @okx_ai/okx-trade-cli.
Configure OKX API credentials: run okx config init and follow the interactive wizard.
Register the MCP server with your AI client using okx-trade-mcp setup --client claude-desktop or other clients (cursor, claude-code, vscode). Alternatively, use the one-line install script that handles Node.js check, installation, and client detection automatically.

claude_desktop_config.json

{
  "mcpServers": {
    "okx-trade-mcp": {
      "command": "okx-trade-mcp",
      "args": [
        "--modules",
        "all"
      ]
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json

{
  "servers": {
    "okx-trade-mcp": {
      "command": "okx-trade-mcp",
      "args": [
        "--modules",
        "all"
      ]
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal

claude mcp add okx-trade-mcp -- okx-trade-mcp --modules all

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

The client's tool list should show tools like market_get_ticker and account_get_balance. Start with --modules market (no auth needed) and ask "What is the current BTC-USDT price?" — a live quote confirms the connection.

Troubleshooting

Ensure Node.js version >= 18
Run `okx config init` to reconfigure credentials
Check API key permissions are sufficient
Examine the structured error block in tool output (includes tool name, error code, endpoint, traceId) and diagnose accordingly
If using VS Code, confirm .mcp.json file is generated
See FAQ doc docs/faq.md for common issues

Things to try

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

Use market_get_ticker to get the latest BTC-USDT price
Show my account balance and current positions with account_get_balance
Set the leverage on my BTC perpetual swap to 5x via the swap tools
Use market_filter_market to screen coins with a funding rate above 0.1%

Tools 100

market_get_ticker read-only

Get market ticker

market_get_orderbook read-only

Get orderbook

market_get_candles read-only

Get candles

market_get_index_ticker read-only

Get index ticker

market_get_index_candles read-only

Get index candles

market_get_price_limit read-only

Get price limit

market_get_funding_rate read-only

Get funding rate

market_get_mark_price read-only

Get mark price

Show 92 more tools

market_get_open_interest read-only

Get open interest

market_get_stock_tokens read-only

Get stock tokens

market_get_indicators read-only

Get technical indicators

market_get_indicator_list read-only

Get indicator list

market_filter_market read-only

Filter markets by criteria

market_get_oi_history read-only

Get open interest history

market_get_oi_change_filter read-only

Filter by open interest change

spot_place_order destructive

Place spot order

spot_cancel_order destructive

Cancel spot order

spot_amend_order writes

Amend spot order

spot_batch_orders destructive

Batch spot orders

spot_get_fills read-only

Get spot fills

spot_get_order_history read-only

Get spot order history

spot_place_conditional_order writes

Place conditional order

spot_cancel_conditional_order destructive

Cancel conditional order

spot_place_oco_order writes

Place OCO order

spot_cancel_oco_order destructive

Cancel OCO order

swap_place_order destructive

Place swap order

swap_cancel_order destructive

Cancel swap order

swap_amend_order writes

Amend swap order

swap_batch_orders destructive

Batch swap orders

swap_get_positions read-only

Get swap positions

swap_set_leverage writes

Set leverage

swap_place_conditional_order writes

Place swap conditional order

swap_cancel_conditional_order destructive

Cancel swap conditional order

swap_place_oco_order writes

Place swap OCO order

swap_cancel_oco_order destructive

Cancel swap OCO order

swap_place_trailing_stop writes

Place trailing stop order

swap_cancel_trailing_stop destructive

Cancel trailing stop order

futures_place_order destructive

Place futures order

futures_cancel_order destructive

Cancel futures order

futures_amend_order writes

Amend futures order

futures_close_position destructive

Close futures position

futures_set_leverage writes

Set futures leverage

futures_batch_orders destructive

Batch futures orders

futures_place_algo_order writes

Place algo order

futures_cancel_algo_order destructive

Cancel algo order

futures_get_positions read-only

Get futures positions

futures_get_fills read-only

Get futures fills

futures_get_order_history read-only

Get futures order history

option_place_order destructive

Place option order

option_cancel_order destructive

Cancel option order

option_amend_order writes

Amend option order

option_batch_cancel destructive

Batch cancel options

option_get_order_history read-only

Get option order history

option_get_positions read-only

Get option positions

option_get_fills read-only

Get option fills

option_get_chain read-only

Get option chain

option_get_iv_greeks read-only

Get IV and Greeks

account_get_balance read-only

Get account balance

account_get_bills read-only

Get account bills

account_get_positions read-only

Get account positions

account_get_positions_history read-only

Get positions history

account_get_fee_rates read-only

Get fee rates

account_get_config read-only

Get account config

account_set_position_mode writes

Set position mode

account_get_max_withdrawal read-only

Get max withdrawal

account_get_max_avail_size read-only

Get max available size

account_get_audit_log read-only

Get audit log

event_browse_contracts read-only

Browse event contracts

event_get_series read-only

Get event series

event_get_events read-only

Get events

event_get_markets read-only

Get markets

event_place_order destructive

Place event order

event_amend_order writes

Amend event order

event_cancel_order destructive

Cancel event order

event_get_orders read-only

Get event orders

event_get_fills read-only

Get event fills

earn_get_balance read-only

Get earn balance

earn_purchase destructive

Purchase earn product

earn_redeem destructive

Redeem earn product

earn_get_lending_rate read-only

Get lending rate

earn_place_fixed_term_order destructive

Place fixed-term order

earn_get_fixed_term_orders read-only

Get fixed-term orders

earn_get_onchain_staking read-only

Get on-chain staking info

earn_stake destructive

Stake on-chain

earn_unstake destructive

Unstake on-chain

earn_get_dcd_products read-only

Get dual currency deposit products

earn_place_dcd_order destructive

Place DCD order

earn_get_flash_earn read-only

Get flash earn

bot_create_grid writes

Create grid bot

bot_amend_grid writes

Amend grid bot

bot_close_grid destructive

Close grid bot

bot_get_grid_orders read-only

Get grid orders

bot_create_dca writes

Create DCA bot

bot_amend_dca writes

Amend DCA bot

bot_close_dca destructive

Close DCA bot

bot_get_dca_orders read-only

Get DCA orders

news_get_latest read-only

Get latest news

news_filter_by_coin read-only

Filter news by coin

news_search read-only

Search news

news_get_article read-only

Get article detail

Use cases

Execute spot, futures, and options trades via natural language with AI assistants

Get real-time market data, technical indicators, and price screening

Manage account balances, positions, and fee settings

Create and manage grid or DCA trading bots

Participate in earn products, on-chain staking, and dual currency deposits

Track crypto news and smart money signals

Supported clients

Claude Desktop

Cursor

Claude Code

VS Code

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

Overview

DEX Agent Trade Kit is an AI-powered trading toolkit with two standalone packages: dex-trade-mcp (an MCP server for Claude, Cursor, and any MCP-compatible AI client) and dex-trade-cli (a CLI for operating several exchanges from the terminal). It connects AI assistants directly to your OKX account via the Model Context Protocol (MCP). It runs as a local process with API keys stored only on your machine, no cloud services. Features 145 tools across 11 modules: market data, spot, swap, futures, options, account management, event contracts, earn, trading bots, news, and smart money signals. Includes built-in algo orders (conditional, OCO take-profit/stop-loss, trailing stop), safety controls (--read-only flag, per-module filtering, built-in rate limiter), zero infrastructure (local stdio process), and pre-built agent skills.

Similar servers

Hevy MCP 77 · B

Manage your Hevy workout data from AI assistants via MCP.

★ 509 · Tools 26 Compare with this →

Firecrawl MCP Server 75 · B

Firecrawl's official MCP server for web search, scraping, and structured extraction for AI agents

★ 7.6k · Tools 11 Compare with this →

BioMCP 75 · B

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

★ 654 · Tools 11 Compare with this →

Compartment 75 · B

Encrypted, fully offline long-term memory for AI agents

★ 579 · Tools 14 Compare with this →

Compare with other MCP servers

Source revision 65a7c282ef0c Data synced 2026-10-12 Read the FMRS scoring method