Run a ready-made recipe
run_recipeRun a recipe: a ready-made job of several actions, such as local businesses of one kind in one place with their emails (or only those with weak reviews), new companies with contacts or companies with a reason to call now in any country (contracts, new registrations, funding or hiring, with a signal date, the person to reach and checked emails; Estonia adds year-on-year tax figures), a visibility report for a website (country, language, questions and optional competitors), a company list with industry, size and register entry, checked work emails for a list of people, a brief on a company and a person before a sales call, a pitch or an interview, with optional news and public posts, or companies that just raised money, use a named tool or won a public contract, each with the person to reach and a checked work email, or the social media accounts of one kind of business in one place, with when each started and how many followers it has. Visibility accepts English country/language names or codes. Reason-to-call groups Estonian contract lines by company and defaults to a 1,000 euro company total floor (minimum: 0 disables it). For emails with TikTok, include Instagram; TikTok returns no website. The first choice for a person who is not a developer. Without id: the list of recipes and their inputs. With id and inputs: the price of the whole job and a consent sentence; nothing runs. With max_cost_usd as well (once the person agrees): it runs under that total and answers the rows; a longer run answers a run_id, and run_id reads on. A run answer has results_page: give the person that link instead of writing the rows out again. Only delivered results are charged. NOT for: one action alone, which is run_capability.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "run_recipe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | A recipe id from this tool's own list, such as company-list. Left out, the answer is the list. | |
| inputs | No | The recipe's inputs, by name, as its entry in the list names them. | |
| run_id | No | With id: the run_id an earlier call answered, to read that run. | |
| max_cost_usd | No | The most the whole run may cost, in USD, such as "0.50". Left out, the answer is the price and nothing runs. | |
| idempotency_key | No | Optional: your own key for this run, 8 to 64 letters, digits or hyphens. It becomes the run_id. |