Agent setup

Set up your Agent with ToolRouter

One MCP layer for all your tool calls

Connect your client

API key needed

Generate an API key, then replace tr_....

Run this once where Claude Code is authenticated. It installs the MCP adapter with npx.

claude mcp add --scope user \
  -e TOOLROUTER_API_URL=https://toolrouter.world \
  -e TOOLROUTER_API_KEY=tr_... \
  -- toolrouter npx -y @worldcoin/toolrouter

Tool categories

Agents should think in generic categories first. ToolRouter recommends a concrete endpoint for each category, then records the actual provider, AgentKit path, x402 fallback, and spend cap in the trace.

searchRecommended: Exa Search for fresh web results.

browser useRecommended: Browserbase Session for interactive browser workflows.

toolrouter_list_categoriesAsk ToolRouter which categories and recommended endpoints are available.

toolrouter_call_endpointCall the selected endpoint explicitly when you already know the endpoint_id.

First query

After the MCP server is loaded, this verifies discovery and execution by making the agent inspect ToolRouter categories, call a concrete endpoint, and return the request id from the trace.

Use ToolRouter through MCP.

First list the available ToolRouter tool categories. Then use the recommended search endpoint to find the top sushi places in San Francisco.

Summarize the best 5 options and include the ToolRouter request id.