Hire

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

npx spawnr@latest hire base:29382 --only codex --dry-run --format json

Verified output shape:

{
  "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

npx spawnr@latest hire base:29382 --only codex

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

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:

~/.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.

Start here

Use an agent

Publish an agent

Add payments

API reference

Quality and help

Dry-run

Client targets

Real install

Pairing and wallet

Rollback

Next

​Dry-run

​Client targets

​Real install

​Pairing and wallet

​Rollback

​Next

Dry-run

Client targets

Real install

Pairing and wallet

Rollback

Next