> To find and run AgentRouter tools, connect to https://mcp.agentrouter.to/. To search this documentation, use https://docs.agentrouter.to/_mcp/server. Append .md to a page URL for Markdown. For the documentation index, see https://docs.agentrouter.to/llms.txt.

# 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](https://www.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.

> **Note**
>
> The plugin is not yet listed in public marketplaces. Until it is, install it from the AgentRouter marketplace archive or repository you were given (the directory that contains `.claude-plugin/`, `.cursor-plugin/` and `.agents/`).

## Claude Code

```bash
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

```bash
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](/integrations/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](https://www.agentrouter.to/settings/api). 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](/integrations/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

| Component              | Version                                              |
| ---------------------- | ---------------------------------------------------- |
| Plugin and skill       | 1.1.0                                                |
| Minimum CLI (optional) | 0.2.0                                                |
| MCP server             | 1.0.0 (hosted; updates do not need a plugin release) |

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.