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

1. Log in at admin.vps.org
2. Go to Account → Developers (direct link)
3. Create a new API token
4. 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

Domains

DNS

Info

SSH Keys

Required API Permissions

Your API token needs the following permissions depending on which tools you use:

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