Every install below connects to the same gateway,
https://api.arcade.dev/mcp/arcade. Sign-in happens in the
browser. The rows differ in how much of this plugin the client can load.
| Client | Tools | Skills | Subagent | Commands | Rule | Hooks | Install |
|---|---|---|---|---|---|---|---|
| Cursor IDE / Cloud Agents | ✅ | ✅ | ✅ | ✅¹ | ✅ | —² | guide |
| Cursor CLI | ✅ | ✅ | ✅ | ✅ | — | ✅³ | guide |
| Claude Code (CLI and desktop Code tab) | ✅ | ✅ | ✅ | ✅ | — | ✅ | guide |
| Claude Cowork | ✅ | ✅ | ✅ | ✅ | — | partial⁴ | guide |
| GitHub Copilot CLI | ✅ | ✅ | ✅ | — | — | ✅⁵ | guide |
| VS Code (Copilot sessions) | ✅ | ✅ | ✅ | — | — | ✅⁶ | guide |
| Codex / ChatGPT local runtime | ✅ | ✅ | — | — | — | —⁷ | guide |
| OpenCode | ✅ | — | — | — | — | — | guide |
| Claude Desktop | ✅ | ✅ | — | — | — | — | guide |
| Grok Bot⁸ | ✅ | ✅ | — | — | — | — | guide |
| Any MCP client | ✅ | — | — | — | — | — | guide |
Hooks add the routing rules at session start, to each prompt, and to
subagents. In the Hooks column, ✅ means the session-start hook runs, so the
full rules reach the main conversation. Partial means some hooks run but the
session-start text doesn't reach the main conversation. The files are
.claude-plugin/hooks.json (Claude Code),
clients/cursor/hooks/hooks.json (Cursor CLI), and
com.github.copilot/hooks/hooks.json (Copilot CLI and VS Code Copilot sessions).
Telemetry adapters are separate from routing. TELEMETRY_ENABLED is false
in this build, so manifests include no telemetry hooks and nothing is sent.
When enabled, wiring comes from plugin/hooks/hook-hosts.mjs:
| Client adapter | Telemetry events (when enabled) |
|---|---|
| Claude Code | UserPromptSubmit, PreToolUse on ^(?:mcp__plugin_arcade_arcade__|mcp__claude_ai_arcade__), MCP PostToolUse / PostToolUseFailure, built-in WebFetch / WebSearch / listed Bash CLIs, Arcade operator SubagentStop |
| Copilot CLI | UserPromptSubmit, MCP PostToolUse / PostToolUseFailure (<server>-<tool>), Arcade operator SubagentStop with subagent_session (no PreToolUse, no turn, no built-in tools) |
Session start sends no telemetry event. No other adapter in this package sends telemetry. See what's sent and its limits.
¹ The Cursor IDE (3.21.18) lists the commands on the plugin page but not in
the / menu. Other plugins' commands don't appear there either.
² The IDE (3.21.18) and Cloud Agents don't run plugin hooks, so the
always-apply rule carries the full session rules. Cloud Agents run repo, team,
and enterprise hooks only; they get the rule and the skill.
³ Session hook only. The CLI runs the session hook (full rules) but doesn't
load the always-apply rule.
⁴ Cowork runs the prompt and subagent hooks but doesn't add the session-start
text, so its main conversation gets the short reminder and the skill, not the
full rules.
⁵ Copilot CLI drops the output of routing prompt hooks from config files,
so the main conversation gets session and subagent hooks only. Telemetry still
hooks UserPromptSubmit when enabled; reminder_sent is always false there.
⁶ VS Code Copilot sessions use the shared Copilot hook implementation: this
plugin supplies SessionStart and SubagentStart routing guidance through
com.github.copilot/hooks/hooks.json. Support depends on the selected harness
and VS Code version; see the VS Code guide for sources and
validation limits.
⁷ Blocked upstream; see codex.md.
⁸ Skills and the MCP connector only. The connector namespace is not always
named arcade. See grok-bot.md.
Skills are try-arcade and scale-arcade. The subagent is
arcade-operator. In Cursor the commands are /arcade-apps,
/arcade-connect, and /arcade-status. In Claude Code they appear as
/arcade:arcade-apps, /arcade:arcade-connect, and
/arcade:arcade-status.
Only skills and MCP servers are portable component types in Agent Plugins 1.0. Commands, the operator, hooks, and the Cursor rule are client-specific, which is why those columns thin out.
Files a client needs at its own path are generated from shared sources (see
ARCHITECTURE.md). In this repository those files live
under plugin/. The marketplace files stay at the repository root and point
at that directory. Paths in the table are relative to the plugin directory,
except the marketplace and local-clone rows.
| Piece | File | Read by |
|---|---|---|
| Skills | skills/ |
every client with skills |
| MCP server | mcp.json |
VS Code, Copilot CLI, Codex |
| MCP server | inline in .cursor-plugin/plugin.json / .claude-plugin/plugin.json |
Cursor / Claude Code |
| Operator | agents/arcade-operator.agent.md |
Cursor, Claude Code, Cowork |
| Operator (generated copy) | com.github.copilot/agents/arcade-operator.agent.md |
Copilot CLI, VS Code |
| Commands | commands/arcade-*.md |
Cursor, Claude Code, Cowork |
| Rule | clients/cursor/rules/arcade.mdc |
Cursor IDE / Cloud Agents |
| Marketplace | .claude-plugin/marketplace.json (source ./plugin) |
Claude Desktop, Cowork, Claude Code, Codex, Copilot CLI, VS Code Install Plugin From Source |
| Marketplace | .cursor-plugin/marketplace.json (source plugin) |
Cursor team marketplace import |
| Local clone | .cursor-plugin/plugin.json and .cursor-plugin/hooks.json at the repo root, pointing into plugin/ |
Cursor local loader |
| Codex listing | plugin.json → extensions.com.openai.interface |
Codex |
Claude Desktop installs this repo as a plugin marketplace (see
claude-desktop.md): add
ArcadeAI/arcade-plugin, then install arcade@arcade. Chat gets tools
and skills. A custom connector with the gateway URL is the tools-only
fallback. There is no .mcpb Desktop Extension.
A one-click MCP link (or pasting the gateway URL) connects tools only. Skills
and the operator need the plugin install. Cursor and VS Code links are in
cursor.md and vscode.md; any other
MCP client can use https://api.arcade.dev/mcp/arcade.