contabo-mcp

An MCP server that gives AI agents the entire Contabo API: VPS/VDS instances, snapshots, images, object storage, private networks, firewalls, DNS, domains, secrets, users, tags and troubleshooting. It is generated from Contabo's official OpenAPI spec, so every one of the 158 operations is available as a tool.

• One tool per API operation, with typed JSON-schema inputs and readOnly / destructive annotations
• OAuth2 handled for you: token fetched, cached, refreshed on expiry and on 401
• Safety switches: read-only mode, tool groups, exclusion list
• Resilient: timeouts, retry with backoff on 429/5xx for reads, response size cap
• Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline, Codex, Gemini CLI, Zed, OpenCode and any stdio MCP client

Quick start

Requires Node.js 18.17+ and Contabo API credentials (my.contabo.com → Account → Security & Access → API: Client ID, Client Secret, API user, API password).

git clone https://github.com/Kirad20/contabo-mcp
cd contabo-mcp
npm install
npm test        # offline smoke test, no credentials needed

Then register the server in your agent. Example for Claude Code:

claude mcp add contabo \
  -e CONTABO_CLIENT_ID=... -e CONTABO_CLIENT_SECRET=... \
  -e CONTABO_API_USER=... -e CONTABO_API_PASSWORD=... \
  -e CONTABO_READ_ONLY=1 \
  -- node /absolute/path/to/contabo-mcp/src/index.js

Ready-made configs for every supported agent are in examples/ and explained in docs/CONFIGURATION.md.

Start read-only. CONTABO_READ_ONLY=1 exposes only the 72 GET tools. Remove it only when you want the agent to create, change or delete resources (which can cost money or destroy data).

Try it

Once connected, ask your agent things like:

• "List my Contabo instances and their status."
• "Which of my VPS have no firewall assigned?"
• "Create a snapshot of instance 12345 called before-upgrade."
• "Add an A record for app.example.com pointing to my instance IP."

More in docs/USAGE.md.

Configuration at a glance

Full list and details: docs/CONFIGURATION.md. The complete tool list is in docs/TOOLS.md.

Why filter tools?

All 158 tools together weigh ~165 KB of schema, which is a lot of context for the model. Pick the groups you need (CONTABO_GROUPS), enable CONTABO_COMPACT, or both. For example CONTABO_GROUPS="compute instances" CONTABO_COMPACT=1 loads 25 small tools.

Documentation

Disclaimer

Unofficial community project, not affiliated with Contabo GmbH. You are responsible for any resources created, changed or deleted through your credentials.

License

MIT, see LICENSE.