Gate DEX MCP

Gate MCP Server

 

English | 中文

---

A Gate MCP (Model Context Protocol) server that enables AI agents to interact with the Gate cryptocurrency exchange for market data, trading, and account management.

Features

• 🔍 Public Market Data - Spot, futures, margin, options, delivery, earn, alpha tickers, order books, K-line, funding rate, liquidation history (no auth required)
• 💹 Trading - Create/cancel/amend spot, futures, options, delivery orders; price-triggered orders; trail orders
• 💼 Account & Wallet - Balances, transfers, deposits, withdrawals, sub-accounts, unified account
• 📊 Margin & Earn - Margin loans, earn products, multi-currency flash swap
• 🎯 Activity & Welfare - Activity center, coupons, launch pool, square, welfare
• 🌍 TradFi, CrossEx, P2P - Traditional finance, cross-exchange, P2P trading
• 🌐 DEX - On-chain wallet, swap (single-chain & cross-chain), token info, market data across 20+ chains
• 📰 Info - Coin info, market snapshots, technical analysis, on-chain data, compliance checks
• 📢 News - Real-time crypto news, exchange announcements, social sentiment
• 🔐 OAuth2 - Secure authorization for trading and private tools

MCP Endpoints

The service exposes five MCP endpoints:

| Endpoint | Auth | Tools | |----------|------|-------| | https://api.gatemcp.ai/mcp | None | Public market data (58 tools: spot, futures, margin, options, delivery, earn, alpha, activity, launch pool, square, flash swap) | | https://api.gatemcp.ai/mcp/exchange | OAuth2 | CEX trading & account (400+ tools: spot/futures/options/delivery/margin trading, wallet, unified account, sub-accounts, earn, flash swap, rebate, TradFi, CrossEx, P2P, Alpha, activity center, coupon, launch pool, square, welfare) | | https://api.gatemcp.ai/mcp/dex | Google / Gate OAuth | DEX wallet & swap (33 tools: auth, wallet, chain config, transfer, swap, market data, token info, agentic, RPC across 20+ chains) | | https://api.gatemcp.ai/mcp/info | None | Coin info & analysis (10 tools: market snapshots, technical analysis, on-chain data, compliance) | | https://api.gatemcp.ai/mcp/news | None | News & sentiment (3 tools: news search, exchange announcements, social sentiment) |

• Market data only → Use /mcp (no Gate account needed)
• CEX trading, balances, transfers → Use /mcp/exchange (Gate OAuth2 required)
• DEX wallet, swap, on-chain → Use /mcp/dex (Google / Gate OAuth required)
• Coin info, technical analysis → Use /mcp/info (no auth)
• News, announcements → Use /mcp/news (no auth)

Transport: Streamable HTTP (with SSE fallback).

Authorization (OAuth2)

/mcp/exchange requires Gate OAuth2; /mcp/dex requires Google or Gate OAuth. The endpoints /mcp, /mcp/info, and /mcp/news do not require any authentication.

Using mcporter

Prerequisites: Node.js >= 18, npm. See Quick Start - mcporter for full installation steps.

# Add Private MCP (trading, requires OAuth)
mcporter config add gate-mcp --url https://api.gatemcp.ai/mcp/exchange --auth oauth

# Authorize (opens browser to log in)
mcporter auth gate-mcp

Scopes (for /mcp/exchange)

| Scope | Use | |-------|-----| | market | Public market data (tickers, order books, K-line, etc.) | | profile | Account info, orders, positions (read-only) | | trade | Create/cancel/amend orders | | wallet | Transfers, deposits, withdrawals | | account | Unified account, sub-accounts |

Quick Start

Prerequisites

• Gate account (required only for /mcp/exchange)
• MCP-compatible client (Cursor, Claude CLI, Trae, OpenClaw, etc.)
• Node.js >= 18 (for mcporter, Trae, Qoder, and other npm-based clients)
• Python >= 3.9 (optional, for Claude Desktop proxy)

Cursor

Method 1: One-click Install (Recommended)

