# Set up AgentMuxer

Connect once. Copy one block. Paste the one-line setup into your coding agent or use a client recipe, then sign in. Sign-in is required for free and paid MCP use.

Availability note (2026-09-03): live: https://mcp.agentmuxer.com/mcp serves production (bound 2026-09-01; public sign-up is open).

## Installer

Recommended for Codex, Claude Code, and OpenCode with a local shell. Prefer it over a native MCP-add command: the installer also adds AgentMuxer usage guidance and verified removal. Use a manual recipe only when npm is unavailable or you prefer manual setup.

```sh
npx -y @agentmuxer/cli@latest install
```

## Codex

Run both commands; the second opens sign-in.

```sh
codex mcp add agentmuxer --url https://mcp.agentmuxer.com/mcp
codex mcp login agentmuxer
```

## Claude Code

Run both commands; the second opens sign-in.

```sh
claude mcp add agentmuxer --transport http https://mcp.agentmuxer.com/mcp
claude mcp login agentmuxer
```

## Connector

Add a custom connector in the host settings and paste the endpoint; the host runs the OAuth flow.

```text
https://mcp.agentmuxer.com/mcp
```

## Cursor

Save as .cursor/mcp.json; Cursor prompts sign-in on first connect.

```json
{
  "mcpServers": {
    "agentmuxer": { "url": "https://mcp.agentmuxer.com/mcp" }
  }
}
```

## VS Code

Save as .vscode/mcp.json; VS Code prompts sign-in on first connect.

```json
{
  "servers": {
    "agentmuxer": { "type": "http", "url": "https://mcp.agentmuxer.com/mcp" }
  }
}
```

## One-paste agent prompt

Paste into your coding agent. It sets AgentMuxer up and asks you only to approve sign-in and, depending on the host, to run one command that keeps the same conversation.

```text
Set up AgentMuxer from https://agentmuxer.com/SKILL.md
```

## Try AgentMuxer

Follow the steps your agent relays, in order: they keep this conversation and include approving AgentMuxer sign-in. Then paste this prompt. After a terminal setup, start your coding agent and paste it there. For connector hosts, start a new conversation.

> Use AgentMuxer to find tools that could help with this project. Recommend one, explain what it does and its price, and don't execute a paid call.

## Exposed tools

1. `search_offerings` - Find API operations when you do not know which one to use.
2. `inspect_offering` - Read request documentation and current pricing when inputs are unclear.
3. `call_offering` - Call provider and path directly within a maximum charge ($1.00 unless set).
4. `get_invocation` - Read an invocation by ID or original key without calling the provider again.
5. `report_outcome` - Optionally report how useful the result was.

## Owner handoff

- Sign in as the account owner for free and paid MCP use.
- Add credits as needed before paid calls.
- Set a spending limit for each agent (recommended; without one, an agent can spend up to the available balance).

Never shared with agents or providers: account credentials; payment instruments; provider secrets; unrelated MCP or application traffic.

## For agents

- llms.txt: https://agentmuxer.com/llms.txt
- SKILL.md: https://agentmuxer.com/SKILL.md
- setup.md: https://agentmuxer.com/setup.md
- http.md: https://agentmuxer.com/http.md