VPS/vps_manage
Tool · VPS

vps_manage

Run one operation on the customer's own VPS and return { ok, data, errors[], warnings[] }: details and status, power (start, stop, reboot), IPs and reverse DNS, null-routing, firewall rules, traffic, snapshots, rescue ISOs, notification settings and the console. Call list_vps_operations(service_id) first for the operations this VPS supports and their parameters; pass service_id, operation and params (a flat object, {} when none). Operations that change the VPS answer error="confirm_required" until you pass confirm:true: tell the customer exactly what will change, get their agreement, then repeat the call. Power and snapshot operations run in the background: data {accepted:true, async:true} only means accepted — poll operation="status" (or list_snapshots) before reporting the result. An attached or detached rescue ISO takes effect on the next boot. operation="console" returns console_url, a JetHost link that works ONCE and expires after 10 minutes — give it to the customer as is; logging in on the console needs the VPS root password, which is never available here (the customer finds or resets it in the client area). No credentials or password resets are offered; reinstall and snapshot restore answer error="not_implemented" ("Not implemented, contact support"). Other errors: "feature_not_enabled" (not in this plan), "invalid_params" (param names the culprit), "upstream_error" (detail says why), "rate_limited" (too many console links), "not_found" (not the customer's VPS). Reads need read access to services; changes and the console also need the hosting-management scope the customer already granted.

DestructiveOpen‑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).
operationstringRequired
The operation name, e.g. "status", "reboot" or "list_firewall_rules". Call list_vps_operations for the exact names this VPS supports.
paramsobject · arrayOptional
The operation's parameters as a flat JSON object, e.g. {"ip":"203.0.113.10","reverse_lookup":"mail.example.com"} for set_rdns. Omit it, or pass {}, when the operation takes none.
confirmbooleanOptional
Set true to confirm an operation that changes the VPS, after the customer agreed to it.

Response #

200 · application/json

okboolean
errorsarray<string>
warningsarray<string>
notestring
messagestring
paramstring
operationstring
detailstring

Errors #

ResultWhen
{ "error": "unknown_operation" }See the tool description for when this result is returned.
{ "error": "invalid_params" }See the tool description for when this result is returned.
{ "error": "internal_error" }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.
{ "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.
{ "error": "feature_not_enabled" }See the tool description for when this result is returned.
{ "error": "not_implemented" }See the tool description for when this result is returned.
{ "error": "confirm_required" }The call changes something (places an order, runs a mutating operation) and was made without confirm:true. Show the customer what will happen, get their agreement, then repeat with confirm:true.
{ "error": "upstream_error" }See the tool description for when this result is returned.
{ "error": "rate_limited" }Too many requests of this kind in a short time; retry_after_seconds says how long to wait. Do not loop.