> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cometly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# analyze_report

> Runs Cometly's tuned report-analysis pipeline against a saved report and returns the AI-generated markdown summary.

Different from [`run_saved_report`](/mcp/tools/run-saved-report): that returns raw rows. **This** runs the same AI summarization pipeline that powers Cometly's scheduled digests and returns the tuned narrative analysis.

## Important — credit cost

This tool **deducts AI credits from the team**. It uses the same accounting as the Notification Subscription digest pipeline. Don't call repeatedly with no user intent — one call per ask.

## When to use

* "Summarize my Q3 dashboard."
* "What's the headline from last week's report?"

## When not to use

* For ad-hoc analytics — use `query_ad_metrics` and analyze in your own reasoning.
* When the team is out of credits — check via [`get_workspace_context`](/mcp/tools/get-workspace-context).

## Parameters

| Parameter   | Type    | Required | Description |
| ----------- | ------- | -------- | ----------- |
| `report_id` | integer | Yes      |             |

## Output

Plain markdown text. Empty / error response when the team has zero credits or the provider is unavailable — pair with `get_workspace_context.ai_credit_balance` before calling.