---
title: billing_usage
url: "/docs/ai-agents/mcp-tools/billing/billing_usage/"
canonical_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/billing/billing_usage/
markdown_url: https://docs.blossom88.com/docs/ai-agents/mcp-tools/billing/billing_usage.md
summary: 'Show what the Organization is spending and where: usage by Account, Location
  and workload for a month or a range.'
categories:
- mcp
- reference
---

# billing_usage

Show what the Organization is spending and where: usage by Account, Location and workload for a month or a range.

| | |
|---|---|
| Access | Read only |
| Same as | [`blossom billing:usage`](/docs/reference/cli/billing/usage/) |

## Arguments

| Argument | Type | Description |
|---|---|---|
| `month` | string | Month, such as 2026-11; this month by default. |
| `period_range` | string | A range of months instead of one. |
| `workload` | string | Narrow to one workload. |
| `page` | integer | — |
| `limit` | integer | Rows per page. |

## Example

```json
{}
```