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.
- 🔍 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
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).
/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.
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| 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 |
- 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)
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.
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.
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.
- Node.js >= 18 (mcporter requires npm)
- npm (comes with Node.js) — verify with:
node -vandnpm -v - Gate account (for OAuth login when using
/mcp/exchange)
# Global install
npm install -g mcporter
# Verify installation
mcporter --versionAlternatively, run without installing: npx mcporter <command> (uses current Node.js/npm).
# 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/newsSee OpenClaw setup for detailed steps.
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.
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 listEdit 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"
]
}
}
}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 requires a local stdio proxy.
- Download the Python proxy file
- 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.
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.
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.
| Client | Guide |
|---|---|
| Claude.ai | setup |
| Codex App | setup |
| Codex CLI | setup |
| OpenClaw | setup |
| Trae | See Trae config above |
| Qoder | See Qoder config above |
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
All tools use the cex_ prefix. Tools are split between Public MCP (no auth) and Private MCP (OAuth2).
| 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 |
Note: The private endpoint does not include public market data tools. Use
/mcpfor 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.
| 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 |
| 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 |
| 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 |
| 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 |
| 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.
| 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 |
| 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 |
| 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 |
| 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.
| 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.
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 |
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.
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).
A: Data is queried in real-time from Gate's API.
- OAuth2 authorization via Gate account (no API keys stored in config)
- All API calls use HTTPS
- See Gate Privacy Policy
- API Documentation: Gate API Docs
- Issue Reporting: Please contact Gate support
- Business Inquiries: Contact Gate official channels
See CONTRIBUTING.md.
MIT © gate.com