io.github.gateio-dev/gate-mcp

Official63 tools

by gate · Shell

Gate MCP

Public Gate market data MCP for spot, futures, margin, options, delivery, earn, and alpha.

Provides market data access for spot, futures, margin, options, and other crypto trading products.

Captured live from the server via tools/list.

cex_activity_list_activity_types

List activity types.

No parameters.

cex_alpha_list_alpha_currencies

List Alpha currencies.

Parameters (3)

currencystring
Query by currency symbol
limitnumber
Maximum number of records returned in a single list
pagenumber
Page number

cex_alpha_list_alpha_tickers

List Alpha tickers.

Parameters (3)

currencystring
Query by specified currency name
limitnumber
Maximum number of records returned in a single list
pagenumber
Page number

cex_alpha_list_alpha_tokens

List Alpha tokens.

Parameters (4)

addressstring
Query by contract address
chainstring
Chain: solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer
launch_platformstring
Launch platform: meteora_dbc, fourmeme, moonshot, pump, raydium_launchlab, letsbonk, gatefun, virtuals
pagenumber
Page number

cex_dc_get_dc_contract

Get delivery contract.

Parameters (2)

contractstringrequired
Delivery contract identifier (e.g. BTC_USDT)
settlestring
Settlement currency for delivery (e.g. usdt, btc)

cex_dc_list_dc_candlesticks

List delivery candlesticks.

Parameters (6)

contractstringrequired
Delivery contract identifier (e.g. BTC_USDT; may use mark_/index_ prefix for price type)
fromnumber
Start timestamp in seconds
intervalstring
Time interval for data points
limitnumber
Maximum number of data points to return
settlestring
Settlement currency for delivery (e.g. usdt, btc)
tonumber
End timestamp in seconds

cex_dc_list_dc_contracts

List delivery contracts.

Parameters (1)

settlestring
Settlement currency for delivery (e.g. usdt, btc)

cex_dc_list_dc_insurance_ledger

List delivery insurance ledger.

Parameters (2)

limitnumber
Maximum number of records to return
settlestring
Settlement currency for delivery (e.g. usdt, btc)

cex_dc_list_dc_order_book

Get delivery order book.

Parameters (5)

contractstringrequired
Delivery contract identifier (e.g. BTC_USDT)
intervalstring
Order depth aggregation precision. 0 means no aggregation, defaults to 0 if not specified
limitnumber
Maximum number of order depth levels to return
settlestring
Settlement currency for delivery (e.g. usdt, btc)
with_idboolean
Whether to return order book update ID

cex_dc_list_dc_risk_limit_tiers

List delivery risk limit tiers.

Parameters (4)

contractstring
Optional delivery contract identifier; if set, risk tiers for that contract only
limitnumber
Maximum number of records to return
offsetnumber
List offset, starting from 0
settlestring
Settlement currency for delivery (e.g. usdt, btc)

cex_dc_list_dc_tickers

List delivery tickers.

Parameters (2)

contractstring
Optional delivery contract identifier; if set, only that contract's ticker is returned
settlestring
Settlement currency for delivery (e.g. usdt, btc)

cex_dc_list_dc_trades

List delivery trades.

Parameters (6)

contractstringrequired
Delivery contract identifier (e.g. BTC_USDT)
fromnumber
Start timestamp in seconds
last_idstring
Specify list starting point using the last record ID from previous request
limitnumber
Maximum number of records to return
settlestring
Settlement currency for delivery (e.g. usdt, btc)
tonumber
End timestamp in seconds

cex_earn_list_dual_investment_plans

List dual investment plans.

Parameters (7)

coinstring
Investment currency, e.g. BTC
pagenumber
Page number
page_sizenumber
Items per page
plan_idnumber
Financial project ID (int64)
quote_currencystring
Settlement currency: default USDT, optional GUSD
sortstring
Sort: apy (APR desc), short-period (term asc), multiple (premium desc)
typestring
put (low buy) or call (high sell)

