list_vps_operations
List the VPS operations ONE of the customer's VPS services supports, by service_id (from list_services, where service_kind is "vps" or "managed_vps"). Only the operations that service's plan includes are listed — a Managed VPS is typically limited to details — each with a one-line summary and its parameters (name, type, required, allowed values, pattern, bounds). `listing` is the same menu as text: one line per operation, "name(params)" with optional parameters marked "?", behind a two-character flag column: "!" in the first column means the operation changes the VPS and vps_manage refuses it without confirm:true; "x" in the second means it is not available through the assistant (reinstall and snapshot restore answer "Not implemented, contact support"). `notes` carries the rules to follow. Root credentials and password resets are never available here. A service that is not the customer's, or not a VPS, returns error="not_found"; a suspended or cancelled one returns error="service_not_active". Call this first, then vps_manage. Requires read access to 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 #
Response #
200 · application/json
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. |
| { "error": "internal_error" } | See the tool description for when this result is returned. |
| { "error": "service_not_active" } | See the tool description for when this result is returned. |
| { "error": "vps_not_provisioned" } | See the tool description for when this result is returned. |
| { "error": "shared_vps_refused" } | See the tool description for when this result is returned. |