Home / Servers / Cloudflare API / billable_usage_v2_query_account_usage

Query Account Usage (Version 2, Alpha, Restricted)

An MCP tool from the Cloudflare API server, hosted on mcp.hjlabs.in.

Query Account Usage (Version 2, Alpha, Restricted) Returns cost and usage data for a single Cloudflare account, aligned with the FinOps FOCUS v1.3… [POST /accounts/{account_id}/billable/usage]

Name on the gateway: cloudflare_api__billable_usage_v2_query_account_usage · may change things.

Parameters

NameTypeDescription
account_id requiredstringaccount_id parameter
FilterByobjectUsage filters. Filters of different kinds are…
GroupByarrayGrouping definitions used to split result rows.…
Metricusage | costType of cost/usage records to retrieve. usage…
TimePeriodobjectCharge period to query, i.e. when consumption…

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:

call_tool arguments
{
  "name": "cloudflare_api__billable_usage_v2_query_account_usage",
  "arguments": {
    "account_id": "…"
  }
}

Or connect the Cloudflare API server directly, which lists 3,127 tools including this one:

Run in your terminal
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 query account usage (version 2, alpha, restricted) tool with account_id set to ….

More from Cloudflare API