Skip to main content
Glama
MTDEV2312

Proxmox VE MCP Server

by MTDEV2312

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PROXMOX_HOSTYesHost address and port of Proxmox VE instance
PROXMOX_USERNoProxmox VE user identityuser@Permisions
PROXMOX_TIMEOUTNoHTTP request timeout in seconds30.0
PROXMOX_PASSWORDNoUser password for API ticket authentication
PROXMOX_TOKEN_IDNoAPI Token ID (takes precedence if provided)
MCP_AUDIT_ENABLEDNoEnable JSON lines structured audit loggingtrue
MCP_AUDIT_LOG_PATHNoPath to append structured audit recordsaudit.log
PROXMOX_VERIFY_SSLNoVerify TLS certificatesfalse
PROXMOX_MAX_RETRIESNoMaximum retry attempts on transient network errors3
MCP_PERMISSION_LEVELNoBaseline permission scope (read_only, operator, admin)operator
PROXMOX_TOKEN_SECRETNoAPI Token Secret key
MCP_ALLOWED_CLIENT_IPSNoComma-separated CIDR subnets allowed to execute MCP commands

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_vmsB

List all QEMU virtual machines on a specified node.

get_vm_statusC

Fetch detailed runtime status of a QEMU virtual machine.

get_vm_configC

Fetch configuration settings of a QEMU virtual machine.

create_vmC

Create a new QEMU virtual machine on a specified node.

clone_vmB

Clone an existing virtual machine or template.

migrate_vmC

Migrate a virtual machine to another node in the cluster.

delete_vmA

Delete a QEMU virtual machine and purge resources. DESTRUCTIVE: Requires confirm=True.

start_vmB

Start a stopped QEMU virtual machine.

stop_vmA

Forcefully stop (power off) a QEMU virtual machine. DESTRUCTIVE: Requires confirm=True.

shutdown_vmA

Gracefully shutdown a QEMU virtual machine via ACPI signal.

reboot_vmC

Reboot a running QEMU virtual machine.

pause_vmB

Pause execution of a running QEMU virtual machine.

resume_vmB

Resume execution of a paused QEMU virtual machine.

suspend_vmC

Suspend virtual machine state to disk.

template_vmB

Convert a QEMU virtual machine to a reusable template.

update_cpu_vmC

Update CPU core and socket allocation of a virtual machine.

update_memory_vmB

Update RAM memory size and ballooning configuration of a VM.

resize_vm_diskC

Extend the capacity of a virtual machine disk.

add_vm_diskC

Attach a new virtual disk volume to a VM.

move_vm_diskB

Move a virtual machine disk to a different storage pool.

get_cloudinit_config_vmB

Fetch Cloud-Init configuration settings of a virtual machine.

configure_cloudinit_vmC

Configure Cloud-Init settings for automated OS setup.

regenerate_cloudinit_vmC

Regenerate the Cloud-Init drive image for a VM.

list_snapshots_vmB

List all snapshots for a specified virtual machine.

create_snapshot_vmC

Create a snapshot of a virtual machine.

rollback_snapshot_vmA

Rollback virtual machine state to a snapshot. DESTRUCTIVE: Requires confirm=True.

delete_snapshot_vmA

Delete a virtual machine snapshot. DESTRUCTIVE: Requires confirm=True.

list_containersA

List all LXC containers on a specified node.

get_container_statusB

Fetch detailed runtime status of an LXC container.

get_container_configC

Fetch configuration settings of an LXC container.

create_containerC

Create a new LXC container. Default unprivileged=True.

clone_containerC

Clone an existing LXC container or template.

template_containerB

Convert an LXC container to a reusable template.

delete_containerA

Delete an LXC container and purge resources. DESTRUCTIVE: Requires confirm=True.

start_containerA

Start a stopped LXC container.

stop_containerA

Forcefully stop an LXC container. DESTRUCTIVE: Requires confirm=True.

shutdown_containerB

Gracefully shutdown an LXC container. DESTRUCTIVE: Requires confirm=True.

restart_containerA

Reboot/restart an LXC container. DESTRUCTIVE: Requires confirm=True.

resize_container_diskC

Extend rootfs or disk capacity of an LXC container.

update_resources_containerC

Update CPU cores, memory, or swap resources of an LXC container.

