Proxmox MCP Server

List all VMs and containers across all Proxmox nodes.

Returns a list of all virtual machines and LXC containers with their basic information including:

• vmid: The VM/container ID

• name: The VM/container name

• status: Current status (running, stopped, etc.)

• node: The Proxmox node hosting this VM

• type: 'qemu' for VMs or 'lxc' for containers

• cpu: Number of CPUs

• maxmem: Maximum memory in bytes

• maxdisk: Maximum disk size in bytes

Get detailed information about a specific VM or container.

Args: vmid: The VM or container ID (e.g., 100, 101) node: The Proxmox node name. If not provided, will search all nodes.

Returns detailed configuration including:

• Hardware: CPU, memory, disks, network interfaces

• Settings: Boot order, OS type, description

• Status: Current state, uptime, resource usage

Get the current runtime status of a VM or container.

Args: vmid: The VM or container ID node: The Proxmox node name (optional, will auto-detect)

Returns:

• status: running, stopped, paused, etc.

• uptime: How long the VM has been running

• cpu: Current CPU usage percentage

• memory: Current memory usage

• network I/O stats

• disk I/O stats

Get historical metrics/performance data for a VM.

Args: vmid: The VM or container ID node: The Proxmox node name (optional) timeframe: Time range for metrics - one of: - 'hour': Last hour (default) - 'day': Last 24 hours - 'week': Last 7 days - 'month': Last 30 days - 'year': Last year

Returns time-series data including:

• CPU usage over time

• Memory usage over time

• Network I/O over time

• Disk I/O over time

List all Proxmox nodes in the cluster.

Returns information about each node including:

• Node name and status

• CPU and memory resources

• Running VMs count

• Uptime

List all snapshots for a VM.

Args: vmid: The VM ID node: The Proxmox node name (optional, will auto-detect)

Returns list of snapshots with:

• Snapshot name and description

• Creation time

• Whether it includes RAM state

Get overall Proxmox cluster status and health.

Returns:

• Cluster name and quorum status

• List of all nodes with their status

• Total resources (CPU, memory, storage)

Get filesystem/disk space information from inside a VM using the QEMU guest agent.

This requires the qemu-guest-agent to be installed and running inside the VM. Install it with: apt install qemu-guest-agent (Debian/Ubuntu) or yum install qemu-guest-agent (RHEL/CentOS)

Args: vmid: The VM ID node: The Proxmox node name (optional, will auto-detect)

Returns filesystem information including:

• Mount points

• Total size

• Used space

• Free space

• Filesystem type