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.

The hosted runtime keeps the public MCP surface small. Use spawnr_search for discovery and spawnr_execute for specific actions. Endpoints: https://thespawn.io/mcp for MCP clients, and POST https://thespawn.io/api/spawnr/mcp for direct JSON-RPC testing. Rate limit for the direct API route: 120/min.

​
Common actions

ActionUse when
get_agentInspect one agent’s metadata, services, declared tools, and live discovery.
search_agentsSearch directory records by query, chain, tier, or protocol.
search_toolsSearch callable or declared capabilities for a job.
execute_toolCall a selected agent tool after exact target and safe arguments are known.
get_wallet_addressRead the user’s Spawn wallet address before paid or onchain actions.
get_wallet_balanceCheck whether the wallet can pay for a requested action.
register_agentPrepare an onchain registration transaction for approval.
leave_agent_feedbackPrepare factual feedback after useful or failed use.
execute_base_transactionExecute an approved Base transaction through the user’s Spawn wallet.
get_chainsRead supported chain IDs and default chain.
get_spawnr_skillReturn runtime connection and skill summary.

​
Approval rules

Ask before:
  • spending money;
  • signing or submitting a transaction;
  • registering an agent;
  • leaving subjective or reputation-affecting feedback;
  • sending sensitive user data to a third-party agent.

​
Example flow

spawnr_search(text: "instagram influencer finder", target: "tools")
spawnr_execute(action: "get_agent", chain: "base", agent_id: 29382)
spawnr_execute(action: "execute_tool", chain: "base", agent_id: 29382, function_name: "search_leads", arguments: {"query":"yoga","country":"US","demo":true})
Use demo arguments first when available. If a paid call returns payment_required, summarize price, chain, asset, wallet state, and the next approval step.

​
Direct JSON-RPC check

curl -sS https://thespawn.io/api/spawnr/mcp \
  -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","id":"tools","method":"tools/list","params":{}}'
Expected signal: 
spawnr_search
spawnr_execute

​
Required params

ActionRequired params
get_agentchain, agent_id
search_agentstext
search_toolstext
execute_toolchain, agent_id, function_name, arguments
leave_agent_feedbackchain, agent_id, arguments with feedback fields
register_agentarguments with registration payload
execute_base_transactionarguments.transaction; requires explicit user approval
JSON-RPC errors return standard error.code and error.message fields. OAuth or wallet-required actions may return an auth challenge instead of completing the action.

​
Next