MCP server for managing Proxmox VE infrastructure, providing tools for cluster management, virtual machines, containers, storage, backups, snapshots, networking, and firewall configuration
28 tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Most tools have 1-2 required parameters with type and description, meeting minimum baseline. However, 14 tools lack any description of what they return, and many descriptions are generic (10-30 chars). No tool annotations (readOnlyHint/destructiveHint) despite clear risk stratification. Parameter descriptions are minimal, e.g., 'Name of the node' repeated 20+ times without context on format or constraints. No pagination support documented for list operations (get_nodes, get_vms, get_containers). Error handling and recovery guidance absent. Composition is reasonable (verb_noun naming, single responsibility), but output chaining IDs missing, e.g., get_vms returns VM list but unclear if vmid is included for downstream start_vm calls.
Clone an existing virtual machine
Create a new virtual machine
Create a VM with advanced configuration options
Create a snapshot of a virtual machine
Delete a virtual machine
Get all cluster resources (nodes, VMs, containers)
Get cluster-wide status information
No output schemas documented. Tools return data but LLMs cannot infer field names, types, or structure. E.g., get_vms returns a list but unclear if each item includes vmid, name, status, memory, or other fields needed for downstream tool calls.
Missing tool annotations. 14 WRITE/DESTRUCTIVE tools (start_vm, delete_vm, create_vm, etc.) lack readOnlyHint/destructiveHint/idempotentHint annotations. LLMs cannot distinguish safe reads from dangerous mutations without explicit hints.
Generic parameter descriptions repeated 20+ times. 'Name of the node' appears identically for node_name in get_node_status, get_node_storage, get_vms, etc. No guidance on format, constraints, or how to obtain a valid node name.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | <=2025-11-25 | v2 |
Get detailed status of a specific container
Get all containers on a specific node
Get detailed status information for a specific node
Get storage devices for a specific node
Get all nodes in the Proxmox cluster
Get all storage devices in the cluster
Get full configuration of a virtual machine
Get console access information for a VM
Get detailed status of a specific VM
Get all VMs on a specific node
Reboot an LXC container
Reboot a virtual machine
Resume a suspended virtual machine
Gracefully shutdown an LXC container
Gracefully shutdown a virtual machine
Start an LXC container
Start a virtual machine
Stop an LXC container (immediate)
Stop a virtual machine (immediate)
Suspend (pause) a virtual machine
Update virtual machine configuration (e.g., mark as template)
No error handling or recovery guidance. Tools lack descriptions of failure modes, retryability, or what the LLM should do if a call fails. E.g., delete_vm with force=true could fail if VM is locked, no guidance on recovery.
No pagination support documented. List tools (get_nodes, get_vms, get_containers, get_storage) lack limit, offset, or cursor parameters. Large clusters could return thousands of items, exhausting context window.