Skip to content

gate/gate-mcp

Repository files navigation

Gate MCP Server

License: MIT MCP

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 (futuresfx, deliverydc, sub_accountsa, 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

About

An MCP (Model Context Protocol) server that exposes Gate.io trading API as tools for AI agents.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors