$npx -y skills add gate/gate-skills --skill gate-mcp-installerOne-click installer for Gate MCP servers and gate-skills on Cursor, Claude Code, Codex, or OpenClaw/mcporter. When gate-dex is installed, also wires Gate Verify HTTP MCP as gate-dex-sec for MCP tool tx_checkin before wallet signing per gate-dex-wallet. Triggers on 'install Gate M
| 1 | # Gate MCP Installer (unified: Cursor / Claude Code / Codex / OpenClaw) |
| 2 | |
| 3 | ## General Rules |
| 4 | |
| 5 | ⚠️ STOP — You MUST read and strictly follow the shared runtime rules before proceeding. |
| 6 | Do NOT select or call any tool until all rules are read. These rules have the highest priority. |
| 7 | → Read [gate-runtime-rules.md](https://github.com/gate/gate-skills/blob/master/skills/gate-runtime-rules.md) |
| 8 | - **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. |
| 9 | |
| 10 | --- |
| 11 | |
| 12 | ## MCP Dependencies |
| 13 | |
| 14 | ### Required MCP Servers (after install) |
| 15 | |
| 16 | | MCP Server | Status | |
| 17 | |------------|--------| |
| 18 | | Gate (main) | ✅ For local CEX (stdio) | |
| 19 | | gate-cex-pub | ✅ Remote public | |
| 20 | | gate-cex-ex | ✅ Remote private (OAuth2) | |
| 21 | | gate-dex | ✅ DEX | |
| 22 | | gate-info | ✅ Info | |
| 23 | | gate-news | ✅ News | |
| 24 | | gatepay-local-mcp | ➕ Optional (Gate Pay x402 stdio; `--mcp gatepay-local`) | |
| 25 | | gatepay-merchant-discovery | ➕ Optional (HTTP merchant catalog / `discoveryResource`; `--mcp gatepay-discovery`) | |
| 26 | | 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** | |
| 27 | |
| 28 | ### Installation Check |
| 29 | |
| 30 | - Run this skill’s installer script, or guide the user to run it. |
| 31 | - If multiple dev environments exist on one machine (e.g. Cursor + Claude Code), the script requires `--platform`. |
| 32 | |
| 33 | --- |
| 34 | |
| 35 | ## MCP Mode |
| 36 | |
| 37 | **Read and strictly follow** [`references/mcp.md`](./references/mcp.md), then execute this installer workflow. |
| 38 | |
| 39 | - `SKILL.md` — product scope, triggers, and user-facing guidance. |
| 40 | - `references/mcp.md` — execution SOP per platform, verification, and safety rules. |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## Platform matrix |
| 45 | |
| 46 | | Platform | MCP / transport config | Skills directory | |
| 47 | |----------|-------------------------|------------------| |
| 48 | | **Cursor** | `~/.cursor/mcp.json` (Windows: `%APPDATA%\Cursor\mcp.json`) | `~/.cursor/skills/` | |
| 49 | | **Claude Code** | `~/.claude.json` (`mcpServers`) | `~/.claude/skills/` | |
| 50 | | **Codex** | `~/.codex/config.toml` (`[mcp_servers.*]`) | `~/.codex/skills/` | |
| 51 | | **OpenClaw** | `mcporter` CLI (no single JSON file) | `~/.openclaw/skills/` (default) | |
| 52 | |
| 53 | --- |
| 54 | |
| 55 | ## CEX MCP modes |
| 56 | |
| 57 | See [gate-mcp](https://github.com/gate/gate-mcp): |
| 58 | |
| 59 | | Mode | What | Auth | |
| 60 | |------|------|------| |
| 61 | | **Local CEX** | stdio `npx -y gate-mcp` (or global `gate-mcp`) | Optional `GATE_API_KEY` / `GATE_API_SECRET` | |
| 62 | | **Remote public** | `https://api.gatemcp.ai/mcp` | None | |
| 63 | | **Remote exchange** | `https://api.gatemcp.ai/mcp/exchange` | Gate OAuth2 in client / `mcporter auth gate-cex-ex` | |
| 64 | |
| 65 | **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. |
| 66 | |
| 67 | --- |
| 68 | |
| 69 | ## Tx check-in (Gate Verify / GV) |
| 70 | |
| 71 | Gate Verify is a **second HTTP MCP** on the same host as remote DEX, used only for signing check-in: |
| 72 | |
| 73 | | Role | Install surface | |
| 74 | |------|------------------| |
| 75 | | Wallet / DEX tools | **`gate-dex`** → `https://api.gatemcp.ai/mcp/dex` (headers per fragment) | |
| 76 | | Gate Verify | **`gate-dex-sec`** → `https://api.gatemcp.ai/mcp/dex/sec` (URL-only / `streamable-http`; **no** wallet HTTP headers on this entry) | |
| 77 | |
| 78 | 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`](https://github.com/gate/gate-skills/blob/master/skills/gate-dex-wallet/references/tx-checkin.md). Staged swap specifics: **gate-dex-trade** skill. |
| 79 | |
| 80 | --- |
| 81 | |
| 82 | ## Resources |
| 83 | |
| 84 | | Type | Name | Notes | |
| 85 | |------|------|--------| |
| 86 | | MCP | **Gate** (`main`) | stdio; prefer global `gate-mcp` when installed | |
| 87 | | MCP | **gate-cex-pub** | HTTP remote public | |
| 88 | | MCP | **gate-cex-ex** | HTTP remote private + OAuth2 | |
| 89 | | MCP | **gate-dex** | HTTP + headers | |
| 90 | | MCP | **gate-dex-sec** | HTTP `https://api.gatemcp.ai/mcp/dex/sec`; **`tx_checkin`** before signing — bundled with **`dex`** install | |
| 91 | | MCP | **gate-info** / **gate-news** | HTTP | |
| 92 | | MCP | **gatepay-local-mcp** | stdio `npx -y gatepay-local-mcp`; wallet **`env`** per **gate-pay-x402** | |
| 93 | | MCP | **gatepay-merchant-discovery** | HTTP `http://dev.halftrust.xyz/pay-mcp-server/mcp`; catalog only (**gate-pay-x402**) | |
| 94 | | Skill | **gate-dex-wallet** | R |