Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vps-mcp list my VPS servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
# Recommended: run directly with uvx (no install needed)
uvx vps-mcp
# Or install with pip
pip install vps-mcpRelated MCP server: whm-mcp-server
Log in at admin.vps.org
Go to Account → Developers (direct link)
Create a new API token
Copy the token (starts with vps_)
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 mcp add vps -- uvx vps-mcpThen set the environment variable before running Claude Code:
export VPS_API_TOKEN="vps_your_token_here"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"
}
}Tool | Description |
| List all VPS servers in your account |
| Get detailed info about a specific server |
| Create a new VPS server |
| Permanently delete a server |
| Start, stop, restart, or hard-stop a server |
| Create a backup of a server |
| Create a snapshot of a server |
| Resize a server to a different plan |
Tool | Description |
| List all domains in your account |
| Get detailed info about a domain |
| Search for domain availability |
| Update nameservers for a domain |
| Renew a domain registration |
Tool | Description |
| List DNS zones (optionally filter by domain) |
| Get a DNS zone with all records |
| Create a new DNS zone |
| Delete a DNS zone and all its records |
| Create a DNS record (A, AAAA, CNAME, MX, TXT, etc.) |
| Update an existing DNS record |
| Delete a DNS record |
Tool | Description |
| List available VPS plans with pricing |
| List available data center locations |
| List available OS options |
Tool | Description |
| List all SSH keys in your account |
| Add a new SSH public key |
| Delete an SSH key |
Your API token needs the following permissions depending on which tools you use:
Tools | Required Permission |
Server tools |
|
Domain tools |
|
DNS tools |
|
Plan/Location/OS tools |
|
SSH Key tools |
|
All tools |
|
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"
# 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-mcpMIT
Add a new SSH public key to your account.
Args: name: A label for the key (e.g. "work-laptop") public_key: The SSH public key (e.g. "ssh-ed25519 AAAA...")
Inputs: name (required), public_key (required). Returns: result
Create a backup of a VPS server.
Args: server_uuid: The UUID of the server to back up
Inputs: server_uuid (required). Returns: result
Create a DNS record in a zone.
Args: zone_uuid: The UUID of the DNS zone record_type: Record type (A, AAAA, CNAME, MX, TXT, NS, SRV, CAA) name: Record name (e.g. "@" for root, "www", "mail") value: Record value (e.g. IP address, hostname) ttl: Time to live in seconds (default 3600) priority: Priority for MX/SRV records
Inputs: zone_uuid (required), record_type (required), name (required), value (required), +2 more. Returns: result
Create a new DNS zone for a domain.
Args: domain: The domain name (e.g. "example.com")
Inputs: domain (required). Returns: result
Create a new VPS server.
Args: hostname: Hostname for the server (e.g. "my-server") location_id: Location ID (use list_locations to find available locations) plan_uuid: UUID of the plan (use list_plans to find available plans) os_version_uuid: UUID of the OS version (use list_operating_systems to find options) ssh_key_ids: Optional list of SSH key UUIDs to install on the server
Inputs: hostname (required), location_id (required), plan_uuid (required), os_version_uuid (required), +1 more. Returns: result
Create a snapshot of a VPS server.
Args: server_uuid: The UUID of the server to snapshot label: Optional label for the snapshot
Inputs: server_uuid (required), label. Returns: result
Delete a DNS record.
Args: record_uuid: The UUID of the DNS record to delete
Inputs: record_uuid (required). Returns: result
Delete a DNS zone and all its records.
Args: zone_uuid: The UUID of the DNS zone to delete
Inputs: zone_uuid (required). Returns: result
Permanently delete a VPS server. This action is irreversible.
Args: server_uuid: The UUID of the server to delete
Inputs: server_uuid (required). Returns: result
Delete an SSH key from your account.
Args: ssh_key_uuid: The UUID of the SSH key to delete
Inputs: ssh_key_uuid (required). Returns: result
Get a DNS zone with all its records.
Args: zone_uuid: The UUID of the DNS zone
Inputs: zone_uuid (required). Returns: result
Get detailed information about a specific domain.
Args: domain_uuid: The UUID of the domain
Inputs: domain_uuid (required). Returns: result
Get detailed information about a specific VPS server.
Args: server_uuid: The UUID of the server
Inputs: server_uuid (required). Returns: result
List DNS zones, optionally filtered by domain name.
Args: domain: Optional domain name to filter by
Inputs: domain. Returns: result
List all domains in your account.
Args: page: Page number (default 1)
Inputs: page. Returns: result
List all available data center locations.
Inputs: no named parameters. Returns: result
List all available operating systems and their versions.
Inputs: no named parameters. Returns: result
List all available VPS plans with pricing, specs, and UUIDs.
Inputs: no named parameters. Returns: result
List all VPS servers in your account.
Args: page: Page number (default 1) page_size: Results per page (default 20, max 100)
Inputs: page, page_size. Returns: result
List all SSH keys in your account.
Inputs: no named parameters. Returns: result
Renew a domain registration.
Args: domain_uuid: The UUID of the domain to renew years: Number of years to renew for (default 1)
Inputs: domain_uuid (required), years. Returns: result
Resize a VPS server to a different plan. The server may be restarted.
Args: server_uuid: The UUID of the server to resize new_plan_uuid: The UUID of the new plan (use list_plans to see options)
Inputs: server_uuid (required), new_plan_uuid (required). Returns: result
Search for domain availability.
Args: domain: The domain name to search for (e.g. "example.com")
Inputs: domain (required). Returns: result
Control the power state of a VPS server.
Args: server_uuid: The UUID of the server action: Power action — one of: "start", "stop", "restart", "hard_stop"
Inputs: server_uuid (required), action (required). Returns: result
Update an existing DNS record.
Args: record_uuid: The UUID of the DNS record to update record_type: New record type name: New record name value: New record value ttl: New TTL in seconds priority: New priority (MX/SRV records)
Inputs: record_uuid (required), record_type, name, value, +2 more. Returns: result
Update the nameservers for a domain.
Args: domain_uuid: The UUID of the domain ns1: Primary nameserver (required) ns2: Secondary nameserver ns3: Third nameserver ns4: Fourth nameserver
Inputs: domain_uuid (required), ns1 (required), ns2, ns3, +1 more. Returns: result
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 26 tools
Each tool targets a distinct resource and action (e.g., create_server vs. list_servers vs. get_server) with no overlap. Tools for VPS, DNS, SSH keys, and domains are clearly separated.
All tools follow a consistent verb_noun pattern (e.g., create_server, list_dns_zones, delete_ssh_key). Minor exceptions like server_power are still intuitive.
26 tools cover multiple domains (VPS, DNS, SSH, domains) without being excessive. Each tool serves a clear purpose, though the count is slightly above the typical sweet spot of 3-15.
The tool set provides full CRUD and lifecycle management for VPS servers, DNS zones/records, SSH keys, and domains. Common operations like backup, snapshot, resize, power control, and domain renewals are included.
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
Manage VeriTeknik servers, DNS, backups and support tickets from your AI assistant.
Manage ZAP-Hosting game servers, VPS, dedicated servers, TeamSpeak and domains from your AI client.
Manage American Cloud VMs, Kubernetes, databases, storage, networks and DNS from your AI assistant.