Skip to content
MCP server

Proximo — the governed client for Proxmox

Operate Proxmox through an AI agent with planned changes, receipts and undo

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Linux
Runs
Locally
Version
0.52.0
Listing updated
2 days ago

About Proximo — the governed client for Proxmox

Proximo — the governed client for Proxmox is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

Proximo is a governed client for the Proxmox family: PVE, PBS, PMG and PDM. Its idea is that an agent should be able to run a hypervisor without being able to wreck it. Every mutation first returns a recorded plan showing the verdict, the live target, the exact change and its blast radius. Changes need a confirm, and each produces a keyed, hash-chained receipt that audit_verify can check for edits, reordering and insertion.

Undo is built in where the platform allows: before a change the current record is captured so it can be restored through the vendor's own write. A command run inside a container can take a snapshot first and refuses to run if it cannot. That in-container lane is opt-in, with a fail-closed allowlist.

It exposes only six tools covering every address the four products publish, rather than one per endpoint, so the surface fits a small local model's context. The README advises starting with a read-only API token, and a doctor command reports what a token can do. It says there is no cloud and no phone-home, and the project is a community effort.

Install

Run in a terminal

claude mcp add proximo-proxmox -- uvx proximo-proxmox

Add to claude_desktop_config.json

{
  "mcpServers": {
    "proximo-proxmox": {
      "command": "uvx",
      "args": [
        "proximo-proxmox"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "proximo-proxmox": {
      "command": "uvx",
      "args": [
        "proximo-proxmox"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "proximo-proxmox": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "proximo-proxmox"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "proximo-proxmox": {
      "command": "uvx",
      "args": [
        "proximo-proxmox"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "proximo-proxmox": {
      "command": "uvx",
      "args": [
        "proximo-proxmox"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

audit_verify
Verify the audit ledger for edits, reordering and insertion.

What it does

Plan before change
Each mutation returns a recorded preview with blast radius before anything runs.
Tamper-evident ledger
HMAC-keyed, hash-chained receipts verified with audit_verify.
Undo from captured state
The prior record is stored and restored via the vendor's own write.
Six tools
One small surface spans PVE, PBS, PMG and PDM.
Guarded container commands
Opt-in allowlist and snapshot-first behaviour.
Read-only by default
Start with a read-only token; doctor checks token capabilities.

Good for

  • Diagnose why a container is thrashing
  • Apply a change with a plan and receipt
  • Roll back a modification from a receipt
  • Audit what an agent changed on a hypervisor
  • Cover Proxmox Backup and Mail Gateway from one client

Pricing

Open source

Free, community project

Proximo — the governed client for Proxmox FAQ

Can an agent change things without approval?

No mutation runs on the first call; it returns a plan, and one confirm call records and performs it.

Does it phone home?

The README says there is no cloud, no phone-home and no standing server unless you opt in.

How is the token supplied?

As a file path in PROXIMO_TOKEN_PATH, so the secret never lands in client config.

How can I verify the artifact?

The README points to signed images, PyPI provenance, an SBOM and an OpenSSF Scorecard.

Is Proximo — the governed client for Proxmox free?

Yes. Proximo — the governed client for Proxmox is open source, so you can use and self-host it for free.

How do I add Proximo — the governed client for Proxmox to Claude Code?

Run this command in your terminal: claude mcp add proximo-proxmox -- uvx proximo-proxmox

What are the best alternatives to Proximo — the governed client for Proxmox?

The closest alternatives to Proximo — the governed client for Proxmox are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

Alternatives to Proximo — the governed client for Proxmox

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security