/gate-mcp-skill

name: gate-mcp-skill
description: Use Gate MCP through UXC for public spot and futures market data workflows with a fixed streamable-http endpoint and read-first guardrails.

Gate MCP Skill

Use this skill to run Gate public market data workflows through `uxc` + MCP.

Reuse the `uxc` skill for shared MCP execution, output parsing, and generic auth guidance.

Prerequisites

• `uxc` is installed and available in `PATH`.
• Network access to `https://api.gatemcp.ai/mcp`.

Scope

This skill covers the official Gate MCP surface for:

• public spot market discovery
• public spot tickers, trades, order books, and candlesticks
• public futures contracts, tickers, trades, order books, funding, and premium data

This skill does **not** cover:

• private account or trading workflows
• Gate REST v4 signed APIs
• wallet, funding, or portfolio actions

Endpoint

Use Gate's official MCP endpoint:

• `https://api.gatemcp.ai/mcp`

Core Workflow

1. Use the fixed link command by default:

• `command -v gate-mcp-cli`
• If missing, create it:

`uxc link gate-mcp-cli https://api.gatemcp.ai/mcp`

• `gate-mcp-cli -h`

2. Inspect tool and argument help before execution:

• `gate-mcp-cli cex_spot_get_spot_tickers -h`
• `gate-mcp-cli cex_spot_get_spot_order_book -h`
• `gate-mcp-cli cex_fx_get_fx_tickers -h`
• `gate-mcp-cli cex_fx_get_fx_order_book -h`

3. Prefer narrow spot or futures reads with explicit instrument identifiers:

• `gate-mcp-cli cex_spot_get_spot_tickers currency_pair=BTC_USDT`
• `gate-mcp-cli cex_spot_get_spot_order_book currency_pair=BTC_USDT limit=20`
• `gate-mcp-cli cex_fx_get_fx_tickers contract=BTC_USDT`
• `gate-mcp-cli cex_fx_get_fx_funding_rate contract=BTC_USDT`

Operations

Spot

• `cex_spot_list_currencies`
• `cex_spot_list_currency_pairs`
• `cex_spot_get_currency`
• `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

• `cex_fx_list_fx_contracts`
• `cex_fx_get_fx_contract`
• `cex_fx_get_fx_tickers`
• `cex_fx_get_fx_order_book`
• `cex_fx_get_fx_trades`
• `cex_fx_get_fx_candlesticks`
• `cex_fx_get_fx_funding_rate`
• `cex_fx_get_fx_premium_index`
• `cex_fx_list_fx_liq_orders`

Guardrails

• Keep automation on the JSON output envelope; do not use `--text`.
• Parse stable fields first: `ok`, `kind`, `protocol`, `data`, `error`.
• Treat this v1 skill as read-only.
• Prefer `currency_pair` values like `BTC_USDT` for spot and `contract` values like `BTC_USDT` for futures unless help output indicates a different contract name.
• `gate-mcp-cli <operation> ...` is equivalent to `uxc https://api.gatemcp.ai/mcp <operation> ...`.

References

• Usage patterns: `references/usage-patterns.md`
• Official Gate for AI / MCP docs: https://www.gate.com/gate-mcp-skills
• Gate MCP setup article: https://www.gate.com/ru/help/gateforai/gateforaibasics/50102/gate-for-ai-one-click-integration-with-major-ai-agents-no-api-keys-required-zero-barriers