organization_billing_usage
Monitor and analyze resource consumption and cost trends by retrieving detailed billing and usage metrics for your organization over specified time intervals (hourly, daily, monthly).
Instructions
Retrieve detailed billing and usage metrics for your organization over a specified time period.
Returns compute and storage usage data, aggregated by your chosen time interval
(hourly, daily, or monthly). This tool is essential for:
1. Monitoring resource consumption patterns
2. Analyzing cost trends
Args:
start_time: Beginning of the usage period (UTC ISO 8601 format, e.g., '2023-07-30T18:30:00Z')
end_time: End of the usage period (UTC ISO 8601 format)
aggregate_type: Time interval for data grouping ('hour', 'day', or 'month')
Returns:
Usage metrics and billing information
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| aggregate_type | Yes | ||
| ctx | No | ||
| end_time | Yes | ||
| start_time | Yes |
Input Schema (JSON Schema)
{
"$defs": {
"Context": {
"description": "Context object providing access to MCP capabilities.\n\nThis provides a cleaner interface to MCP's RequestContext functionality.\nIt gets injected into tool and resource functions that request it via type hints.\n\nTo use context in a tool function, add a parameter with the Context type annotation:\n\n```python\n@server.tool()\ndef my_tool(x: int, ctx: Context) -> str:\n # Log messages to the client\n ctx.info(f\"Processing {x}\")\n ctx.debug(\"Debug info\")\n ctx.warning(\"Warning message\")\n ctx.error(\"Error message\")\n\n # Report progress\n ctx.report_progress(50, 100)\n\n # Access resources\n data = ctx.read_resource(\"resource://data\")\n\n # Get request info\n request_id = ctx.request_id\n client_id = ctx.client_id\n\n return str(x)\n```\n\nThe context parameter name can be anything as long as it's annotated with Context.\nThe context is optional - tools that don't need it can omit the parameter.",
"properties": {},
"title": "Context",
"type": "object"
}
},
"properties": {
"aggregate_type": {
"title": "aggregate_type",
"type": "string"
},
"ctx": {
"anyOf": [
{
"$ref": "#/$defs/Context"
},
{
"type": "null"
}
],
"default": null
},
"end_time": {
"title": "end_time",
"type": "string"
},
"start_time": {
"title": "start_time",
"type": "string"
}
},
"required": [
"start_time",
"end_time",
"aggregate_type"
],
"title": "organization_billing_usageArguments",
"type": "object"
}