configure_features_containerC

Configure feature flags (nesting, keyctl, fuse) for an LXC container.

add_bind_mount_containerB

Add a mount point or bind mount to an LXC container.

remove_bind_mount_containerA

Remove a mount point from an LXC container. DESTRUCTIVE: Requires confirm=True.

configure_network_containerC

Configure network adapter settings for an LXC container.

configure_dns_containerC

Update DNS nameserver and searchdomain settings for an LXC container.

list_snapshots_containerA

List all snapshots for an LXC container.

create_snapshot_containerB

Create a snapshot of an LXC container.

rollback_snapshot_containerA

Rollback LXC container state to a snapshot. DESTRUCTIVE: Requires confirm=True.

delete_snapshot_containerA

Delete an LXC container snapshot. DESTRUCTIVE: Requires confirm=True.

cluster_healthA

Fetch aggregated health summary, node counts, VM counts, and CPU/memory utilization of the Proxmox cluster.

cluster_resourcesA

Fetch resource list across the Proxmox cluster with optional type filtering (node, qemu, lxc, storage).

list_nodesA

List all nodes in the Proxmox cluster with status and resource utilization.

node_statusA

Fetch detailed hardware metrics, CPU/memory usage, kernel version, and status for a specific node.

list_storageA

List storage pools globally or for a specific node, including type, status, and calculated space usage.

storage_contentA

List volume items (VM disks, ISOs, LXC templates, backups) inside a storage pool on a node with optional content_type filter.

storage_statusA

Fetch capacity, total/used bytes, and detailed status for a specific storage pool on a node.

recent_tasksB

List recent asynchronous background tasks globally or for a specific node, with optional status and limit filters.

task_statusA

Fetch status and exit status of an asynchronous Proxmox background task by UPID.

run_provisioning_workflowC

Execute multi-step VM or LXC container provisioning with automated step tracing and failure rollback.

run_bulk_operationA

Execute batch lifecycle actions (start, stop, shutdown, pause, resume) across VMs or LXC containers matching filters.

run_backup_flowA

Execute multi-step backup workflow: storage pre-checks, pre-backup snapshotting, vzdump execution, and cleanup.

run_cluster_checkA

Aggregate cluster readiness state including node health, quorum state, storage space, and task health.

check_client_ipA

Verify whether a given client IP address is allowed by the security policy whitelist.

audit_security_rulesA

Fetch current security audit status, CIDR rules, and sensitive key scrubbing configuration.

get_security_summaryA

Retrieve security policy configuration and status summary.

Prompts

Interactive templates invoked by user choice

NameDescription
provision_vmPrompt template guiding VM provisioning workflow.
vm_snapshot_workflowPrompt template guiding VM snapshot maintenance workflow.
cloudinit_configPrompt template guiding Cloud-Init configuration and drive setup workflow.
provision_containerPrompt template guiding LXC container provisioning workflow.
lxc_troubleshootingPrompt template guiding LXC container diagnostic and troubleshooting workflow.
lxc_snapshot_workflowPrompt template guiding LXC container snapshot maintenance workflow.
cluster_diagnosticsPrompt template guiding cluster health and diagnostic review.
node_diagnosticsPrompt template guiding node diagnostic and resource inspection workflow.
storage_inspectionPrompt template guiding storage usage inspection workflow.
task_troubleshootingPrompt template guiding task log and UPID inspection workflow.
workflow_selectionPrompt template guiding interactive workflow selection and parameter gathering.
guided_provisioningPrompt template guiding structured VM or LXC container provisioning parameters.
security_auditPrompt template guiding runtime security policy audit and verification.
ip_permission_checkPrompt template guiding client IP access evaluation.

Resources

Contextual data attached and managed by the client

NameDescription
get_cluster_summary_resourceResource endpoint providing live JSON summary of cluster health and metrics.
get_cluster_health_resourceResource endpoint providing JSON health summary of the cluster.
get_security_status_resourceResource endpoint providing live JSON status of runtime security configuration and metrics.
get_security_policy_resourceResource endpoint providing active security policy configuration as JSON.
get_security_audit_summary_resourceResource endpoint providing audit summary statistics as JSON.

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/MTDEV2312/Proxmox_mcp'

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