Services/get_service
Tool · Services

get_service

Get a single hosting service by ID, including status, billing cycle, disk/bandwidth usage, server, and default nameservers.

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 #

idintegerRequired

Response #

200 · application/json

serviceobject
idinteger
domainstring
productstring
statusstring
One of: Active Suspended Terminated Pending Cancelled Fraud Completed
registration_datestring · null
next_due_datestring · null
billing_cyclestring
recurring_amountobject
valuestring
currencystring
first_payment_amountobject
valuestring
currencystring
disk_usage_mbinteger
disk_limit_mbinteger · null
bandwidth_usage_mbinteger
bandwidth_limit_mbinteger · null
suspension_reasonstring · null
server_namestring · null
dedicated_ipstring · null
nameserversarray<string>

Errors #

ResultWhen
{ "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.