Netcup Mcp

🤖 netcup-mcp

Drive your netcup infrastructure from any AI assistant — via the Model Context Protocol

[](https://github.com/fullya99/netcup-mcp/actions/workflows/ci.yml) [](https://www.python.org/) [](#-license) [](https://modelcontextprotocol.io)

"Snapshot web01, then power it off." — let Claude (or any MCP client) operate your netcup VPS fleet, safely and with full API coverage.

[Install](#-install) · [Authenticate](#-authenticate-once) · [Configure](#-configure-your-client) · [Tools](#-tools)

---

A Model Context Protocol server that exposes the netcup Server Control Panel (SCP) REST API to AI assistants — Claude Desktop, Claude Code, and any MCP-compatible client.

Built on the shared netcup-api core library, so the CLI and this server always agree on auth, base URLs and the endpoint catalog.

✨ Highlights

| | | |---|---| | 🧰 Curated tools | Clear, typed tools for daily ops — servers, snapshots, rDNS, firewall, tasks, metrics. | | 🌐 Every endpoint | A universal trio (list_endpoints / describe_endpoint / call_endpoint) reaches any operation by id. | | 🔮 Future-proof | New netcup endpoints become available after netcup spec update — no code change. | | 🔐 Shared, safe auth | Reuses the CLI's offline refresh token; never does interactive login; errors are returned, not thrown. | | 🧩 One tool per endpoint | Optional full expansion with NETCUP_MCP_ALL_TOOLS=1. |

📦 Install

pip install netcup-mcp          # pulls in netcup-api automatically

🔑 Authenticate (once)

The server never does interactive login — it reuses the credentials written by the CLI. Authenticate once:

pip install netcup-api
netcup auth login               # OAuth2 device flow; stored in ~/.config/netcup-api/

⚙️ Configure your client

Run it directly to test (netcup-mcp speaks MCP over stdio), or wire it into your assistant:

Claude Desktop / Claude Code

{
  "mcpServers": {
    "netcup": {
      "command": "netcup-mcp",
      "env": {
        "NETCUP_CONFIG_DIR": "/home/youruser/.config/netcup-api"
      }
    }
  }
}

> [!TIP] > Add "NETCUP_MCP_ALL_TOOLS": "1" to env to expose every API endpoint as its own tool.

🧰 Tools

| Tool | Purpose | |------|---------| | netcup_whoami · netcup_ping · netcup_maintenance | identity & health | | netcup_list_servers · netcup_get_server | inventory | | netcup_set_server_state | power ON / OFF / SUSPENDED | | netcup_list_snapshots · netcup_create_snapshot · netcup_revert_snapshot · netcup_delete_snapshot | snapshots | | netcup_get_rdns · netcup_set_rdns | reverse DNS | | netcup_list_ssh_keys · netcup_list_firewall_policies | keys & firewall | | netcup_list_tasks · netcup_get_task | async tasks | | netcup_server_metrics · netcup_list_interfaces | metrics & networking | | 🌟 netcup_list_endpoints · netcup_describe_endpoint · netcup_call_endpoint | universal access to all endpoints |

🔒 Safety on production infra

This operates live infrastructure. Destructive tools (netcup_set_server_state, netcup_revert_snapshot, netcup_delete_snapshot, and any destructive netcup_call_endpoint) should be confirmed with you before the assistant runs them — set up your client's approval prompts accordingly.

🛠️ Development

pip install -e ../netcup-cli      # the netcup-api core
pip install -e ".[dev]"
ruff check .                      # lint
pytest -q                         # offline tests

See [CLAUDE.md](./CLAUDE.md) for the tool model, hard constraints, and contribution rules.

> [!NOTE] > Until netcup-api is on PyPI, CI resolves it via the repo variable NETCUP_API_GIT > (set it to the netcup-cli git URL). See [CLAUDE.md](./CLAUDE.md).

📄 License

MIT © Antoine Chenais

Not affiliated with netcup GmbH. Use at your own risk on production infrastructure.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: fullya99
• Source: fullya99/netcup-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.