
Gate News MCP
- 33 repo stars
- Updated April 16, 2026
- gate/gate-mcp
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.
About
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. [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io) 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.
- [](https://opensource.org/licenses/MIT)
- [](https://modelcontextprotocol.io)
- [English](README.md) | [中文](README_zh.md)
- 💹 **Trading** - Create/cancel/amend spot, futures, options, delivery orders; price-triggered orders; trail orders
- 💼 **Account & Wallet** - Balances, transfers, deposits, withdrawals, sub-accounts, unified account
Gate News MCP by the numbers
- Exposes 14 verified tools (MCP introspection)
- Data as of Jul 20, 2026 (Skillselion catalog sync)
claude mcp add --transport http gate-news https://api.gatemcp.ai/mcp/newsAdd your badge
Show developers this MCP server is listed on Skillselion. Paste this into your README.
| repo stars | ★ 33 |
|---|---|
| Transport | HTTP |
| Auth | None |
| Tools | 14 |
| Last updated | April 16, 2026 |
| Repository | gate/gate-mcp ↗ |
How do agents access Gate MCP Server capabilities without custom integration code?
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.
Who is it for?
Developers wiring Gate MCP Server into Cursor, Claude Desktop, or other MCP clients.
Skip if: Teams that need features outside the documented Gate MCP Server tool surface.
What you get
Configured MCP host can call Gate MCP Server tools with schemas from the server README.
- In-agent summaries of crypto news and announcements
- Structured event and sentiment context for research notes
- Repeatable MCP queries you can script into validate workflows
By the numbers
- [object Object]
Gate News MCP capabilities & compatibility
- Capabilities
- [ | [中文](readme_zh.md) · 💹 **trading** create/cancel/amend spot, futur
- Use cases
- api development · orchestration
- Runs
- Runs locally
- Pricing
- Bring your own API key
What Gate News MCP says it does
https://api.gatemcp.ai/mcp
Tools 14
Public tool metadata - what this server can do for an agent.
news_events_explain_market_move5 params[Read] Explain what drove a crypto asset's price move in a given time window. Returns a concise summary (from real-time Tavily search), the latest high-priority real-time events, and supporting internal event pool items, plus data-completeness status. This tool is a data aggregator; the downstream agent performs the final attribution reasoning.
querystringrequiredUser's original question, e.g. 'Why did BTC surge?'coinstringrequiredTarget coin, e.g. BTC, ETH. Required at the Tool layer.time_rangestringTime window: 30m/1h/2h/4h/24h. Default 2h.modestringauto / price_move / event_impact. Default auto.langstringzh / en. Default zh.
news_events_get_event_detail1 param[Read] Full detail for one event_id only. Filtered event list or timeline -> get_latest_events. Unknown id returns not found.
event_idstringrequiredRequired event_id from get_latest_events items—opaque digest id, not a trading pair slug or headline hash.
news_events_get_latest_events7 params[Read] Filtered event list or timeline; each row includes event_id. One event_id detail -> get_event_detail. Headline/news feed -> search_news.
event_typestringOptional filter on structured digest event_type. Not search_news headline similarity/heat.coinstringOptional comma-separated tickers e.g. BTC,ETH for digest items; not the same as search_news tickers-only heat mode.time_rangestringRelative window for event digest list: 1h / 24h / 7d. Mutually exclusive with start_time/end_time; omit all for last 24h or server default when time filter disabled. Not CPI/Fed macro series—use macro indicator tools.limitintegerPage size; default 20, max 100.start_timestringAbsolute start (ISO8601 or Unix sec/ms). Mutually exclusive with time_range; pair with end_time or let server fill the other bound.end_timestringAbsolute end (ISO8601 or Unix sec/ms). Mutually exclusive with time_range.cursorstringOptional pagination cursor.
news_feed_get_exchange_announcements8 params[Read] Venue-published exchange notices: listings, delistings, maintenance. Media rumors or general crypto headlines -> search_news.
exchangestringVenue id for API platform; used when platform is empty; not merged with query.platformstringURL param platform; wins over exchange; if empty falls back to exchange.querystringOptional text filter on official venue notices; omit if empty. For general crypto media headlines use search_news—not a substitute for venue-published listing API.coinstringComma-separated tickers; omit if empty.announcement_typestringlisting / delisting / maintenance / all. Omit or unknown value is treated as all (no type filter).limitintegerMax rows; omit if unset or <= 0; cap 100 when set.fromintegerWindow start Unix sec; omit if <= 0; MCP also filters locally after fetch.tointegerWindow end Unix sec inclusive; forwarded downstream and filtered locally.
news_feed_get_social_sentiment2 params[Read] Aggregate per-coin social sentiment for a time range: overall sentiment, positive/negative split, mention count, and sample tweets. X/Twitter post search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc.
coinstringTickers e.g. BTC or BTC,ETH for per-coin aggregates: overall sentiment, positive/negative split, mention count, sample tweets (top_tweets order); omit defaults to BTC server-side. X/Twitter post search or tweet-level evidence -> search_x. Multi-platform social thread search -> search_ugc.time_rangestring1h / 24h (default) / 7d window for per-coin sentiment aggregation (overall sentiment, positive/negative split, mention count).
news_feed_search_news13 params[Read] Search the platform news index for headlines, news items, and briefing-style result lists. Open-web research with synthesized answers and cited external pages -> web_search. Event catalog with event_id -> get_latest_events.
querystringNon-empty: similarity mode (no tickers; default similarity_score 0.6). Empty: heat mode (top_total_score 1; optional coin/tickers). Platform news index for headlines, news items, and briefing-style result lists—not open-web research with synthesized answers and cited external pages (web_search) or event catalog with event_id (get_latest_events).coinstringComma-separated tickers mapped to API tickers; sent only when query is empty (omitted when query is set). Heat mode supports news-item / briefing-style lists on the platform index—not open-web synthesis (web_search).platformstringSource platform name for API platform (e.g. panews, theblock).platform_typestringLegacy: maps to API platform when platform is omitted; omit platform when value is all.langstringMCP-only filter on metadata.lang or top-level lang; not sent to upstream API.time_rangestringOptional preset window: 1h / 24h (default when preset value invalid) / 7d / 30d. When non-empty, overrides start_time/end_time and maps to API from/to (Unix epoch seconds). Omit to use start_time/end_time or implicit last-7d when both are empty.start_timestringStart time (ISO8601 or Unix sec/ms) mapped to API from. Ignored when time_range is set. Start-only defaults end to now; both empty defaults last 7d when time_range is also empty.end_timestringEnd time mapped to API to (Unix sec). Ignored when time_range is set. End-only defaults start to 24h before end.sort_bystringe.g. time (default); similarity mode with top_total_score 0 may still apply MCP local time sort.top_total_scoreintegerOnly when query empty (0 or 1); non-empty query forces similarity mode.limitintegerPage size mapped to API page_size; default 10, max 100.pageintegerPage number mapped to API page; default 1.similarity_scorestringSimilarity threshold; default 0.6 when query set; when query empty only sent if explicitly set.
news_feed_search_ugc9 params[Read] Reddit/Discord/Telegram/YouTube-style UGC: non-empty query uses vector API; coin without query uses OpenSearch. Both empty invalid. X/Twitter narrative -> search_x; headlines -> search_news. Not macro economic statistics; not structured event list -> get_latest_events.
querystringOptional NL query; non-empty uses vector search. May combine with coin; both empty is invalid.coinstringTicker filter; with query filters results; without query required with index for OpenSearch list mode.platformstringreddit / discord / telegram / youtube / all (default all).domainstringUGC topical bucket: crypto / defi / finance / macro / ai_agent / web3_dev / all (default all). macro = social discussion about macro themes, not CPI/Fed/unemployment statistics (use macro data tools) or get_latest_events.channelstringOptional source channel e.g. r/ethereum or handle.quality_tierstringA (default, high quality) / B / all.time_rangestring1h / 24h / 7d (default) / 30d / all.sort_bystringrelevance (default) / upvotes / recent.limitintegerMax items; default 10, max 50.
news_feed_search_x19 params[Read] Search and analyze X/Twitter discussions for a topic, with tweet-level evidence and cited posts. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentiment. Open-web pages -> web_search. Multi-platform social search -> search_ugc.
querystringX/Twitter topic for tweet-level evidence and cited posts; English recommended. xAI: empty returns no results. Aggregate social mood, sentiment score, or positive/negative split -> get_social_sentiment. Open-web pages -> web_search. Multi-platform social search -> search_ugc. Platform fallback matches search_news.query semantics.time_rangestringPreferred recency window for search_x: 1h / 24h (default) / 7d. Takes precedence over days when set.daysintegerxAI only: lookback days when time_range omitted; omitted or <=0 treated as 1 (24h); min 1 when explicitly set.allowed_handlesarrayxAI only: include these X handles without @, max 10; mutually exclusive with excluded_handles.excluded_handlesarrayxAI only: exclude these handles, max 10.modelstringxAI only: override configured Grok model id.enable_image_understandingbooleanxAI only: analyze images in posts.enable_video_understandingbooleanxAI only: analyze video in posts.coinstringPlatform fallback: maps to tickers for feed-style items when xAI path is unused—tweet-level X evidence remains the primary tool goal; per-coin sentiment KPIs -> get_social_sentiment.platformstringPlatform fallback: platform.platform_typestringPlatform fallback: maps when platform omitted.langstringAnswer language: zh (default) / en / auto. Also used by platform fallback as MCP local lang filter.start_timestringPlatform fallback: maps to from (Unix sec).end_timestringPlatform fallback: maps to to.sort_bystringPlatform fallback: sort field.top_total_scoreintegerPlatform fallback: heat vs similarity.limitintegerPlatform fallback: page_size, default 10.pageintegerPlatform fallback: page number.similarity_scorestringPlatform fallback: similarity threshold.
news_feed_web_search6 params[Read] Search the open web and return a synthesized answer with cited external pages. Built-in headline lookup, news-item search, or briefing-style news list -> search_news. X/Twitter-only discussion or tweet evidence -> search_x.
querystringRequired NL question: search the open web and return a synthesized answer with cited external pages—not built-in headline lookup, news-item search, or briefing-style news list (search_news), nor X/Twitter-only discussion or tweet-level evidence (search_x).coinstringOptional ticker or project (e.g. BTC, ETH) to focus the open-web synthesized answer—not platform news index tickers (search_news).modestringAnswer length: analysis (default, fuller synthesized text) or brief (~100 chars). Not chart/indicator technical analysis (RSI/MACD).time_rangestringRecency window for open-web synthesis with cited external pages: 1h / 24h (default) / 7d / 30d. Not DeFi/TVL dashboard metrics (use platform-metrics tools).langstringAnswer language: zh (default) / en / auto.limitintegerMax cited external pages in the answer; default 5, max 10.
news_prediction_get_event_signal5 params[Read] Single event signal from dws_external_event_signal_hf by event_ref (venue:venue_event_id). window 1h/24h/7d (default 24h). Returns outcome_probabilities, volume_flow, directional_context, optional markets[] (default include_markets=true). depth_summary always null—use get_market_orderbook for live depth. daily_ranking when rank index configured. Discover event_ref -> search_events. include_orderbook_summary ignored.
event_refstringrequiredRequired. venue:venue_event_id (split on first colon; id may contain more colons). Discover via search_events.windowstringRecency filter on part_hour; default 24h. Allowed: 1h, 24h, 7d (case-insensitive).venuearrayOptional; each non-empty value must equal event_ref venue or invalid_param.include_marketsbooleanOmitted or null defaults true. false omits markets[]; true parses embedded markets or enriches from predictionMarketIndex.include_orderbook_summarybooleanDeprecated and ignored; depth_summary is always null—use get_market_orderbook.
news_prediction_get_fastest_rising_ranking5 params[Read] Daily venue/overall ranking by probability rise (UTC rank_date). Optional venue[], category, status (same as volume_delta ranking). Drops rows missing open_mid_probability_utc or probability_delta_today. Requires predictionRankIndex.
date_utcstringUTC date in YYYY-MM-DD. Defaults to today_utc.limitintegerPage size; default 20, max 100.venuearrayOptional venue filter. Allowed: polymarket, predict_fun.categorystringOptional category filter: exact term on rank index field category; omit or all to disable.statusstringOptional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.
news_prediction_get_market_orderbook8 params[Read] Live current order book only (mode=current). depth 1-20 (default 20). polymarket: market_id=venue_market_id; needs opensearch.predictionMarketIndex for token lookup (else not_implemented); yes/no CLOB /book in parallel—partial if one side fails, tool error only if both fail. predict_fun: official numeric market_id (not polymarket ids); needs predictFunAPIKey—empty/missing config returns partial_not_configured (no HTTP); API/parse errors return partial (not internal); 404 resource_not_found. Rejects history/granularity/time/page_token. snapshot_time/book_levels/best_* may be null when partial. Event list/signal -> search_events / get_event_signal.
venuestringrequiredRequired. polymarket or predict_fun. polymarket needs predictionMarketIndex; predict_fun needs predictFunAPIKey (else partial_not_configured, not a tool error).market_idstringrequiredRequired. polymarket: venue_market_id in dws_prediction_market_hf (token lookup). predict_fun: official numeric id (e.g. 356640), not polymarket venue_market_id.depthintegeryes_bids/yes_asks top-N levels; default 20; allowed 1-20 inclusive; out of range invalid_param.modestringEmpty or current only (default current). history and other values rejected.granularitystringUnsupported; if set, request is rejected.start_timestringUnsupported; if set, request is rejected.end_timestringUnsupported; if set, request is rejected.page_tokenstringUnsupported; if set, request is rejected.
news_prediction_get_volume_delta_ranking5 params[Read] Daily venue/overall ranking by volume delta (UTC rank_date). Optional venue[], category (exact term on rank index), status (active/closed/resolved/all; default active). Requires opensearch.predictionRankIndex.
date_utcstringUTC date in YYYY-MM-DD. Defaults to today_utc.limitintegerPage size; default 20, max 100.venuearrayOptional venue filter. Allowed: polymarket, predict_fun.categorystringOptional category filter: exact term on rank index field category; omit or all to disable.statusstringOptional status filter on rank index. Allowed: active, closed, resolved, all. Defaults to active.
news_prediction_search_events9 params[Read] Search prediction events on opensearch.predictionEventSignalIndex (dws_prediction_event_signal_hf alias, hourly UNIQUE part_hour+venue+venue_event_id). query/coin/category optional; coin-only unsupported_filter. status filters event_status; status_tags from status_json_array. sort recently_listed uses create_time (first_seen); volume_delta_today uses total_volume_usd_24h (no volume_delta column). category filter: event_category_primary or lead_market_category_primary; excludes empty event_category_primary. Collapse venue_event_id. with_markets: source_markets_json or predictionMarketIndex. Detail -> get_event_signal (external); orderbook -> get_market_orderbook.
querystringOptional full-text query; all of query, coin, category are optional.coinstringOptional coin ticker; cannot be used alone without query or category (unsupported_filter). With query/category expands text recall only (best_effort).categorystringOptional primary category enum (crypto_price, sports, elections, …). Matches event_category_primary or lead_market_category_primary.statusstringFilter by ES event_status; default active. Allowed: active, closed, resolved, all. Response status_tags comes from status_json_array.venuearrayOptional venue filter. Allowed: polymarket, predict_fun.sort_bystringSort key; default attention. Allowed: attention, volume, liquidity, recently_listed, probability_change, volume_delta_today (maps to total_volume_usd_24h on signal index).limitintegerPage size; default 20, max 100.page_tokenstringBase64URL page token from prior next_page_token; filters must match first page.with_marketsbooleanWhen true, attach market summaries from source_markets_json or predictionMarketIndex.
README.md
Gate MCP Server
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 -vandnpm -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.
- 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.
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
/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.
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
Recommended MCP Servers
How it compares
Hosted finance news MCP integration, not an on-chain wallet or execution skill.
FAQ
What does Gate MCP Server do?
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.
When should I use Gate MCP Server?
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.
Is Gate MCP Server safe to install?
Review the Security Audits panel on this page before installing in production.