vpsnet-mcp

Model Context Protocol (MCP) server for managing VPSnet.com virtual private servers. Gives AI assistants full control over your VPS infrastructure — order servers, manage plans, deploy SSH keys, and directly access your servers via SSH for software installation and configuration.

Features

• 49 tools covering the entire VPSnet.com API
• Account & profile management
• VPS lifecycle (start, stop, restart, reinstall OS)
• Plan changes (free upgrades/downgrades)
• DNS (rDNS/PTR records)
• SSH key management — deploy keys and gain direct server access
• API key management
• Backups, billing, invoices
• Ordering new VPS instances
• System status & pricing

Prerequisites

Before installing, ensure you have:

1. Node.js 18 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

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

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

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

SSH access workflow

This MCP server manages your VPS infrastructure through the VPSnet.com API, including SSH key provisioning. Once an SSH key is deployed to a VPS, the AI assistant can connect directly using its environment's terminal (e.g. Claude Code's Bash tool, Cline's terminal).

Typical flow:

1. AI reads the local machine's public key (~/.ssh/id_rsa.pub)
2. Uploads it to VPSnet.com via create_ssh_key
3. Deploys it to a VPS via deploy_ssh_key (or passes it when ordering with order_service)
4. Connects directly: ssh root@<vps_ip>

Most AI coding environments (Claude Code, Cline, Cursor, Codex) have built-in terminal access, so the AI can SSH into your VPS immediately after deploying a key — no extra tools needed.

For environments without native SSH access, pair this with mcp-server-ssh for direct server connectivity via MCP tools.

Combined config:

{
  "mcpServers": {
    "vpsnet": {
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      }
    },
    "ssh": {
      "command": "npx",
      "args": ["-y", "mcp-server-ssh"]
    }
  }
}

Getting started

Choose your environment:

• Claude Code (CLI) — Terminal-based AI coding
• Claude Code for VS Code — VS Code extension
• Claude Desktop — Desktop app
• VS Code with GitHub Copilot — Copilot agent mode
• Cline / Cursor / Windsurf / Roo Code / Codex — Other clients

The standard config works across most MCP clients:

{
  "mcpServers": {
    "vpsnet": {
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here",
        "VPSNET_API_TIMEOUT_MS": "45000"
      }
    }
  }
}

claude mcp add vpsnet -- npx -y vpsnet-mcp

Set the environment variable before running:

export VPSNET_API_KEY="your_api_key_here"
export VPSNET_API_TIMEOUT_MS="45000"

This section is for the Claude Code VS Code extension, not GitHub Copilot. If you use VS Code with GitHub Copilot, see the VS Code with GitHub Copilot section instead.

Step 1: Install Claude Code CLI globally (required for the extension):

npm install -g @anthropic-ai/claude-code

Step 2: Add the MCP server via CLI:

claude mcp add vpsnet -- npx -y vpsnet-mcp

Step 3: Add your API key. Edit ~/.claude.json (or C:\Users\<username>\.claude.json on Windows), find the vpsnet server section and add the env block:

"vpsnet": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "vpsnet-mcp"],
    "env": {
        "VPSNET_API_KEY": "your_api_key_here",
        "VPSNET_API_URL": "https://api.vpsnet.com"
    }
}

Step 4: Restart VS Code completely (Ctrl+Shift+P > "Reload Window" or close and reopen).

Step 5: Verify by asking Claude: "Get my VPSnet account info"

Windows users: Use PowerShell or CMD (not Git Bash) when running claude mcp add commands.

The code --add-mcp command does NOT work with Claude Code extension — that's for VS Code Copilot only.

Follow the MCP install guide, use the standard config above.

Open Cline MCP settings and add to your cline_mcp_settings.json:

{
  "mcpServers": {
    "vpsnet": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      },
      "disabled": false
    }
  }
}

Use the Codex CLI:

codex mcp add vpsnet --env VPSNET_API_KEY=your_api_key_here -- npx -y vpsnet-mcp

Or edit ~/.codex/config.toml:

[mcp_servers.vpsnet]
command = "npx"
args = ["-y", "vpsnet-mcp"]

[mcp_servers.vpsnet.env]
VPSNET_API_KEY = "your_api_key_here"

If your system's default Node.js is older than 18 (common with nvm — check with node --version), wrap the command so nvm loads the right version:

codex mcp add vpsnet --env VPSNET_API_KEY=your_api_key_here -- bash -lc 'source ~/.nvm/nvm.sh >/dev/null 2>&1 && nvm use --silent 20 && npx -y vpsnet-mcp'

Note: Codex requires network access to install packages via npx. If you run Codex in a restricted sandbox without network, npx installs will fail.

Go to Cursor Settings > MCP > Add new MCP Server. Use command type with the command npx -y vpsnet-mcp. Or add manually to .cursor/mcp.json:

{
  "mcpServers": {
    "vpsnet": {
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      }
    }
  }
}

Open Roo Code MCP settings and add to roo_mcp_settings.json:

