skills/gate-mcp-installer
Gate MCP Installer (unified: Cursor / Claude Code / Codex / OpenClaw)
General Rules
⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding. Do NOT select or call any tool until all rules are read. These rules have the highest priority. → Read gate-runtime-rules.md
- Only call MCP tools explicitly listed in this skill. Tools not documented here must NOT be called, even if they exist in the MCP server.
MCP Dependencies
Required MCP Servers (after install)
| MCP Server | Status |
|---|---|
| Gate (main) | ✅ For local CEX (stdio) |
| gate-cex-pub | ✅ Remote public |
| gate-cex-ex | ✅ Remote private (OAuth2) |
| gate-dex | ✅ DEX |
| gate-info | ✅ Info |
| gate-news | ✅ News |
| gatepay-local-mcp | ➕ Optional (Gate Pay x402 stdio; --mcp gatepay-local) |
| gatepay-merchant-discovery | ➕ Optional (HTTP merchant catalog / discoveryResource; --mcp gatepay-discovery) |
| Gate Verify (tx check-in) | ✅ HTTP MCP https://api.gatemcp.ai/mcp/dex/sec — merged as gate-dex-sec (Cursor / Claude / Codex / mcporter) whenever dex is installed; call tx_checkin / /v1/tx/checkin per gate-dex-wallet |
Installation Check
- Run this skill’s installer script, or guide the user to run it.
- If multiple dev environments exist on one machine (e.g. Cursor + Claude Code), the script requires
--platform.
MCP Mode
Read and strictly follow references/mcp.md, then execute this installer workflow.
SKILL.md— product scope, triggers, and user-facing guidance.references/mcp.md— execution SOP per platform, verification, and safety rules.
Platform matrix
| Platform | MCP / transport config | Skills directory |
|---|---|---|
| Cursor | ~/.cursor/mcp.json (Windows: %APPDATA%\Cursor\mcp.json) | ~/.cursor/skills/ |
| Claude Code | ~/.claude.json (mcpServers) | ~/.claude/skills/ |
| Codex | ~/.codex/config.toml ([mcp_servers.*]) | ~/.codex/skills/ |
| OpenClaw | mcporter CLI (no single JSON file) | ~/.openclaw/skills/ (default) |
CEX MCP modes
See gate-mcp:
| Mode | What | Auth |
|---|---|---|
| Local CEX | stdio npx -y gate-mcp (or global gate-mcp) | Optional GATE_API_KEY / GATE_API_SECRET |
| Remote public | https://api.gatemcp.ai/mcp | None |
| Remote exchange | https://api.gatemcp.ai/mcp/exchange | Gate OAuth2 in client / mcporter auth gate-cex-ex |
Non-CEX (same host): Dex (/mcp/dex), Info (/mcp/info), News (/mcp/news). Dex uses fixed x-api-key MCP_AK_8W2N7Q + Bearer ${GATE_MCP_TOKEN} where applicable.
Tx check-in (Gate Verify / GV)
Gate Verify is a second HTTP MCP on the same host as remote DEX, used only for signing check-in:
| Role | Install surface |
|---|---|
| Wallet / DEX tools | gate-dex → https://api.gatemcp.ai/mcp/dex (headers per fragment) |
| Gate Verify | gate-dex-sec → https://api.gatemcp.ai/mcp/dex/sec (URL-only / streamable-http; no wallet HTTP headers on this entry) |
This installer adds the Verify MCP whenever --mcp dex is included (default full install includes it). Agents call tx_checkin or /v1/tx/checkin on the Verify server with authorization = the same mcp_token as wallet MCP tool args — see gate-dex-wallet references/tx-checkin.md. Staged swap specifics: gate-dex-trade skill.
Resources
| Type | Name | Notes |
|---|---|---|
| MCP | Gate (main) | stdio; prefer global gate-mcp when installed |
| MCP | gate-cex-pub | HTTP remote public |
| MCP | gate-cex-ex | HTTP remote private + OAuth2 |
| MCP | gate-dex | HTTP + headers |
| MCP | gate-dex-sec | HTTP https://api.gatemcp.ai/mcp/dex/sec; tx_checkin before signing — bundled with dex install |
| MCP | gate-info / gate-news | HTTP |
| MCP | gatepay-local-mcp | stdio npx -y gatepay-local-mcp; wallet env per gate-pay-x402 |
| MCP | gatepay-merchant-discovery | HTTP http://dev.halftrust.xyz/pay-mcp-server/mcp; catalog only (gate-pay-x402) |
| Skill | gate-dex-wallet | Routing for Verify MCP + wallet flows — references/tx-checkin.md |
| Skills | gate-skills | https://github.com/gate/gate-skills |
Behavior rules
- Default: Install all six trading MCP surfaces + Gate Verify (bundled with
dex) + all gate-skills unless the user opts out. Gate Pay MCPs are not included by default: add--mcp gatepay-local(x402 stdio) and/or--mcp gatepay-discovery(remote merchant catalog) when needed. Omittingdexalso omits the Verify MCP entry. - Selectable:
--mcp main|cex-public|cex-exchange|dex|info|news|gatepay-local|gatepay-discovery(repeatable). - Skills:
--no-skillsinstalls MCP configuration only. - OpenClaw:
--select/-skeeps the interactive single-server menu (mcporter legacy UX).
Installer script
Path: skills/gate-mcp-installer/scripts/install.sh
# Auto-detect when only one environment matches
bash skills/gate-mcp-installer/scripts/install.sh
# Force platform (required if multiple clients detected)
bash skills/gate-mcp-installer/scripts/install.sh --platform cursor
bash skills/gate-mcp-installer/scripts/install.sh --platform claude
bash skills/gate-mcp-installer/scripts/install.sh --platform codex
bash skills/gate-mcp-installer/scripts/install.sh --platform openclaw
# Subset of MCPs
bash skills/gate-mcp-installer/scripts/install.sh --platform cursor --mcp main --mcp dex
# Gate Pay x402 (stdio) alongside trading MCPs
bash skills/gate-mcp-installer/scripts/install.sh --platform cursor --mcp gatepay-local
# With --mcp main, the script prompts for GATE_API_KEY (CEX local MCP only); gatepay-local-mcp env is separate (gate-pay-x402).
bash skills/gate-mcp-installer/scripts/install.sh --platform cursor --mcp main --mcp gatepay-local
# Gate Pay merchant discovery (HTTP; discoveryResource) — often paired with gatepay-local
bash skills/gate-mcp-installer/scripts/install.sh --platform cursor --mcp gatepay-discovery
bash skills/gate-mcp-installer/scripts/install.sh --platform cursor --mcp gatepay-local --mcp gatepay-discovery --no-skills
# MCP only
bash skills/gate-mcp-installer/scripts/install.sh --no-skills
# OpenClaw interactive pick
bash skills/gate-mcp-installer/scripts/install.sh --platform openclaw --select
OpenClaw quick commands (mcporter)
mcporter list gate-cex-pub
mcporter call gate-info.list_tickers currency_pair=BTC_USDT
mcporter call gate-news.list_news
mcporter call gate.list_spot_accounts
mcporter auth gate-cex-ex
mcporter call gate-dex.list_balances
Post-install (all platforms)
- Restart the IDE / client (or new session) so MCP lists reload.
- API Key: https://www.gate.com/myaccount/profile/api-key/manage for local
Gate (main)trading. - gate-cex-ex: OAuth2 when the client prompts; OpenClaw:
mcporter auth gate-cex-ex. - gate-dex: https://web3.gate.com/ for wallet; complete OAuth if tools require it.
- Gate Verify (
gate-dex-sec): merged withdex; before signing ordex_tx_x402_fetch, calltx_checkin//v1/tx/checkinon this MCP withauthorization= walletmcp_token(tool argument, not copied HTTP headers) — gate-dex-walletreferences/tx-checkin.md. - gatepay-local-mcp: stdio Gate Pay x402; set
envplaceholders in the client config to real values only locally — see gate-pay-x402 (PLUGIN_WALLET_TOKEN,EVM_PRIVATE_KEY,SVM_PRIVATE_KEY, optionalPAYMENT_METHOD_PRIORITY). - gatepay-merchant-discovery: remote URL only (no secrets in installer); lists payable resources — confirm tool name (
discoveryResource) in the live tool list (gate-pay-x402). If connect fails, adjusttransportin JSON per your host (fragment usesstreamable-httplike other Gate HTTP MCPs).
Supersedes
This skill replaces: gate-mcp-cursor-installer, gate-mcp-claude-installer, gate-mcp-codex-installer, gate-mcp-openclaw-installer. Those directories may retain short redirect stubs for backwards compatibility.