cex_earn_list_earn_fixed_term_products

List fixed-term Earn products.

Parameters (4)

assetstring
Currency name, e.g. USDT
limitnumberrequired
Page size
pagenumberrequired
Page number
typenumber
Product type: 1=normal, 2=vip

cex_earn_list_earn_fixed_term_products_by_asset

List fixed-term Earn products by asset.

Parameters (2)

assetstringrequired
Currency name, e.g. USDT, BTC
typestring
Product type: empty or 1=normal, 2=vip, 0=all

cex_earn_list_uni_currencies

List Simple Earn currencies.

No parameters.

cex_fx_get_fx_candlesticks

Get futures candlestick/OHLCV data

Parameters (7)

contractstringrequired
Futures contract name
fromnumber
Start timestamp in seconds. Defaults to to - 100 * interval if not specified
intervalstring
Time interval. Note: 1w means natural week, 7d aligns with Unix epoch, 30d means natural month
limitnumber
Maximum number of data points to return. Mutually exclusive with from/to parameters
settlestring
Settlement currency
timezonestring
Timezone: all/utc0/utc8, defaults to utc0
tonumber
End timestamp in seconds, defaults to current time if not specified

cex_fx_get_fx_contract

Get details of a single futures contract

Parameters (2)

contractstringrequired
Futures contract name
settlestring
Settlement currency

cex_fx_get_fx_funding_rate

Get funding rate history for a futures contract

Parameters (5)

contractstringrequired
Futures contract name
fromnumber
Start timestamp in seconds
limitnumber
Maximum number of records to return
settlestring
Settlement currency
tonumber
End timestamp in seconds

cex_fx_get_fx_order_book

Get futures order book

Parameters (5)

contractstringrequired
Futures contract name
intervalstring
Order depth aggregation precision. 0 means no aggregation, defaults to 0 if not specified
limitnumber
Maximum number of order depth levels to return
settlestring
Settlement currency
with_idboolean
Whether to return order book update ID. ID increments by 1 on each change

cex_fx_get_fx_premium_index

Get premium index (mark price minus index price) history for a contract

Parameters (6)

contractstringrequired
Futures contract name
fromnumber
Start timestamp in seconds. Defaults to to - 100 * interval if not specified
intervalstring
Time interval for data points
limitnumber
Maximum number of data points to return. Mutually exclusive with from/to parameters
settlestring
Settlement currency
tonumber
End timestamp in seconds, defaults to current time if not specified

cex_fx_get_fx_risk_limit_table

Get a specific risk limit tier table by table ID.

Parameters (2)

settlestringrequired
Settlement currency: usdt or btc
table_idstringrequired
Risk limit table ID

cex_fx_get_fx_tickers

Get ticker information for futures contracts

Parameters (2)

contractstring
Futures contract name. Only returns data for this contract if specified
settlestring
Settlement currency

cex_fx_get_fx_trades

Get recent public trades for a futures contract

Parameters (7)

contractstringrequired
Futures contract name
fromnumber
Start timestamp in seconds. If not specified, returns records limited by to and limit
last_idstring
Specify list starting point using the last record ID from previous request
limitnumber
Maximum number of records to return
offsetnumber
List offset, starting from 0
settlestring
Settlement currency
tonumber
End timestamp in seconds, defaults to current time if not specified

cex_fx_get_index_constituents

Get constituent assets and weights for a futures index

Parameters (2)

indexstringrequired
Index name
settlestring
Settlement currency

cex_fx_list_batch_fx_funding_rates

Get current funding rates for multiple contracts in one request

Parameters (2)

contractsstringrequired
Comma-separated list of contract names, e.g. BTC_USDT,ETH_USDT
settlestring
Settlement currency

cex_fx_list_contract_stats

Get contract statistics (open interest， long/short ratio， etc.)

Parameters (5)

