VPS/list_vps_operations
Tool · VPS

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.

Read-onlyIdempotentOpen‑worldscope 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 VPS service ID. Obtain it via list_services (service_kind vps or managed_vps).

Response #

200 · application/json

service_idinteger
service_kindstring
One of: vps managed_vps
operationsarray<object>
namestring
summarystring
mutatingboolean
implementedboolean
paramsarray<object>
namestring
typestring
requiredboolean
enumarray<string>
patternstring
formatstring
max_lengthinteger
minimuminteger
maximuminteger
descriptionstring
listingstring
notesarray<string>
messagestring

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