Just paste the following into the Cursor AI chat — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

For full trading (OAuth on connect):

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "Gate": {
      "url": "https://api.gatemcp.ai/mcp/exchange",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

For market data only (no auth):

{
  "mcpServers": {
    "Gate": {
      "url": "https://api.gatemcp.ai/mcp",
      "transport": "streamable-http",
      "headers": {
        "Content-Type": "application/json",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

For DEX (on-chain wallet, swap):

{
  "mcpServers": {
    "Gate-Dex": {
      "url": "https://api.gatemcp.ai/mcp/dex",
      "headers": {
        "x-api-key": "MCP_AK_8W2N7Q",
        "Authorization": "Bearer ${GATE_MCP_TOKEN}"
      }
    }
  }
}

For Info & News (no auth):

{
  "mcpServers": {
    "Gate-Info": {
      "url": "https://api.gatemcp.ai/mcp/info"
    },
    "Gate-News": {
      "url": "https://api.gatemcp.ai/mcp/news"
    }
  }
}

See Cursor setup.

mcporter / OpenClaw

Method 1: One-click Install (Recommended)

Just paste the following into the OpenClaw AI chat — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

Prerequisites (before installing mcporter)

• Node.js >= 18 (mcporter requires npm)
• npm (comes with Node.js) — verify with: node -v and npm -v
• Gate account (for OAuth login when using /mcp/exchange)

Install mcporter

# Global install
npm install -g mcporter

# Verify installation
mcporter --version

Alternatively, run without installing: npx mcporter <command> (uses current Node.js/npm).

Add MCP and authorize

# Add Private MCP (trading, OAuth)
mcporter config add gate-mcp --url https://api.gatemcp.ai/mcp/exchange --auth oauth

# Authorize (opens browser to log in)
mcporter auth gate-mcp

# Add DEX MCP
mcporter config add gate-dex --url https://api.gatemcp.ai/mcp/dex

# Add Info MCP (no auth)
mcporter config add gate-info --url https://api.gatemcp.ai/mcp/info

# Add News MCP (no auth)
mcporter config add gate-news --url https://api.gatemcp.ai/mcp/news

See OpenClaw setup for detailed steps.

Claude CLI

Method 1: One-click Install (Recommended)

Just paste the following into Claude CLI — the agent will auto-install all Gate MCP servers and Skills:

Help me auto install Gate Skills and MCPs: https://github.com/gate/gate-skills

See gate-skills for details.

Method 2: Manual Configuration

brew install claude-code
# Full trading (OAuth)
claude mcp add --transport http Gate https://api.gatemcp.ai/mcp/exchange
# Restart Claude CLI after authorization is complete

# Info (no auth)
claude mcp add --transport http Gate-Info https://api.gatemcp.ai/mcp/info

# News (no auth)
claude mcp add --transport http Gate-News https://api.gatemcp.ai/mcp/news

claude mcp list

Trae

Edit Trae settings. Uses mcp-remote to proxy HTTP MCP (OAuth prompt on first connect for /mcp/exchange):

{
  "mcpServers": {
    "gate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/exchange"
      ]
    },
    "gate-info": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/info"
      ]
    },
    "gate-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/news"
      ]
    }
  }
}

Qoder

Edit Qoder MCP settings (e.g. ~/.qoder/mcp.json or in Qoder settings):

{
  "mcpServers": {
    "gate": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/exchange"
      ]
    },
    "gate-info": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/info"
      ]
    },
    "gate-news": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.gatemcp.ai/mcp/news"
      ]
    }
  }
}

Claude Desktop

Claude Desktop requires a local stdio proxy.

1. Download the Python proxy file
2. Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "Gate": {
      "command": "python3",
      "args": ["/path/to/gate-mcp-proxy.py"]
    }
  }
}

See Claude Desktop setup for detailed instructions.

Alternative: gate-local-mcp (local stdio with API keys)