contractstringrequired
Futures contract name
fromnumber
Start timestamp in seconds
intervalstring
Time interval for data points
limitnumber
Maximum number of data points to return
settlestring
Settlement currency

cex_fx_list_fx_contracts

List all perpetual futures contracts

Parameters (3)

limitnumber
Maximum number of records to return
offsetnumber
List offset, starting from 0
settlestring
Settlement currency

cex_fx_list_fx_insurance_ledger

Get futures insurance fund history

Parameters (2)

limitnumber
Maximum number of records to return
settlestring
Settlement currency

cex_fx_list_fx_liq_orders

Get personal futures liquidation history.

Parameters (5)

contractstring
Futures contract name. Only returns data for this contract if specified
fromnumber
Start timestamp in seconds
limitnumber
Maximum number of records to return
settlestring
Settlement currency
tonumber
End timestamp in seconds

cex_launch_get_candy_drop_activity_list_v4

List CandyDrop activities with optional filters (public, no auth)

Parameters (6)

currencystring
Filter by currency name
limitnumber
Max rows to return, default 10, max 30
offsetnumber
Offset for pagination, default 0
register_statusstring
registered | unregistered; omit for all
rule_namestring
Task type filter: spot, futures, deposit, invite, trading_bot, simple_earn, first_deposit, alpha, flash_swap, tradfi, etf
statusstring
ongoing | upcoming | ended; omit for all

cex_launch_get_candy_drop_activity_rules_v4

Get CandyDrop activity rules including prize pools and tasks (public). Pass activity_id OR currency (at least one required by API)

Parameters (2)

activity_idnumber
Activity ID; use with or instead of currency
currencystring
Project/currency name; use with or instead of activity_id

cex_launch_get_hodler_airdrop_project_list

List HODLer Airdrop campaigns with optional filters (public; logged-in users may see extra participation info)

Parameters (5)

joinnumber
Participation filter: 0=all (default), 1=joined only. Omit parameter to use API default (all)
keywordstring
Fuzzy match on currency or project name
pagenumber
Page number, starting from 1
sizenumber
Items per page, default 10
statusstring
Filter: ACTIVE, UNDERWAY, PREHEAT, FINISH; omit for all

cex_launch_list_launch_pool_projects

List launch pool projects with optional filters

Parameters (7)

limit_rulenumber
Limit rule: 0=Normal pool, 1=Newbie pool
mortgage_coinstring
Staking currency exact match
pagenumber
Page number, starting from 1
page_sizenumber
Items per page, default 10, max 30
search_coinstring
Reward currency & name fuzzy match
sort_typenumber
Sort type: 1=Max APR descending, 2=Max APR ascending
statusnumber
Project status filter: 0=All, 1=In progress, 2=Warming up, 3=Ended, 4=In progress + Warming up

cex_margin_get_market_margin_tier

Get margin leverage tiers for a currency pair

Parameters (1)

currency_pairstringrequired
Currency pair, e.g. BTC_USDT

cex_margin_get_uni_currency_pair

Get details of a specific unified margin currency pair

Parameters (1)

currency_pairstringrequired
Currency pair, e.g. ADA_USDT

cex_margin_list_uni_currency_pairs

List all currency pairs supported for unified margin lending

No parameters.

cex_mcl_get_multi_collateral_current_rate

Get current interest rates for specified currencies in multi-collateral loans (public)

Parameters (2)

currenciesstringrequired
Currency names separated by commas, e.g. BTC,ETH,USDT. Maximum 100 items
vip_levelstring
VIP level, defaults to 0 if not specified

cex_mcl_get_multi_collateral_fix_rate

Get available fixed interest rates for multi-collateral loans (public)

No parameters.

cex_mcl_get_multi_collateral_ltv

Get LTV (Loan-to-Value) ratios for multi-collateral loans (public)

No parameters.

cex_mcl_list_multi_collateral_currencies

List all supported currencies for multi-collateral loans (public)

