Gate DEX MCP

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 data — Spot/futures standard and RPI depth, options, delivery, margin, Earn, Alpha, CFD, stocks, collateral-loan parameters, unified-account simulation and Square (no OAuth)
• Trading and strategies — Spot/futures/options/delivery orders, POV, Chase, trigger orders, Trail and strategy bots
• Account and wallet — Balances, account transfers, deposit/withdrawal history, deposit addresses, unified accounts and wallet-level sub-account balances/transfers
• Earn and allocation — Auto investment, ordinary/stock dual investment, fixed-term and flexible lending, multi-collateral loans, flash swap and portfolio optimization
• CFD and stocks — Market information and authorized account, order, position and fund operations as separate domains
• 🌐 DEX - On-chain wallet, swap (single-chain & cross-chain), token info, market data across 20+ chains
• 📰 Info - Coin discovery, market snapshots, technical/platform metrics, on-chain and macro data
• 📢 News - Crypto news, social insights, market events, prediction markets
• 📚 Docs - Research reports, papers, and documentation search
• 🔐 OAuth2 - Secure authorization for trading and private tools

MCP Endpoints

The service exposes the following MCP endpoints:

• 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)
• ChatGPT / OpenAI Apps Gate Info listing → Use /mcp/open/info (7-tool allowlist; no auth)
• News, announcements → Use /mcp/news (no auth)
• Research docs & papers → Use /mcp/docs (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, /mcp/open/info, /mcp/news, and /mcp/docs 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)

Requirements for base, spot_trade, futures_trade, earn, cfd, stock depend on the tool and account type. In ordinary matching, base includes read and asset and is not read-only. Ordinary tokens retain per-tool OR compatibility with legacy scopes; Agentic accounts have separate read/write overrides and denied operations. mcp:tools does not replace a business scope.

See the per-tool permissions and authorization/PKCE resource reference. The connected endpoint's tools/list determines visibility; default scope advertisement does not establish application choices in every environment.

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 (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 supports remote custom connectors; a local proxy is not mandatory. Connect to https://api.gatemcp.ai/mcp for public data or use https://api.gatemcp.ai/mcp/exchange with Gate OAuth2 for authorized private tools.

The repository's Python stdio proxy is an optional public-data compatibility path, without OAuth or SSE parsing. See Claude Desktop setup.

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"