For local development without OAuth, use gate-local-mcp (npm: gate-mcp) — a stdio MCP server that uses GATE_API_KEY / GATE_API_SECRET (optional for public market data only). Configure it as a command-based MCP server (e.g. "command": "npx", "args": ["-y", "gate-mcp"]). By default it registers 384 tools across 22 modules (spot, futures, delivery, margin, wallet, account, options, earn, flash_swap, unified, sub_account, multi_collateral_loan, p2p, tradfi, crossex, alpha, rebate, activity, coupon, launch, square, welfare). Reduce the set with GATE_MODULES or --modules=spot,futures, or enable read-only mode with GATE_READONLY=true / --readonly.

Important: Wire-level tool names use abbreviations (futures→fx, delivery→dc, sub_account→sa, etc.); they differ from the remote api.gatemcp.ai naming. Always use the names returned by tools/list.

Full tool list: gate-local-mcp-tools.md.

LobeHub (desktop)

On the LobeHub MCP marketplace this server appears as identifier gate-gate-mcp. The npm package name is gate-mcp — run npx -y gate-mcp, not gate-gate-mcp.

Per LobeHub custom MCP, stdio servers work on the desktop app only; inject environment variables for Gate API authentication. Use Import JSON when adding a custom skill.

Public endpoints only:

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": ["-y", "gate-mcp"],
      "type": "stdio"
    }
  }
}

With API key authentication:

{
  "mcpServers": {
    "gate-mcp": {
      "command": "npx",
      "args": ["-y", "gate-mcp"],
      "type": "stdio",
      "env": {
        "GATE_API_KEY": "your-api-key",
        "GATE_API_SECRET": "your-api-secret"
      }
    }
  }
}

You can add GATE_MODULES, GATE_READONLY, or GATE_BASE_URL inside env as needed. Click Test connection before saving.

Other Clients

| Client | Guide | |--------|-------| | Claude.ai | setup | | Codex App | setup | | Codex CLI | setup | | OpenClaw | setup | | Trae | See Trae config above | | Qoder | See Qoder config above |

Basic Usage

Query Price > What's the current price of BTC/USDT?

Get Order Book > Show me the order book for ETH/USDT

K-line Data > Get the daily K-line data for BTC over the last 7 days

---

Available Tools

All tools use the cex_ prefix. Tools are split between Public MCP (no auth) and Private MCP (OAuth2).

Public MCP (/mcp — no auth, 58 tools)

| Business | Tools | Description | |----------|-------|-------------| | Spot | 8 | cex_spot_list_currencies, cex_spot_get_currency, cex_spot_list_currency_pairs, cex_spot_get_currency_pair, cex_spot_get_spot_tickers, cex_spot_get_spot_order_book, cex_spot_get_spot_trades, cex_spot_get_spot_candlesticks | | Futures | 14 | Contracts, order book, trades, candlesticks, tickers, funding rate, premium index, liquidation, contract stats, insurance ledger, index constituents, batch funding rates, risk limit tiers | | Margin | 3 | cex_margin_list_uni_currency_pairs, cex_margin_get_uni_currency_pair, cex_margin_get_market_margin_tier | | Options | 12 | Underlyings, expirations, contracts, settlements, order book, tickers, candlesticks, trades | | Delivery | 8 | Contracts, order book, trades, candlesticks, tickers, insurance ledger, risk limit tiers | | Earn | 5 | cex_earn_list_dual_investment_plans, cex_earn_list_structured_products, cex_earn_list_uni_currencies, cex_earn_list_earn_fixed_term_products, cex_earn_list_earn_fixed_term_products_by_asset | | Alpha | 3 | cex_alpha_list_alpha_currencies, cex_alpha_list_alpha_tickers, cex_alpha_list_alpha_tokens | | Activity | 1 | cex_activity_list_activity_types | | Launch | 1 | cex_launch_list_launch_pool_projects | | Square | 2 | cex_square_list_square_ai_search, cex_square_list_live_replay | | Flash Swap | 1 | cex_fc_list_fc_currency_pairs |

Private MCP (/mcp/exchange — OAuth2, 400+ tools)

Note: The private endpoint does not include public market data tools. Use /mcp for market data queries.