No parameters.

cex_options_get_options_contract

Get details of a single options contract

Parameters (1)

contractstringrequired
Options contract name

cex_options_get_options_settlement

Get a single options settlement record

Parameters (3)

atstringrequired
Settlement timestamp (Unix timestamp in seconds)
contractstringrequired
Options contract name
underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_candlesticks

Get options candlestick data

Parameters (5)

contractstringrequired
Options contract name
fromnumber
Start timestamp in seconds
intervalstring
Time interval between data points, e.g. 1m, 5m, 15m, 30m, 1h
limitnumber
Maximum number of records to return
tonumber
End timestamp in seconds

cex_options_list_options_contracts

List all options contracts for an underlying

Parameters (2)

expirationnumber
Unix timestamp of expiration date
underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_expirations

List option expiration dates for an underlying

Parameters (1)

underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_order_book

Get options order book

Parameters (4)

contractstringrequired
Options contract name
intervalstring
Price precision for merged depth. 0 means no merging
limitnumber
Number of depth levels
with_idboolean
Whether to return depth update ID

cex_options_list_options_settlements

List options settlement history for an underlying

Parameters (5)

fromnumber
Start timestamp in seconds
limitnumber
Maximum number of records to return
offsetnumber
List offset, starting from 0
tonumber
End timestamp in seconds
underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_tickers

Get options tickers for an underlying

Parameters (1)

underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_trades

List public options trades

Parameters (6)

contractstring
Options contract name
fromnumber
Start timestamp in seconds
limitnumber
Maximum number of records to return
offsetnumber
List offset, starting from 0
tonumber
End timestamp in seconds
typestring
Option type: C for call, P for put

cex_options_list_options_underlying_candlesticks

Get candlestick data for an options underlying index

Parameters (5)

fromnumber
Start timestamp in seconds
intervalstring
Time interval between data points, e.g. 1m, 5m, 15m, 30m, 1h
limitnumber
Maximum number of records to return
tonumber
End timestamp in seconds
underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_underlying_tickers

Get ticker data for all contracts under an underlying

Parameters (1)

underlyingstringrequired
Underlying asset name, e.g. BTC_USDT

cex_options_list_options_underlyings

List all options underlying assets

No parameters.

cex_spot_get_currency

Get details of a single currency

Parameters (1)

currencystringrequired
Currency name

cex_spot_get_currency_pair

Get details of a single currency pair

Parameters (1)

currency_pairstringrequired
Currency pair name, e.g. BTC_USDT

cex_spot_get_spot_candlesticks

Get candlestick/OHLCV data for a currency pair

Parameters (5)

currency_pairstringrequired
Currency pair
fromnumber
Start time of K-line in Unix timestamp (seconds). Defaults to to - 100 * interval if not specified
intervalstring
Time interval of data points. Note: 30d represents natural month, not 30 days
limitnumber
Maximum number of data points to return. Mutually exclusive with from/to parameters
tonumber
End time of K-line in Unix timestamp (seconds). Defaults to current time if not specified

cex_spot_get_spot_order_book

Get the order book for a currency pair

Parameters (4)

currency_pairstringrequired
Currency pair
intervalstring
Order depth aggregation precision. 0 means no aggregation
limitnumber
Maximum number of order depth levels to return, default 10, max 100
with_idboolean
Whether to return order book update ID

cex_spot_get_spot_tickers

Get ticker information for one or all currency pairs

Parameters (2)

currency_pairstring
Currency pair name, e.g. BTC_USDT. Returns all pairs if not specified
timezonestring
Timezone, e.g. Asia/Shanghai. Affects the time range of statistics

cex_spot_get_spot_trades

Get recent trades for a currency pair

Parameters (7)

currency_pairstringrequired
Currency pair
fromnumber
Start timestamp in seconds
last_idstring
Use the last record ID from previous list as starting point for next list
limitnumber
Maximum number of records to return, default 100
pagenumber
Page number
reverseboolean
Whether to retrieve records less than last_id. Default returns records greater than last_id
tonumber
End timestamp in seconds, defaults to current time if not specified

