Skip to main content

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.

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

TargetFlagConfig
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.

​
Next