Get consumption (admin)
Coming soon
The v2 MCP API is in preview and not yet generally available. These pages document its tools and request/response shapes; live data access is limited to enrolled organizations until v2 is released.
Read consumption (credits + tool calls) for the calling org. Without user_id: org-wide ConsumptionStatus. With user_id: per-user breakdown. Requires an admin-scoped API key.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
user_id | string | ❌ No | - | Optional UUID of a user. If provided, returns a per-user breakdown for that user. If omitted, returns the org-wide consumption status. |
from | string | ❌ No | - | ISO datetime; window start (default: org's current billing period start). |
to | string | ❌ No | - | ISO datetime; window end (default: org's current billing period end). |