servers / proximo
proximo MCP server
communitystdiolocalunknownhealthy
The Proxmox MCP you can hand the keys: VE/PBS/PMG/PDM. Plan, prove, undo, diagnose. MCP/A2A/API.
01Tools · 7
How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.
| Tool | Risk | Side effects | Approval |
|---|---|---|---|
| audit_entries READ-ONLY: WHO changed WHAT and WHEN — guest configuration changes and every other
audited action, read back from the PROVE ledger.
Newest first. This is how you answer "who changed this guest" or "what has this caller
done". `matched` counts entries passing your filters, `total` counts the whole ledger,
and `truncated` says so when `limit` cut rows. An entry with no principal returns null
plus a note: the ledger not capturing an identity is a fact about the log, never a claim
that nobody was responsible. This READS the chain; `audit_verify` PROVES it is intact.
| read | false | unknown |
| audit_verify Verify the tamper-evident audit ledger's hash chain — PROVE the log is intact.
Pass `expected_head` (the head() value you pinned off-box) to also catch tail
truncation, a forged tail-append, or a full file replacement — a forward walk
alone can't see those. Falls back to PROXIMO_AUDIT_EXPECTED_HEAD when omitted.
| unknown | unknown | unknown |
| proximo_call Call any Proximo tool by exact name, including ones not in this server's listed tools.
Get the argument shape from proximo_tool_schema first. Same gates as calling it directly:
dry-run PLAN, ledger entry, token ACL. A smaller doorway, not a looser one.
| read | false | unknown |
| proximo_find_tools Search Proximo's full tool catalog by keyword.
ESTATE QUESTIONS FIRST: if the question is what exists, how many, what changed, or when something last happened, call proximo_recall instead — it answers from local memory in one call, with no search and no schema lookup, and it stamps how old the answer is. Come here for everything else.
The facade is resident; 906 more tools on this server are searchable but not. Search for what you want ("guest power", "ceph pool", "firewall"), then call proximo_tool_schema on a result to get its arguments, then proximo_read (read-only tools) or proximo_call to run it. All terms must match. | read | false | unknown |
| proximo_read READ-ONLY: run a read-only Proximo tool by exact name; refuses anything that can
mutate (use proximo_call for those). Same flow: get the shape from proximo_tool_schema
first. | read | false | unknown |
| proximo_recall READ-ONLY: the estate map from local Tier-1 memory — NOT a live PVE read. Returns
total/by_kind/by_status/guest_summary counts (trust guest_summary for guest-count questions;
all counting is server-side) plus lean entity rows, stamped {source:'memory', as_of,
age_seconds}: the data is as old as the stamp says. With `since`, also diffs: appeared,
status_changed, and not_seen_since (last observed before the window — a fact, not a claim
the entity is gone). journal=N adds the newest N diagnosis digests ("when did this last
happen") — findings summaries only, never raw diagnostic output. Memory is on by default
(PROXIMO_MEMORY=0 opts out), fed opportunistically by list reads and diagnose/doctor runs,
derived and rebuildable. For live state use pve_list_guests / pve_cluster_resources. | read | false | unknown |
| proximo_tool_schema Full description + JSON input schema for one tool found via proximo_find_tools. | unknown | unknown | unknown |
02Install & source
uvx proximo-proxmox
uvxdocker run ghcr.io/john-broadway/proximo:latest
docker- repohttps://github.com/john-broadway/proximo
- licenseApache-2.0
- adoption47 stars · 8 forks
05Provenance & freshness
sourcesGitHub repo search [p4]
last_checked2026-09-20 14:00Z
next_check2026-09-20 17:00Z
cadenceevery 3h
verifiedmetadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed metadata:passed
index_statusindex — 8 unique facts >= 5
06Badge
Add the “as seen on MCPExplorer” badge to your README.
[](https://mcpexplorer.com/servers/proximo)
Next step
This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.
Explore loadouts →