# VPSnet [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/bacarrdy/vpsnet-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 524  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/vpsnet

## Description
Manage VPSnet servers, apps, private networks and Functions with authorized customer access.

## Tools
Capabilities this server exposes over MCP:

- **get_account** — Get account info (user ID, email, balance, VAT rate)
- **get_profile** — Get user profile details (name, address, company)
- **list_services** — List all active VPS services
- **get_service** — Read service details and the next readiness check; keep provisioning, guest access and application health separate
- **get_service_graphs** — Get one graph series: metric (cpu, ram, ssd, net, io, …) and period (5m … 1y)
- **get_event** — Read an async action's state by its `event` id or `noty` UUID
- **wait_for_event** — Poll an async action until completed or error (or a timeout)
- **get_service_history** — Get action history for a service
- **list_application_catalog** — List published applications compatible with a service
- **list_service_applications** — List installed applications and pending checkout selection
- **get_application_installation** — Get observed state, health, drift, endpoints, components, resource history, and thresholds
- **get_application_events** — Get bounded customer-safe installation events
- **get_application_health** — Run and poll a fresh container-health inspection
- **get_application_logs** — Run and poll a size-bounded recent-log inspection
- **get_application_inspection** — Poll the exact persisted health or logs inspection returned by get_application_health or get_application_logs when it remains pending.
- **list_application_restore_points** — List eligible nightly points for the exact application revision
- **quote_application_data_restore** — Freeze the exact selective-restore balance charge without payment
- **restore_application_data** — Pay and queue confirmed selective replacement of declared application data
- **get_application_data_restore** — Poll one tenant-bound selective data restore
- **list_application_registry_credentials** — List non-secret private registry credential metadata
- **validate_application_recipe** — Validate customer Compose against the target worker policy
- **get_application_recipe_validation** — Poll the exact persisted customer recipe validation returned by validate_application_recipe or a pending recipe creation/revision.
- **list_application_recipes** — List customer-owned immutable recipe projects
- **list_application_recipe_revisions** — List immutable revisions for a customer recipe
- **create_application_recipe** — Validate and save a new customer recipe without installing it
- **create_application_recipe_revision** — Validate and save a later immutable customer recipe revision
- **export_application_recipe** — Export only a customer-owned recipe without secret values
- **install_application_recipe** — Install an exact validated customer recipe revision
- **discover_service_containers** — Discover bounded read-only container metadata
- **get_service_container_discovery** — Poll the exact persisted service container discovery returned by discover_service_containers when it remains pending.
- **prepare_application_compose_adoption** — Prepare and poll a scrubbed candidate for one discovered Compose project
- **get_application_compose_adoption** — Poll one tenant-bound Compose adoption candidate
- **confirm_application_compose_adoption** — Confirm the exact source takeover after explicit approval
- **install_application** — Queue a confirmed, version-pinned managed installation
- **configure_application_access** — Queue a confirmed platform-hostname, private, public-IP, managed-HTTPS, or customer-managed external-HTTPS access change
- **configure_application_resource_thresholds** — Replace confirmed non-enforcing application resource thresholds and reached/recovered email preference
- **manage_application** — Compatibility tool for older clients; use the individual actions below
- **reconcile_application** — Reconcile an application with its declared configuration
- **repair_application** — Repair an application runtime
- **restart_application** — Restart an application after confirming interruption
- **start_application** — Start a stopped application
- **stop_application** — Stop an application after confirming interruption
- **uninstall_application** — Delete an application after explicit data-loss approval
- **update_application** — Apply the eligible immutable update with exact version preconditions
- **rollback_application** — Queue the exact reverse transition advertised as type=rollback by get_application_installation.
- **cancel_application_action** — Cancel the exact latest queued action only while the backend advertises it as cancellable
- **start_service** — Start a stopped VPS
- **stop_service** — Stop a running VPS
- **restart_service** — Restart a VPS
- **console_service** — Request an out-of-band console session for a running VPS
- **suspend_service** — Suspend a running Cloud VPS
- **resume_service** — Resume a suspended Cloud VPS
- **get_hostname** — Get current and automatic service hostname state
- **get_guest_nameservers** — Get the server's saved guest DNS resolver configuration: nsData.type is own (VPSnet defaults) or custom, with ns1-ns4 resolver IP addresses.
- **change_hostname** — Change VPS hostname
- **reset_hostname** — Restore the VPSnet-managed automatic hostname
- **set_guest_nameservers** — Change DNS resolvers inside a supported Linux server.
- **change_root_password** — Change VPS root password
- **get_rdns** — Get current rDNS records
- **change_rdns** — Change reverse DNS (PTR) record
- **clear_rdns** — Clear a PTR override and restore the automatic value
- **flush_iptables** — Flush iptables rules (useful when locked out)
- **get_title** — Get the current service display title
- **change_title** — Change service display title
- **toggle_ipv6** — Enable or disable IPv6
- **toggle_extra_settings** — Toggle ppp, fuse, tuntap, or nfs
- **deploy_ssh_key** — Deploy an SSH key to a VPS; remote OAuth also requires `vm:exec
- **get_os_options** — Get available OS templates
- **reinstall_os** — Reinstall VPS OS (destroys existing data). Cloud/Firecracker VPS also delete existing snapshots and require explicit `confirmSnapshotDelete` when snapshots exist; those snapshots cannot provide rollback after reinstall. Returns a `noty` acceptance event; follow service history for completion.
- **get_plan_options** — Get available plans for upgrade/downgrade; KVM/Firecracker targets that would shrink disk are unavailable
- **get_plan_resources** — Get configurable resources for a plan
- **calculate_plan_change** — Preview a plan change: no payment, the remaining value is converted, so an upgrade moves the expiry earlier
- **change_plan** — Change VPS plan
- **get_period_options** — Get billing period and auto-renewal options
- **set_auto_renew** — Enable or disable auto-renewal
- **renew_service** — Manually renew a service
- **list_invoices** — List invoices
- **get_invoice** — Get a specific invoice
- **list_payments** — List payment history
- **get_usage_statements** — List itemized metered-usage statements separately from invoices

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "vpsnet": {
    "command": "npx",
    "args": ["-y","vpsnet-mcp"],
    "env": {
      "VPSNET_API_KEY": "",
      "VPSNET_CONFIG_DIR": "",
      "VPSNET_API_KEY_FILE": "",
      "VPSNET_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `VPSNET_API_KEY`, `VPSNET_CONFIG_DIR`, `VPSNET_API_KEY_FILE`, `VPSNET_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What VPSnet MCP server does

