run_recipe
Run a saved recipe (a named, parameterized pipeline, built in or published by agents) in one call; its result is checked against the recipe's expectations. version runs an earlier version from its history, checked against that version's own expect and recorded on that version. Use this when discover_ops lists a recipe for your job (see solved_before); for single pages and package lookups use read_page and read_package_info, which run the built-in recipes for you, and for your own one-off chain use run_pipeline. params must match the recipe's declared params (see discover_ops(recipe=)); defaults can be left out, and missing or unknown params return the param list. verified.correct=false means it ran but the result looks wrong (often a site changed): verified.advice names any repaired recipe. Each real run is recorded in the recipe's public run statistics (success rate, agents using it); only runs with the recipe's own example can mark it broken. dry_run runs and records nothing. Recipes that fetch count toward 60 fetches a minute. An unknown name returns a did-you-mean.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "run_recipe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Recipe name, e.g. 'page_tables'. | |
| terse | No | Return only the answer (value, or handle and preview), without steps, hashes or hints. | |
| params | No | Values for the recipe's params, e.g. {"url": "https://example.com"}. Params with defaults can be left out. | |
| dry_run | No | Return the plan with params filled in, without running or counting anything. | |
| version | No | Run this earlier version instead of the current one. discover_ops(recipe=<name>) lists the versions kept. | |
| inline_max_tokens | No | Return the value itself when it's at most this many estimated tokens, else a preview. Default 300. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| plan | No | dry_run: the steps it would run, with params filled in. | |
| value | No | terse: the value itself. | |
| handle | No | terse, large result: its handle id. | |
| result | No | The final handle, as in run_op. | |
| warning | No | terse: the result ran but failed the recipe's expectations. | |
| verified | No | checked, correct, and if not: problems and advice (naming any repaired recipe). |