Services/get_service_usage
Tool · Services

get_service_usage

Get CPU usage for one of the caller's hosting services by ID: current, today, and month-to-date CPU-minutes (UTC). Pass month=YYYY-MM to also get a per-day series.

Read-onlyIdempotentscope read:services

Invoked over the MCP transport with a tools/call request naming this tool.

Authorization #

Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:services scope — View your hosting services. The broker resolves the caller from the token and returns only records the account owns.

Parameters #

service_idintegerRequired
The hosting service ID.
monthnull · stringOptional
Optional 'YYYY-MM' to include a per-day CPU series.

Response #

200 · application/json

usageobject
service_idinteger
has_databoolean
as_of_utcstring · null
cpu_minutes_currentnumber · null
cpu_minutes_todaynumber · null
cpu_minutes_monthnumber · null
monthstring
seriesarray<object>
dayinteger
minutesnumber

Errors #

ResultWhen
{ "error": "invalid_month" }See the tool description for when this result is returned.
{ "error": "not_found" }The requested item does not exist, or it belongs to another account. Cross-account IDs are indistinguishable from missing ones by design.