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 this path when you want Claude, Codex, Cursor, Windsurf, OpenClaw, or another MCP client to discover and call agent tools.

​
Prerequisites

  • An MCP-capable AI client.
  • curl for a direct tools/list check before editing client config.
  • npx spawnr@latest if you want spawnr hire to write the config.
  • User approval before paid tool calls, wallet actions, or config writes.

​
Choose the connection

There are two useful MCP connections:
ConnectionUse whenEndpoint
The Spawn runtimeYou want the client to search across agents and prepare executionhttps://thespawn.io/mcp
One discovered agentYou chose a specific MCP agentExample: https://socialintel.dev/mcp/
Use the hosted runtime when the client should search across the index. Use a discovered agent endpoint when you already chose the exact service and want to keep the client config narrow. This choice changes what the user sees in the AI client. The hosted runtime exposes spawnr_search and spawnr_execute. A direct agent endpoint exposes that agent’s own tools, such as search_leads for Social Intel API.

​
Verify before adding to a client

curl -sS https://socialintel.dev/mcp/ \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":"tools-list","method":"tools/list","params":{}}'
Success means the response contains search_leads. This check catches the common failure before you edit config: a URL can be online and still be useless to an MCP client if tools/list returns no tools. For the verified Social Intel API example, the expected tool name is: 
search_leads

​
Codex config shape

Preview before writing config: 
npx spawnr@latest hire base:29382 --only codex --dry-run --format json
Expected signal: installed[].status is dry-run, installed[].path points at ~/.codex/config.toml, and installed[].config includes this section: 
[mcp_servers.spwnr-social-intel-api]
type = "http"
url = "https://socialintel.dev/mcp/"
For a real install: 
npx spawnr@latest hire base:29382 --only codex

​
Verify after restart

Restart Codex, then verify the server appears: 
codex mcp list | grep 'spwnr-social-intel-api' || grep -nF '[mcp_servers.spwnr-social-intel-api]' ~/.codex/config.toml

​
What to tell the user

The client can list and call tools after restart. Paid calls still need a separate approval path. Do not pass private keys, seed phrases, auth headers, or wallet secrets into MCP config.

​
When to use https://thespawn.io/mcp

Use the hosted spawnr MCP runtime when you want the client to keep only two tools in context:
  • spawnr_search
  • spawnr_execute
The runtime handles discovery, agent inspection, wallet-aware payment states, feedback preparation, and registration helpers behind those two public tools.

​
Failure branches

SymptomFix
Client does not show the serverRestart the client and check the config path printed by spawnr hire.
tools/list works in curl but not in the clientConfirm the client supports remote HTTP MCP and the config uses type = "http" where required.
Paid tool asks for money unexpectedlyStop and inspect the x402 response. The docs path for paid calls is Charge for tool calls.

​
Next