Home / Servers / Cloudflare API / aig_billing_get_usage_history
Get usage history
An MCP tool from the Cloudflare API server, hosted on mcp.hjlabs.in.
Get usage history Retrieve AI Gateway usage cost, in US dollars, aggregated by hour or day for the given time range. [GET /accounts/{account_id}/ai-gateway/billing/usage-history]
Name on the gateway: cloudflare_api__aig_billing_get_usage_history · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
account_id required | string | account_id parameter |
value_grouping_window required | day | hour | Grouping window for usage data. |
start_time | number | Start time as Unix timestamp in milliseconds. |
end_time | number | End time as Unix timestamp in milliseconds. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "cloudflare_api__aig_billing_get_usage_history",
"arguments": {
"account_id": "…",
"value_grouping_window": "…"
}
}Or connect the Cloudflare API server directly, which lists 3,127 tools including this one:
claude mcp add --transport http hj-cloudflare-api https://mcp.hjlabs.in/mcp/cloudflare-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the get usage history tool with account_id set to ….