io.github.gateio-dev/gate-dex

Official

by gate · Shell

Gate DEX MCP

Gate DEX MCP for wallet auth, transfers, swaps, token info, market data, and RPC access.

Enables wallet authentication, token swaps, transfers, and direct blockchain access for DEX trading.

README.md22 KBView on GitHub

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.

bash

# 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:

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):

json

{
  "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):

json

{
  "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):

json

{
  "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

bash

# 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

bash

# 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

bash

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):

json

{
  "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):

json

{
  "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.

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

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:

json

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

With API key authentication:

json

{
  "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

Install

claude_desktop_config.json

{
  "mcpServers": {
    "gate-dex": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gatemcp.ai/mcp/dex"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Gate MCP Server

Features

MCP Endpoints

Authorization (OAuth2)

Using mcporter

Scopes (for /mcp/exchange)

Quick Start

Prerequisites

Cursor

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

mcporter / OpenClaw

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

Prerequisites (before installing mcporter)

Install mcporter

Add MCP and authorize

Claude CLI

Method 1: One-click Install (Recommended)

Method 2: Manual Configuration

Trae

Qoder

Claude Desktop

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

LobeHub (desktop)

Other Clients

Basic Usage

Available Tools

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

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

DEX — Authentication

DEX — Wallet

DEX — Chain & Transactions

DEX — Market Data & Token Info

DEX — Agentic & RPC

Info — Coin & Market

Info — Market Trend & Technical Analysis

Info — On-chain Data

Info — Compliance

News — Search & Announcements

MCP Resources

FAQ

Q: Do I need a Gate account?

Q: Does it support trading?

Q: How often is the data updated?

Privacy & Security

Support & Feedback

Contributing

License

Install

Scopes (for `/mcp/exchange`)

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

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