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

# Reports

> Pull usage and activity reports for your organization.

Reports surface aggregated activity metrics for your workspace — how many calls were viewed, coaching sessions held, comments left, snippets created, AI insights ran, and Super Agent queries made by each user over a given period. Use them to monitor adoption, build internal dashboards, or feed product analytics.

## Tools

### get\_usage\_report

<Note>Scope: `mcp:read`. Requires an **org-level API key** (OAuth tokens and user-level API keys are not supported).</Note>

Get a usage report showing per-user activity metrics for a date range. Returns one entry per user with their team, coaching sessions, calls viewed, comments left, snippets created, AI insights ran, and Super Agent usage (web and Slack).

<ParamField query="start_date" type="string" required>
  Start date for the report period in `YYYY-MM-DD` format (inclusive).
</ParamField>

<ParamField query="end_date" type="string" required>
  End date for the report period in `YYYY-MM-DD` format (inclusive). Must be on or after `start_date`.
</ParamField>

<ParamField query="user_uuids" type="array">
  List of user UUIDs to filter the report. Leave empty to include all users in the org.
</ParamField>

<ParamField query="team_uuids" type="array">
  List of team UUIDs to filter the report. Leave empty to include all teams.
</ParamField>

**Returns:** A Markdown summary with one section per user, including name, email, team, and activity metrics for the period. Returns an empty-state message when no usage data matches the filters.

**Example prompt:** *"Pull a usage report for the SMB team for last month — I want to see who's actually using coaching and Super Agent."*