The VPSnet MCP server gives MCP-compatible AI clients access to VPSnet.com customer services. Its toolset covers VPS lifecycle management, managed applications, networking, domains, certificates, account administration, and billing-related tasks. The repository describes more than 280 tools, so it is intended for accounts where an agent needs to inspect or change several VPSnet service areas rather than one isolated resource type.

Supported operations include starting, stopping, restarting, and reinstalling VPS instances; changing plans; ordering VPS instances; and managing reverse DNS records. DNS tools cover zones, records, DNSSEC, templates, import and export, and DDNS tokens. Domain tools support availability checks, contacts, registration, transfers, renewals, restoration quotes, and paid confirmations.

Managed application tools support catalog discovery, installation, health checks, events, logs, access configuration, resource-threshold settings, and typed lifecycle actions. The server also covers TLS certificates, Automatic SSL subscriptions, backups, invoices, API-key metadata, SSH-key provisioning, system status, and pricing.

## How it works

The VPSnet MCP server can run as a local stdio service using an API key, or through VPSnet's remote OAuth endpoint at `https://mcp.vpsnet.com/mcp`. The remote connector uses customer consent, while VPSnet enforces permissions on each backend request. The remote profile includes scoped access for DNS, domains, certificates, public SSH keys, server recovery, and backup browsing.

Application changes are asynchronous. After an installation or lifecycle request, use the application installation and event tools to verify the resulting state. Health and log inspections create short-lived inspection jobs. Application installation and lifecycle changes require the relevant application permissions and an idempotency key.

## Setup and configuration

Local use requires Node.js 20 or newer, an active VPSnet.com account, and an API key. `VPSNET_API_KEY` is the preferred per-launch credential. Alternatively, configure a directory containing `.vpsnet-mcp-key` or `.mcp.json` with `VPSNET_CONFIG_DIR`, or select one key file with `VPSNET_API_KEY_FILE`.

Without `VPSNET_CONFIG_DIR`, file lookup uses the process launch directory, not the package or installation directory. This matters when an editor launches the MCP process from a different working directory. Keep credential files out of source control. `VPSNET_API_URL` can override the URL configured in the relevant JSON file, subject to the server's HTTPS and trusted-host checks.

Remote clients use the VPSnet endpoint and customer authorization flow. The repository also documents client bundles and skills for supported remote integrations, while the npm package provides the local MCP server.

## Tools and capabilities

- Manage VPS state, plans, operating-system reinstalls, orders, recovery, backups, and reverse DNS.
- Inspect and change managed applications, including access modes, health, events, logs, and resource display thresholds.
- Manage DNS zones, records, DNSSEC, templates, imports, exports, DDNS tokens, and domains.
- Handle certificates, Automatic SSL subscriptions, SSH keys, API-key metadata, billing, invoices, pricing, and account data.

## Limitations and notes

Permissions differ by operation. Application reads require `applications:read`; installation and lifecycle changes require `applications:manage`. API-key creation, modification, and revocation remain session-only rather than MCP tools. Registry credential tools expose metadata only; token creation and rotation must occur in the VPSnet panel or direct REST API.

Managed application support follows VPSnet's product, operating-system, architecture, and runtime compatibility rules. Resource thresholds only highlight measurements and do not enforce limits, trigger actions, or change billing. External HTTPS entries record an existing customer-managed address; VPSnet does not configure or validate its DNS, certificate, or reverse proxy.

_Full upstream README: https://allmcps.com/mcp/vpsnet/readme_