Plugin

The AgentRouter plugin adds two things to an agent host:

• the hosted MCP server https://mcp.agentrouter.to/ (Streamable HTTP, OAuth 2.1 with PKCE and dynamic client registration), which provides find_tools, describe_tool, invoke_tool and the run, wallet, feedback and dispute tools;
• the AgentRouter skill, which teaches the agent when and how to use them. It is generated from the same canonical SKILL.md served at agentrouter.to/SKILL.md.

Installing adds configuration only; nothing is charged until the agent invokes a paid tool. New providers and tools appear through find_tools without a plugin update.

Claude Code

claude plugin marketplace add <path-or-git-url-of-marketplace>
claude plugin install agentrouter@agentrouter

Or interactively: /plugin marketplace add …, then /plugin install agentrouter@agentrouter.

Sign in: run /mcp, choose agentrouter → Authenticate, and sign in to AgentRouter in the browser.

Update: claude plugin update agentrouter@agentrouter, then restart Claude Code.

Uninstall: claude plugin uninstall agentrouter@agentrouter. Your other MCP servers and skills are left alone.

Codex

codex plugin marketplace add <path-or-git-url-of-marketplace>
codex plugin add agentrouter@agentrouter

Sign in: Codex starts OAuth the first time it uses an AgentRouter tool (dynamic client registration; no client secret).

Update: for a Git marketplace run codex plugin marketplace upgrade agentrouter, then codex plugin add agentrouter@agentrouter. A local marketplace is read in place, so only the second command is needed.

Uninstall: codex plugin remove agentrouter@agentrouter.

Cursor

Cursor installs plugins from its marketplace after review; it does not document installing an unpublished plugin from a local folder. Until the listing is approved:

1. Settings → MCP → add a server with URL https://mcp.agentrouter.to/ and sign in when prompted.
2. Copy the skills/agentrouter/ folder from the plugin into your user skills directory.

Once listed: install, update and remove from Customize → Plugins.

Other MCP hosts

Any host that supports remote MCP servers with OAuth can connect to https://mcp.agentrouter.to/ directly; see MCP.

What signing in allows

Sign in through your client to connect it to your AgentRouter wallet. Paid calls follow the account’s budgets.

Revoke and uninstall are separate

• Revoke a host at Settings → API → Connections. Its tokens stop working immediately.
• Uninstalling the plugin does not revoke access, and revoking does not uninstall the plugin. Do both to remove AgentRouter completely.

Using the CLI alongside

The plugin does not install the CLI. If the agent also needs to write results to files or run scripts, install the CLI separately: npx @agentrouter/agentrouter connect. MCP and the CLI sign in separately; whoami (MCP) and agentrouter whoami show which account and wallet each uses. If MCP tools are connected, the skill tells the agent to use them rather than installing the CLI for the same task.

Versions

Verified hosts: Claude Code 2.1.119 and Codex CLI 0.166.0-alpha.5.1 (install, update, uninstall in isolated profiles). Cursor marketplace review has not started.