{
  "mcpServers": {
    "vpsnet": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "vpsnet-mcp"],
      "env": {
        "VPSNET_API_KEY": "your_api_key_here"
      },
      "disabled": false
    }
  }
}

Install using the VS Code CLI:

code --add-mcp '{"name":"vpsnet","command":"npx","args":["-y","vpsnet-mcp"],"env":{"VPSNET_API_KEY":"your_api_key_here"}}'

Or add to your VS Code MCP config manually using the standard config above.

This is for GitHub Copilot agent mode in VS Code. For the Claude Code extension, see the Claude Code for VS Code Extension section.

Follow the Windsurf MCP documentation. Use the standard config above.

Windows Users

• Use PowerShell or CMD (not Git Bash) for claude mcp add commands
• Config file location: C:\Users\<YourUsername>\.claude.json
• Install Node.js: winget install OpenJS.NodeJS.LTS or download from nodejs.org
• After installing Node.js, restart your terminal and VS Code
• Environment variables in Claude Code extension must be in the env object within .claude.json, NOT system environment variables

Environment variables

Variable	Required	Description
VPSNET_API_KEY	Yes	Your VPSnet.com API key
VPSNET_API_URL	No	API base URL (defaults to https://api.vpsnet.com)

Tools

Account

Tool	Description
get_account	Get account info (user ID, email, balance, VAT rate)
get_profile	Get user profile details (name, address, company)

Services

Tool	Description
list_services	List all active VPS services
get_service	Get detailed info for a service
get_service_graphs	Get performance graphs (CPU, RAM, disk, network)
get_service_history	Get action history for a service

Service Actions

Tool	Description
start_service	Start a stopped VPS
stop_service	Stop a running VPS
restart_service	Restart a VPS

Service Settings

Tool	Description
change_hostname	Change VPS hostname
change_root_password	Change VPS root password
get_rdns	Get current rDNS records
change_rdns	Change reverse DNS (PTR) record
flush_iptables	Flush iptables rules (useful when locked out)
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

OS Reinstall

Tool	Description
get_os_options	Get available OS templates
reinstall_os	Reinstall OS (destroys all data)

Plan Changes (free)

Tool	Description
get_plan_options	Get available plans for upgrade/downgrade
get_plan_resources	Get configurable resources for a plan
calculate_plan_change	Preview plan change cost and new expiry
change_plan	Change VPS plan

Renewal & Billing

Tool	Description
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

Ordering

Tool	Description
get_order_plans	Get available plans for new VPS
get_order_options	Get configurable options for a plan
order_service	Order a new VPS

Backups

Tool	Description
get_backup_status	Get backup status and configuration
get_backup_history	Get backup history
create_backup	Create a new backup (paid)

SSH Keys

Tool	Description
list_ssh_keys	List all SSH keys
get_ssh_key	Get a specific SSH key
create_ssh_key	Add a new SSH key
delete_ssh_key	Delete an SSH key

API Keys

Tool	Description
list_api_keys	List all API keys
create_api_key	Create a new API key
update_api_key	Update an existing API key
revoke_api_key	Revoke (delete) an API key

History

Tool	Description
get_login_history	Get account login history
get_management_history	Get management/activity history

Public

Tool	Description
get_pricing	Get public pricing
get_system_status	Get VPSnet.com system status
get_faq	Get frequently asked questions

Getting an API key

1. Log in at vpsnet.com
2. Go to Account > API Keys
3. Click Create API Key
4. Give it a name and copy the key

The key is shown only once — store it securely.

Troubleshooting

MCP tools not appearing in Claude Code VS Code extension

1. Install Claude Code CLI: npm install -g @anthropic-ai/claude-code
2. Verify: claude --version should show a version number
3. Add server via CLI: claude mcp add vpsnet -- npx -y vpsnet-mcp
4. Completely restart VS Code (not just reload window)
5. Check ~/.claude.json for correct configuration

claude: command not found

Install the Claude Code CLI globally:

npm install -g @anthropic-ai/claude-code

Verify your PATH includes npm global packages. On Windows, restart your terminal after installing.

Environment variables not working

For Claude Code extension, environment variables must be in the env object within .claude.json, NOT system environment variables:

"vpsnet": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "vpsnet-mcp"],
    "env": {
        "VPSNET_API_KEY": "your_actual_key_here"
    }
}

API key errors

• Verify the key is correct (starts with vpsnet_)
• Keys are shown only once at creation — if lost, create a new one
• Check that the key hasn't expired (Account > API Keys)

deploy_ssh_key succeeded but SSH still fails

• All VPSnet.com servers use root as the SSH username
• Key deployment is async — wait 15-30 seconds after deploying before attempting SSH

fetch is not defined or unexpected errors

This server requires Node.js 18+ (uses the built-in fetch API). If your default node is older (common with nvm setups), either:

• Set Node 18+ as default: nvm alias default 20
• Or use the nvm wrapper shown in the Codex section

License

MIT