Threat Hunting Bundle
get_threat_hunting_bundleScope a threat hunt with one call by retrieving a bundled dossier of threat details, similar threats, simulations, and infrastructure pivots for a given threat ID.
Instructions
Flagship one-call hunting dossier for a threat: threat detail + similar threats + simulations + infrastructure pivots, composed server-side. Best single tool to scope a hunt around one threat. Every section is bounded so the bundle fits in one response — raise simulation_limit / pivot_limit, or call get_infrastructure_pivots and get_threat directly, when you need the full lists.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shape | No | "v1" (default, unchanged nested envelope) | "canonical" (flat, stably-named, SMALLER — recommended for programmatic consumers) | "both". In canonical: technique ids are a top-level `ttps` array, sectors/regions use ONE spelling, and every array key is ALWAYS an array (never null, never an object). In v1, `similar_threats` and `infrastructure_pivots` are handler envelopes (objects) while `threat.similar_threats` is a flat array — if you are writing a parser, use canonical. | |
| threat_id | Yes | Threat ID (e.g. TL-2026-0042) | |
| pivot_limit | No | Infrastructure pivots to embed, 1-200 (default 25). One threat can carry 150+; get_infrastructure_pivots returns the full set. | |
| simulation_limit | No | Playbooks to embed, 1-20 (default 3). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| iocs | No | canonical: FLAT array. (In v1 this is an object keyed by category under threat.iocs.) | |
| ttps | No | Canonical MITRE technique ids, present in BOTH shapes. | |
| _shape | No | ||
| counts | No | canonical: a denominator for every array key. | |
| threat | No | ||
| regions | No | ||
| sectors | No | ||
| _envelope | No | Shape manifest — announces that shape="canonical" exists. | |
| canonical | No | Present only under shape="both". | |
| threat_id | No | ||
| simulations | No | ||
| ttp_details | No | ||
| similar_threats | No | v1: handler envelope {source_threat_id, count, similar[]} — an OBJECT, not an array. | |
| infrastructure_pivots | No | v1: handler envelope {threat_id, infrastructure_pivots[], coverage{}} — an OBJECT. |