# Gate Mcp

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-gate-gate-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [gate](https://agentstack.voostack.com/s/gate)
- **Installs:** 0
- **Category:** [Finance & Payments](https://agentstack.voostack.com/c/finance-and-payments)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [gate](https://github.com/gate)
- **Source:** https://github.com/gate/gate-mcp

## Install

```sh
agentstack add mcp-gate-gate-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Gate MCP Server

[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)

[English](README.md) | [中文](README_zh.md)

---

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](#mcporter--openclaw-recommended) 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](https://github.com/gate/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](docs/setup-cursor.md).

### 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](https://github.com/gate/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 ` (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](docs/setup-openclaw.md) 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](https://github.com/gate/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.

1. Download the [Python proxy file](gate-mcp-proxy.py)
2. 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](docs/setup-claude-desktop.md) for detailed instructions.

### Alternative: gate-local-mcp (local stdio with API keys)

For local development without OAuth, use [gate-local-mcp](https://github.com/gate/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](gate-exchange/gate-local-mcp-tools.md).

#### LobeHub (desktop)

On the [LobeHub MCP marketplace](https://lobehub.com/zh/mcp/gate-gate-mcp) 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](https://lobehub.com/zh/docs/usage/community/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](docs/setup-claude-ai.md) |
| Codex App | [setup](docs/setup-codex-app.md) |
| Codex CLI | [setup](docs/setup-codex-cli.md) |
| OpenClaw | [setup](docs/setup-openclaw.md) |
| 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](https://www.gate.com/docs/developers/apiv4) or [gate-exchange-mcp](gate-exchange/gate-exchange-mcp.md).

### DEX — Authentication

| Tool | Description |
|------|-------------|
| `dex_auth_google_login_start` | Start Google

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [gate](https://github.com/gate)
- **Source:** [gate/gate-mcp](https://github.com/gate/gate-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-gate-gate-mcp
- Seller: https://agentstack.voostack.com/s/gate
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.