Proximo — the governed client for Proxmox
Operate Proxmox through an AI agent with planned changes, receipts and undo
- 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-proxmoxAdd to claude_desktop_config.json
{
"mcpServers": {
"proximo-proxmox": {
"command": "uvx",
"args": [
"proximo-proxmox"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"proximo-proxmox": {
"command": "uvx",
"args": [
"proximo-proxmox"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security
Zero-log MCP server with 49 tools for AI guardrails, secret scanning and EU compliance
- 49 tools
- Remote
- Freemium
- Security

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security