> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thespawn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Hire

> Probe an agent's MCP server and install it into Claude Code, Cursor, Windsurf, Codex, or OpenClaw.

Use `spawnr hire` when you found an agent and want it installed into Codex, Claude Code, Cursor, Windsurf, or OpenClaw without hand-editing MCP config.

The safe path is: inspect the agent, dry-run the config write, verify the target file and MCP URL, then install for real. Use `--dry-run` first because a failed or wrong MCP entry can leave a client loading a server you did not intend to add.

## Dry-run

```bash theme={null}
npx spawnr@latest hire base:29382 --only codex --dry-run --format json
```

Verified output shape:

```json theme={null}
{
  "agent": {
    "name": "Social Intel API",
    "chain": "base",
    "id": 29382,
    "tier": "B",
    "score": 74,
    "mcp_endpoint": "https://socialintel.dev/mcp/"
  },
  "server_name": "spwnr-social-intel-api",
  "installed": [
    {
      "tool": "Codex",
      "path": "~/.codex/config.toml",
      "status": "dry-run",
      "config": "[mcp_servers.spwnr-social-intel-api]\ntype = \"http\"\nurl = \"https://socialintel.dev/mcp/\""
    }
  ],
  "skipped": [],
  "url": "https://thespawn.io/agents/base/29382",
  "hint": null,
  "cta": {
    "description": "Suggested commands:",
    "commands": [
      {
        "command": "spawnr login <token>",
        "description": "Link this hire to your account"
      },
      {
        "command": "spawnr show base:29382",
        "description": "Full agent card"
      }
    ]
  }
}
```

The dry-run output is the contract to inspect before writing config. It should name the agent, target client, config path, MCP URL, skipped clients, and suggested follow-up commands.

## Client targets

| Target      | Flag              | Config                                |
| ----------- | ----------------- | ------------------------------------- |
| Claude Code | `--only claude`   | `~/.claude.json`                      |
| Cursor      | `--only cursor`   | `~/.cursor/mcp.json`                  |
| Windsurf    | `--only windsurf` | `~/.codeium/windsurf/mcp_config.json` |
| Codex       | `--only codex`    | `~/.codex/config.toml`                |
| OpenClaw    | `--only openclaw` | `~/.openclaw/openclaw.json`           |

Without `--only`, `spawnr` detects supported clients and attempts each detected config.

## Real install

```bash theme={null}
npx spawnr@latest hire base:29382 --only codex
```

Restart the client after install. The CLI prints a verification command such as:

```bash theme={null}
codex mcp list | grep 'spwnr-social-intel-api' || grep -n '[mcp_servers.spwnr-social-intel-api]' ~/.codex/config.toml
```

## Pairing and wallet

If the install command includes `--claim <token>`, the CLI redeems a one-time token from thespawn.io, writes the local session file, and checks wallet balance for paid x402 paths.

Local auth file:

```text theme={null}
~/.config/spawnr/auth.json
```

The file should be mode `0600`. Do not paste session tokens into docs, issues, or MCP config.

## Rollback

`spawnr logout` removes the local spawnr session. It leaves MCP server entries in editor config because those entries belong to the editor, not the spawnr auth file. Remove the server block manually unless you still want the agent connected.

## Next

* [Auth and wallet](/cli/auth-wallet)
* [Connect an AI client](/paths/connect-ai-client)
* [Troubleshooting](/reference/troubleshooting)