route_task
Give a task in plain language and get the SINGLE BEST live tool to do it, ready to call: the chosen tool's verdict + reliability score, its input schema and a known-good recipe, call hints (timeout/retry), the actual connection endpoint to reach it (MCP endpoint URL or package to launch — no MCP-registry lookup needed), and whether it is FREE or PAID with the exact price and precisely how to pay (x402/USDC tools are auto-payable — pay per call with no signup; others say what's needed), PLUS a ranked fallback chain to try if it fails. It also returns bestFree (top free option) and bestValue (best price-to-quality), and steers to best value. Pass freeOnly to get only free tools, or requireAutomatable to only get tools an agent can pay for by itself. One call replaces discover_tools + check_tool_reliability + prepare_tool_call + find_alternatives. Call this at the start of a task when you don't already know which tool to use — it picks the best one and tells you exactly how to call it.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task | Yes | Plain-language description of what you want to do (e.g. 'send a slack message'). | |
| view | No | 'full' (default, all fields) or 'compact' (lean, far fewer tokens — just what you need to call + fail over + pay + report). | |
| category | No | Optional capability category to narrow the choice. | |
| freeOnly | No | Only consider FREE tools (many callers want this). | |
| fallbacks | No | How many backup tools to return (default 5, max 10). | |
| maxPricePerCall | No | Cap per-call price in USD; paid tools above this are excluded. | |
| requireAutomatable | No | Only tools an agent can pay for autonomously (free or x402/USDC) — for unattended agents that can't do a human card/OAuth signup. |