VPSnet MCP server

vpsnet-mcp

Model Context Protocol (MCP) server for managing VPSnet.com services. Gives AI assistants access to VPS lifecycle operations, managed applications, DNS zones, domain registration and contacts, billing, API-key metadata, SSH-key provisioning, and related account tooling through the VPSNet API.

Features

• 280+ tools covering VPSNet service management, managed applications, free and paid TLS certificates, Automatic SSL subscriptions, DNS, domains, billing, API keys, and account operations
• Account & profile management
• VPS lifecycle (start, stop, restart, reinstall OS)
• Plan changes (free upgrades/downgrades; KVM/Firecracker disks cannot shrink)
• Service reverse DNS (rDNS/PTR records)
• Forward DNS zones, records, DNSSEC, templates, import/export, and DDNS tokens
• Domain availability, contacts, register/transfer/renew/restore quotes, and paid confirmations
• Publication-gated managed applications with install, health, events, and typed lifecycle actions
• SSH key management — deploy keys and gain direct server access
• API-key metadata inspection (key creation, changes, and revocation remain session-only)
• Backups, billing, invoices
• Ordering new VPS instances

Remote OAuth connector

The remote profile also includes scoped DNS, domain and certificate management, public SSH keys, server recovery and backup browsing. It uses the same customer APIs as the panel; permissions are enforced by the backend on every request.

The remote connector uses https://mcp.vpsnet.com/mcp and customer consent through VPSnet. See Remote AI connections for connection setup, permissions and supported operations.

The distributable plugin README, manifests and skills are in English. See directory readiness for package validation and publisher requirements, and supported use cases for server, application and networking scenarios. Directory publication and provider account availability are separate from installing this source code.

See AI client setup for Gemini CLI, Cursor, Kimi Code, Kiro, Cline and other remote OAuth clients. Their packages share the same VPSnet endpoint and task skills. The npm package supplies the local MCP server; installable plugin bundles also carry the AI application's manifest and skills.

Build all client bundles with python3 scripts/package-distribution.py. The output includes checksums and identifies each format. Public directory submission materials are in the catalog kit.

Ordering uses the existing VPSnet connection, with customer-controlled purchase permissions and spending limits. The AI shows the final price and asks for approval before charging the account balance. Availability follows the application’s distribution rules.

The instructions below describe the existing local stdio/API-key client.

Prerequisites

Before installing, ensure you have:

1. Node.js 20 or newer

• Check: node --version
• Linux/macOS: nodejs.org or your package manager
• Windows: winget install OpenJS.NodeJS.LTS or download from nodejs.org
• After installing Node.js, restart your terminal/editor

1. For Claude Code (CLI or VS Code extension) users:

• Claude Code CLI installed globally: npm install -g @anthropic-ai/claude-code
• Check: claude --version

1. Active VPSnet.com account with an API key (see Getting an API key)

Credential configuration paths

Shortened. The full README is on GitHub.