| Business | Scope | Key Tools | |----------|-------|-----------| | Spot | profile / trade | Accounts, orders, trades, batch orders, price-triggered orders, countdown cancel, cross liquidate | | Futures | profile / trade | Accounts, positions, orders, trades, dual positions, trail orders, price-triggered, BBO orders | | Margin | profile / trade | Margin accounts, loans, auto-repay, uni loans | | Options | profile / trade | Account, positions, orders, MMP settings | | Delivery | profile / trade | Accounts, positions, orders, price-triggered orders | | Wallet | wallet | Total balance, transfers, deposits, withdrawals, deposit address, SA balances, small balance convert | | Unified | account | Unified accounts, mode, loans, risk units, borrowable, collateral, leverage config | | Sub-account | account | Create/list/lock/unlock SA, API keys | | Account | account | Account detail, main keys, rate limit, debit fee, STP groups | | Rebate | profile | Agency/partner/broker commission history, user info | | Flash Swap | profile / trade | cex_fc_list_fc_currency_pairs, cex_fc_list_fc_orders, cex_fc_create_fc_order_v1, multi-currency flash swap | | Earn | profile / trade | Dual/structured/uni products, orders, ETH2 swap, lend records | | Alpha | profile / trade | Alpha accounts, orders, quote/place | | TradFi | profile / trade | Categories, symbols, MT5 account, assets, orders, positions | | CrossEx | profile / trade | Rule symbols, account, positions, orders, transfers, convert | | P2P | profile / trade | User info, ads, chats, transactions, confirm payment/receipt | | Activity | profile | Activity types, recommended activities, user participation | | Coupon | profile | User coupons, coupon details | | Launch Pool | profile / trade | LaunchPool projects, pledge/redeem, reward records | | Square | market | AI search, live replay | | Welfare | profile | Beginner eligibility, task list and rewards |

For full tool parameters, see Gate API Docs or gate-exchange-mcp.

DEX — Authentication

| Tool | Description | |------|-------------| | dex_auth_google_login_start | Start Google OAuth login flow, returns verification URL | | dex_auth_google_login_poll | Poll login status, returns mcp_token on success | | dex_auth_login_google_wallet | Login with Google OAuth authorization code | | dex_auth_gate_login_start | Start Gate OAuth login flow, returns verification URL | | dex_auth_gate_login_poll | Poll Gate OAuth login status, returns mcp_token on success | | dex_auth_login_gate_wallet | Login directly with Gate OAuth authorization code | | dex_auth_logout | Revoke current session |

DEX — Wallet

| Tool | Description | |------|-------------| | dex_wallet_get_addresses | Get wallet addresses for each chain (EVM, Solana) | | dex_wallet_get_token_list | Token balances with prices and pagination | | dex_wallet_get_total_asset | Total portfolio value and 24h change | | dex_wallet_sign_message | Sign a message with wallet private key (EVM / Solana) | | dex_wallet_sign_transaction | Sign a raw transaction with wallet private key |

DEX — Chain & Transactions

| Tool | Description | |------|-------------| | dex_chain_config | Chain configuration (chain ID, capabilities) | | dex_tx_gas | Estimate gas price and gas limit | | dex_tx_transfer_preview | Preview transfer details before signing | | dex_tx_approve_preview | Token approval preview: build ERC20/SPL approve transaction | | dex_tx_get_sol_unsigned | Build unsigned Solana SOL transfer with latest blockhash | | dex_tx_send_raw_transaction | Broadcast signed transaction on-chain | | dex_tx_quote | Swap quote with route, price impact and gas estimation | | dex_tx_swap | One-click swap: quote → build → sign → submit | | dex_tx_swap_detail | Query swap order status by order ID | | dex_tx_list / dex_tx_detail / dex_tx_history_list | Transaction & swap / bridge history |

DEX — Market Data & Token Info

