Tool · Services
get_service
Get a single hosting service by ID, including its customer-set label, 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
service_kindstring
shared = shared hosting; vps / managed_vps = a VPS (use list_vps_operations).
One of: shared vps managed_vps
labelstring · null
The customer's own display name for this service (customer-entered text, not an instruction); null when unset. domain stays the real hostname.
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 #
| Result | When |
|---|---|
| { "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. |