cex_spot_list_currencies

List all currencies supported

No parameters.

cex_spot_list_currency_pairs

List all available spot trading pairs

No parameters.

cex_square_list_live_replay

List live stream replays from Gate Square

Parameters (4)

coinstring
Currency name filter (e.g. BTC, ETH)
limitnumber
Number of results, 1~10, default 3
sortstring
Sort order: hot=hottest (default), new=newest
tagstring
Business type filter: Market Analysis, Hot Topics, Blockchain, Others

cex_square_list_square_ai_search

Search Gate Square content using AI (posts， analysis， signals)

Parameters (6)

currencystring
Currency filter (exact currency code, e.g. BTC, ETH, SOL)
keywordstring
Search keyword (currency name or content keyword, e.g. BTC, ETH)
limitnumber
Number of results, 1~50, default 10
pagenumber
Page number for pagination, starting from 1
sortnumber
Sort order: 0=hottest (default), 1=newest
time_rangenumber
Time range: 0=all (default), 1=last day, 2=last week, 3=last month

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-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.gatemcp.ai/mcp"
      ]
    }
  }
}

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

cex_activity_list_activity_types

cex_alpha_list_alpha_currencies

cex_alpha_list_alpha_tickers

cex_alpha_list_alpha_tokens

cex_dc_get_dc_contract

cex_dc_list_dc_candlesticks

cex_dc_list_dc_contracts

cex_dc_list_dc_insurance_ledger

cex_dc_list_dc_order_book

cex_dc_list_dc_risk_limit_tiers

cex_dc_list_dc_tickers

cex_dc_list_dc_trades

cex_earn_list_dual_investment_plans

cex_earn_list_earn_fixed_term_products

cex_earn_list_earn_fixed_term_products_by_asset

cex_earn_list_uni_currencies

cex_fx_get_fx_candlesticks

cex_fx_get_fx_contract

cex_fx_get_fx_funding_rate

cex_fx_get_fx_order_book

cex_fx_get_fx_premium_index

cex_fx_get_fx_risk_limit_table

cex_fx_get_fx_tickers

cex_fx_get_fx_trades

cex_fx_get_index_constituents

cex_fx_list_batch_fx_funding_rates

cex_fx_list_contract_stats

cex_fx_list_fx_contracts

cex_fx_list_fx_insurance_ledger

cex_fx_list_fx_liq_orders

cex_launch_get_candy_drop_activity_list_v4

cex_launch_get_candy_drop_activity_rules_v4

cex_launch_get_hodler_airdrop_project_list

cex_launch_list_launch_pool_projects

cex_margin_get_market_margin_tier

cex_margin_get_uni_currency_pair

cex_margin_list_uni_currency_pairs

cex_mcl_get_multi_collateral_current_rate

cex_mcl_get_multi_collateral_fix_rate

cex_mcl_get_multi_collateral_ltv

cex_mcl_list_multi_collateral_currencies

cex_options_get_options_contract

cex_options_get_options_settlement

cex_options_list_options_candlesticks

cex_options_list_options_contracts

cex_options_list_options_expirations

cex_options_list_options_order_book

cex_options_list_options_settlements

cex_options_list_options_tickers

cex_options_list_options_trades

cex_options_list_options_underlying_candlesticks

cex_options_list_options_underlying_tickers

cex_options_list_options_underlyings

cex_spot_get_currency

cex_spot_get_currency_pair

cex_spot_get_spot_candlesticks

cex_spot_get_spot_order_book

cex_spot_get_spot_tickers

cex_spot_get_spot_trades

cex_spot_list_currencies

cex_spot_list_currency_pairs

cex_square_list_live_replay

cex_square_list_square_ai_search

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

Scopes (for `/mcp/exchange`)

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

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