{"uid":"cap_ECPfzdsCoOdPa9VwSGUPA","slug":"toll402-universal-tool-router-3d72407b","name":"Toll402 Universal Tool Router","description":"One endpoint for everything (OpenRouter-style): describe what you need and pass the input; Toll402 picks the best tool from the whole catalog (built-in, community-forged, external x402 services) and runs it. Tools priced above maxPriceUsd are returned as a match instead of executed.","url":"https://toll402.dev/v1/do","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["need","input"],"properties":{"need":{"type":"string","maxLength":500,"minLength":3,"description":"What you need, in plain language"},"tool":{"type":"string","description":"Force a specific tool id (skip routing)"},"input":{"type":"object","description":"Input for the chosen tool (must match its schema)","additionalProperties":true},"maxPriceUsd":{"type":"number","default":0.01,"maximum":1,"minimum":0,"description":"Do not execute tools priced above this; return the match instead"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ms":{"type":"integer"},"ok":{"type":"boolean"},"tool":{"type":"string"},"result":{"type":"object","properties":{"tool":{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"string"}}},"result":{"type":"object","properties":{"converted":{"type":"integer"}}},"executed":{"type":"boolean"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4nBKE_PsVp6e9vtWZzCtL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Routes a plain-language request to the best available tool from the full Toll402 catalog and executes it, returning the result or the matched tool if it exceeds the price ceiling.","exampleAgentPrompt":"Can you handle this for me using Toll402's universal router — I need the current exchange rate between USD and EUR, keep the max price under $0.05, and let the system pick the best tool for it automatically?","exampleUseCases":[{"title":"Hands-off task delegation by agents","prompt":"I need you to fetch the latest top Hacker News stories — use Toll402's do endpoint to figure out the right tool automatically, my need is 'top Hacker News stories', and don't spend more than $0.02."},{"title":"Dynamic tool discovery with price cap","prompt":"Use Toll402's router to satisfy this need: 'summarize the article at https://example.com/article in bullet points' — but if the tool costs more than $0.01, just tell me which tool it would have used instead of running it."},{"title":"Arbitrary task routing for automation pipelines","prompt":"I'm building an automation and I want to look up the IP geolocation for 8.8.8.8 — send it to Toll402's universal do endpoint with the need 'IP geolocation for 8.8.8.8' and a max price of $0.05, let it route to the right tool."}],"resultDescription":"Returns either the execution output of the best-matched tool (structured result matching that tool's output schema), or if the matched tool's price exceeds maxPriceUsd, returns metadata about the matched tool instead of executing it. The response includes which tool was selected and its output or match details.","failureModes":["No tool found matching the described need — returns an error or empty match","Input object does not match the selected tool's schema — returns validation error","Forced tool id via 'tool' field does not exist — returns not-found error","All matching tools exceed maxPriceUsd and none are executed — returns tool match metadata only","Network or execution failure in the underlying tool — propagates tool-specific error","Need description too vague for confident routing — may select suboptimal tool","Tool execution times out — returns timeout error"],"whenToPreferThis":"Choose this endpoint when you want a single, unified entry point to the entire Toll402 catalog without needing to know which specific tool to call. Ideal for AI agents that receive open-ended user requests and want dynamic routing rather than hard-coding individual tool endpoints. Prefer this over individual Toll402 endpoints when the task type isn't known in advance, when you want price-capped execution with graceful fallback to tool discovery, or when building flexible pipelines that should adapt to catalog changes automatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:56:58.649Z","isFirstParty":false}