Run a WhisperGraph Catalog Recipe
run_recipeRun curated catalog recipes to answer infrastructure and threat questions without writing Cypher.
Instructions
Run a named whisper.security catalog recipe by its slug (see list_recipes for the full set). This is the highest-leverage tool for infrastructure & threat questions: instead of hand-writing Cypher, run the curated recipe.
Arguments:
recipe (string, required) - the recipe slug, e.g. "assess", "identify", "indicator-enrichment", "infrastructure-mapping", "attack-path", "subdomain-takeover", "typosquat", "bgp-hijack-exposure".
inputs (object, optional) - the recipe's inputs keyed by name (see the recipe's inputs[] in list_recipes). Examples: {"v":"8.8.8.8"} for assess/identify; {"value":"github.com"} for indicator-enrichment / infrastructure-mapping; {"domain":"paypal.com"} for typosquat; {"country":"BR"} for anycast-dns-root-sovereignty; {"value":"paypal.com","other":"paypa1.com"} for attack-path. Omit to use the recipe's built-in example.
params (object, optional) - flow tuning params, e.g. {"level":"deep"} for attack-surface / infrastructure-mapping / attack-path, {"depth":3} for blast-radius, {"instanceType":"Global"} for anycast-dns-root-sovereignty.
Behaviour:
directrecipes run keyless and return { success, recipe, mode:"direct", columns[], rows[], statistics }.flowrecipes need an API key (WHISPER_API_KEY over stdio, or the relayed X-API-Key / Authorization header over HTTP) and return { success, recipe, mode:"flow", steps[], totalLatencyMs } where each step carries { id, title, columns, rows }.On an unknown slug or a keyless call to a keyed flow, returns { success:false, error, suggestion } - never throws.
Prefer run_recipe over hand-written Cypher whenever a recipe fits the question; fall back to the query tool for bespoke traversals.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inputs | No | The recipe's inputs keyed by name, e.g. {"v":"8.8.8.8"} or {"value":"github.com"}. | |
| params | No | Optional flow tuning params, e.g. {"level":"deep"} or {"depth":3}. | |
| recipe | Yes | Recipe slug from list_recipes, e.g. "assess", "indicator-enrichment", "attack-path". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | ||
| rows | No | ||
| error | No | ||
| steps | No | ||
| recipe | No | ||
| columns | No | ||
| success | Yes | ||
| statistics | No | ||
| suggestion | No | ||
| totalLatencyMs | No |