Skip to main content
Glama
soyrageagency

Proxmox MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PROXMOX_HOSTNoAPI base URL, e.g. https://192.168.1.10:8006
PROXMOX_USERNouser@realm for ticket auth (used only if no token)
PROXMOX_MCP_DEMONoServe fabricated demo data (no real host needed)false
PROXMOX_PASSWORDNoPassword for ticket auth
PROXMOX_TOKEN_IDNoAPI token id user@realm!tokenname (recommended)
PROXMOX_MCP_CONFIGNoPath to the optional JSON config fileproxmox-mcp.config.json
PROXMOX_VERIFY_TLSNoVerify the node's TLS certificatefalse
PROXMOX_MCP_PLUGINSNoLoad only these plugins (empty = all)
PROXMOX_MCP_READONLYNoHide all state‑changing toolsfalse
PROXMOX_TOKEN_SECRETNoAPI token secret (UUID)
PROXMOX_MCP_ALLOWLISTNoComma‑separated VMIDs/names the AI may touch (empty = all)
PROXMOX_MCP_LOG_LEVELNodebug | info | warn | errorinfo
PROXMOX_MCP_DISABLED_PLUGINSNoDisable these plugins

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_pluginsA

Show the modular capability plugins this server exposes and whether each is currently enabled.

aboutA

Show who built this Proxmox MCP Server and how it is licensed. Call this to greet the user with the SoyRage Agency welcome banner.

list_nodesA

List the Proxmox VE cluster nodes with their online status, CPU load and memory usage. The best starting point to understand the cluster.

node_statusA

Detailed status for a single node: CPU/memory/swap, load average, uptime, kernel and PVE versions.

list_guestsA

List all QEMU virtual machines and LXC containers across the cluster with their VMID, type, node, status and live CPU/memory. Optionally filter by kind ('qemu' or 'lxc') or only running guests.

guest_statusA

Live runtime status of a single VM or container: run state, CPU %, memory, disk, uptime and (for VMs) QEMU guest-agent availability.

guest_configA

Return the full configuration of a VM or container (cores, memory, disks, network interfaces, boot order, …).

guest_osinfoA

What operating system does a guest run? Returns the configured OS type and, for running QEMU VMs with the guest agent, the detected OS name/version and IP addresses. Answers 'what OS is VMID 101?'.

list_storageA

List the storages configured on a node — type (dir/lvm/zfs/ceph/nfs…), what content they hold, and how full they are.

list_tasksA

List the most recent tasks on a node (VM starts, backups, migrations, snapshots…) with their type, status and who ran them. Great for answering 'what happened on this node lately?'.

cluster_statusA

Report cluster membership and quorum: each node's online state and whether the cluster is quorate. On a single node it reports standalone.

cluster_resourcesA

A single consolidated view of the cluster's resources — nodes, VMs, containers and storage — with status and utilisation. Filter by type.

list_snapshotsA

List the snapshots of a VM or container, including their name, parent and description. The synthetic 'current' entry marks the live state.

create_snapshotA

Take a snapshot of a VM or container. Optionally include the VM's RAM (vmstate) so it can be resumed exactly.

rollback_snapshotA

Revert a VM or container to a snapshot. This is DESTRUCTIVE — any changes made since the snapshot are lost. Confirm with the user first.

delete_snapshotB

Remove a snapshot from a VM or container.

start_guestA

Power on a VM or container. No-op if it is already running.

shutdown_guestA

Gracefully shut down a VM or container via ACPI/guest OS. This is the safe way to power off — prefer it over stop_guest.

stop_guestA

Immediately stop a VM or container — equivalent to pulling the power cord. May cause data loss; prefer shutdown_guest. Confirm first.

reboot_guestA

Gracefully reboot a running VM or container.

suspend_guestA

Suspend (pause) a running VM — freezes it in RAM so it can be resumed instantly. Set toDisk to hibernate to disk instead.

resume_guestB

Resume a suspended/paused VM.

migrate_guestA

Migrate a VM or container to another cluster node. Running guests are migrated online (live) when possible.

clone_guestA

Clone a VM or container into a new one. Great for deploying from a template. full makes an independent full clone (vs. a linked clone).

set_guest_resourcesB

Quickly change a guest's CPU cores and/or memory. For VMs, memory is in MB. Some changes need a reboot to take effect.

backup_guestA

Create a backup of a VM or container to a storage using vzdump. mode snapshot (default, no downtime), suspend, or stop.

delete_guestA

PERMANENTLY destroy a VM or container and its disks. IRREVERSIBLE. You must pass confirm equal to the guest's VMID to proceed.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/soyrageagency/proxmox-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server