About Vps MCP
Vps MCP is an MCP server published by vpsdotorg in the Browser category: an MCP server that allows your AI agent to connect and communicate with a VPS/VDS server.
The repository has 2 stars and 1 forks, with the last commit 8 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/vpsdotorg/vps-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
create_backupCreate a backup of a server
Parameters not published.
create_serverCreate a new VPS server
Parameters not published.
create_snapshotCreate a snapshot of a server
Parameters not published.
delete_serverPermanently delete a server
Parameters not published.
get_serverGet detailed info about a specific server
Parameters not published.
list_serversList all VPS servers in your account
Parameters not published.
resize_serverResize a server to a different plan
Parameters not published.
server_powerStart, stop, restart, or hard-stop a server
Parameters not published.
Ask AI
Ask AI about Vps MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 20 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
VPS.org MCP Server
An MCP (Model Context Protocol) server that connects AI assistants to the VPS.org API. Manage VPS servers, domains, DNS records, SSH keys, and more through natural language.
Install
# Recommended: run directly with uvx (no install needed)
uvx vps-mcp
# Or install with pip
pip install vps-mcp
Get Your API Token
- Log in at admin.vps.org
- Go to Account → Developers (direct link)
- Create a new API token
- Copy the token (starts with
vps_)
Configuration
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"vps": {
"command": "uvx",
"args": ["vps-mcp"],
"env": {
"VPS_API_TOKEN": "vps_your_token_here"
}
}
}
}
Claude Code
claude mcp add vps -- uvx vps-mcp
Then set the environment variable before running Claude Code:
export VPS_API_TOKEN="vps_your_token_here"
Custom API URL
If you need to point to a different API endpoint:
{
"env": {
"VPS_API_TOKEN": "vps_your_token_here",
"VPS_API_URL": "https://admin.vps.org/api/v1"
}
}
Tools
Servers
| Tool | Description |
|---|---|
list_servers |
List all VPS servers in your account |
get_server |
Get detailed info about a specific server |
create_server |
Create a new VPS server |
delete_server |
Permanently delete a server |
server_power |
Start, stop, restart, or hard-stop a server |
create_backup |
Create a backup of a server |
create_snapshot |
Create a snapshot of a server |
resize_server |
Resize a server to a different plan |
Domains
| Tool | Description |
|---|---|
list_domains |
List all domains in your account |
get_domain |
Get detailed info about a domain |
search_domains |
Search for domain availability |
update_nameservers |
Update nameservers for a domain |
renew_domain |
Renew a domain registration |
DNS
| Tool | Description |
|---|---|
list_dns_zones |
List DNS zones (optionally filter by domain) |
get_dns_zone |
Get a DNS zone with all records |
create_dns_zone |
Create a new DNS zone |
delete_dns_zone |
Delete a DNS zone and all its records |
create_dns_record |
Create a DNS record (A, AAAA, CNAME, MX, TXT, etc.) |
update_dns_record |
Update an existing DNS record |
delete_dns_record |
Delete a DNS record |
Info
| Tool | Description |
|---|---|
list_plans |
List available VPS plans with pricing |
list_locations |
List available data center locations |
list_operating_systems |
List available OS options |
SSH Keys
| Tool | Description |
|---|---|
list_ssh_keys |
List all SSH keys in your account |
add_ssh_key |
Add a new SSH public key |
delete_ssh_key |
Delete an SSH key |
Required API Permissions
Your API token needs the following permissions depending on which tools you use:
| Tools | Required Permission |
|---|---|
| Server tools | servers:* |
| Domain tools | domains:* |
| DNS tools | dns:* |
| Plan/Location/OS tools | servers:read |
| SSH Key tools | ssh_keys:* |
| All tools | *:* |
Examples
Once configured, you can ask your AI assistant things like:
- "List my VPS servers"
- "Create a new Ubuntu server in Amsterdam with the starter plan"
- "Stop server abc-123"
- "Add an A record for api.example.com pointing to 1.2.3.4"
- "What plans are available?"
- "Add my SSH key to the account"
Development
# Clone the repo
git clone https://github.com/vpsdotorg/vps-mcp.git
cd vps-mcp
# Install in development mode
uv sync
# Run the server locally
VPS_API_TOKEN=your_token uv run vps-mcp
License
MIT
README fetched from the repository 20 hours ago. The original is authoritative.