get_briefing
Get the synthesized competitive briefing: what changed, what it means, and what actions to take. Returns analyzed intelligence with hub digest and deep-dive options.
Instructions
Get the project's Strategic Briefing — the synthesized, prioritized competitive read across all dimensions: what changed, what it means, and what to do about it. This is the ANALYZED, as-of intelligence output, NOT raw monitoring — for live per-dimension data use the get__dashboard tools (e.g. get_pricing_dashboard), and for the monitored-competitor roster use list_competitors. Defaults to the executive 'hub' section — a cheap digest (headline, top moves, and per-dimension verdicts that each name the deeper 'deep-' section to open next) that answers most questions in a single call; this is the intended hub→deep drill-down flow, so request additional 'sections' only when a question actually needs them. Always branch on meta.availability before reading: 'ready' (a finished briefing is returned), 'ready-refreshing' (a finished briefing is returned AND a newer edition is generating right now), 'preparing' (the first edition is still building, so item is null), 'none' (no briefing exists yet). Only the latest FINISHED edition is ever returned; briefings regenerate automatically per project roughly every 30 days. meta, coverage, and dimensionHealth are returned regardless of which sections you request — read 'coverage' (methodology + honest-degradation caveats) before quoting any number, and check 'dimensionHealth' to see which deep- analyses this edition actually contains (a skipped dimension reads as 'absent', never as an empty finding). A missing/inaccessible project returns 404 project_not_found; the briefing lifecycle itself never 404s. Read-only. Returns a JSON briefing envelope { item (nullable), meta: { runId, briefingDate, availability }, coverage (nullable), dimensionHealth }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sections | No | Which briefing sections to return. Default ['hub'] — the executive digest that orients you and names the deeper sections by their verdicts; this alone answers most questions in one cheap call. Add sections only when the question needs them: 'actions' (the prioritized to-do list), 'competitors' (the rival-by-rival read), any 'deep-<dimension>' for a full dimension dive (13 available, e.g. 'deep-pricing', 'deep-ai-visibility' — the hub's verdicts tell you which one to open, so you needn't guess), or 'all' for the entire briefing (large — full-read/export only). | |
| projectId | Yes | Project ID (from list_projects) | |
| includeCharts | No | Default false — sections return prose plus a compact data-summary of each chart. Set true to include full chart series (time-series points, bar values); larger payload — use only when you need the underlying numbers, e.g. to reason over a trend. |