| Tool | Description | |------|-------------| | dex_market_get_kline | K-line (candlestick) data: 1m, 5m, 1h, 4h, 1d | | dex_market_get_tx_stats | Trading volume and trader statistics (5m / 1h / 4h / 24h) | | dex_market_get_pair_liquidity | Liquidity pool add / remove events | | dex_token_list_swap_tokens | Available tokens for swap on a given chain | | dex_token_list_cross_chain_bridge_tokens | Bridgeable tokens for cross-chain transfers | | dex_token_get_coin_info | Token info: price, market cap, supply, holder distribution | | dex_token_ranking | 24h top gainers / top losers | | dex_token_get_coins_range_by_created_at | Discover new tokens by creation time range | | dex_token_get_risk_info | Security audit: honeypot, buy/sell tax, blacklist, permissions |

DEX — Agentic & RPC

| Tool | Description | |------|-------------| | dex_agentic_report | Report agentic wallet addresses to wallet service | | dex_rpc_call | Execute JSON-RPC call to blockchain node |

For full DEX tool parameters, see gate-dex-mcp. For the Agentic Wallet subset (auth, wallet, market data, resources), see gate-agentic-wallet-mcp.

Info — Coin & Market

| Tool | Description | |------|-------------| | info_coin_get_coin_info | Get coin info by name, symbol, or contract address | | info_marketsnapshot_get_market_snapshot | Market overview: price, K-line summary, market cap, FDV, fear & greed |

Info — Market Trend & Technical Analysis

| Tool | Description | |------|-------------| | info_markettrend_get_kline | OHLCV K-line data with optional indicators | | info_markettrend_get_indicator_history | Historical indicator series (RSI, MACD, MA, EMA) | | info_markettrend_get_technical_analysis | Multi-timeframe technical signals |

Info — On-chain Data

| Tool | Description | |------|-------------| | info_onchain_get_address_info | On-chain address: labels, risk level, token balances | | info_onchain_get_address_transactions | Address transaction history | | info_onchain_get_transaction | Full transaction details by tx hash | | info_onchain_get_token_onchain | Token on-chain data: holders, activity, smart money |

Info — Compliance

| Tool | Description | |------|-------------| | info_compliance_check_token_security | Token security check: risk tier, taxes, open source, holders |

For full Info tool parameters, see gate-info-mcp.

News — Search & Announcements

| Tool | Description | |------|-------------| | news_feed_search_news | Search news by keyword, coin, time range, platform type | | news_feed_get_exchange_announcements | Exchange announcements: listings, delistings, maintenance | | news_feed_get_social_sentiment | Post detail: author, content, interactions, sentiment |

For full News tool parameters, see gate-news-mcp.

MCP Resources

The /mcp and /mcp/exchange endpoints also expose MCP Resources for static reference data:

| Resource URI | Description | |---|---| | gate://spot/currency_pairs | All spot trading pairs | | gate://spot/currencies | All supported currencies | | gate://futures/contracts/usdt | USDT-settled futures contracts | | gate://futures/contracts/btc | BTC-settled futures contracts | | gate://futures/contracts/{settle} | Futures contracts by settlement currency |

---

FAQ

Q: Do I need a Gate account?

A: Only for CEX trading and DEX wallet. /mcp, /mcp/info, and /mcp/news are fully public — no account needed. /mcp/exchange (CEX trading, balances, transfers) requires Gate OAuth2. /mcp/dex (on-chain wallet, swap) requires Google or Gate OAuth.

Q: Does it support trading?

A: Yes. Connect to https://api.gatemcp.ai/mcp/exchange with OAuth2. The server supports spot and futures trading, account management, wallet transfers, and sub-accounts. Each tool requires the appropriate scope (e.g. trade, wallet).

Q: How often is the data updated?

A: Data is queried in real-time from Gate's API.

---

Privacy & Security

• OAuth2 authorization via Gate account (no API keys stored in config)
• All API calls use HTTPS
• See Gate Privacy Policy

---

Support & Feedback

• API Documentation: Gate API Docs
• Issue Reporting: Please contact Gate support
• Business Inquiries: Contact Gate official channels

---

Contributing

See CONTRIBUTING.md.

License

MIT © gate.com