Sign inSign up

mcp/proxmox

Verified Publisher

By mcp

•Updated 3 months ago

Manage Proxmox VE infrastructure including virtual machines, containers, storage, networking, fir...

Image
Machine learning & AI
3

10K+

mcp/proxmox repository overview

⁠Proxmox VE MCP Server

Manage Proxmox VE infrastructure including virtual machines, containers, storage, networking, firewall rules, high availability, and more.

What is an MCP Server?⁠

⁠MCP Info

⁠Image Building Info

AttributeDetails
Dockerfilehttps://github.com/GethosTheWalrus/proxmox-mcp/blob/060b7f5bbbf14bb69f1dac928f1566125e0b03b5/Dockerfile⁠
Commit060b7f5bbbf14bb69f1dac928f1566125e0b03b5
Docker Image built byDocker Inc.
Docker Scout Health ScoreDocker Scout Health Score
Verify SignatureCOSIGN_REPOSITORY=mcp/signatures cosign verify mcp/proxmox --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
LicenceOther

⁠Available Tools (286)

Tools provided by this ServerShort Description
add_firewall_ipset_entryAdd an IP/CIDR to an IP set.
allocate_storage_volumeAllocate a new disk volume in storage.
apply_sdn_changesApply pending SDN configuration changes to all nodes.
bulk_migrate_guestsBulk migrate guests to a target node.
bulk_shutdown_guestsBulk shutdown guests across the cluster.
bulk_start_guestsBulk start guests across the cluster.
change_passwordChange a user's password.
clone_containerClone a container.
clone_vmClone a VM to create a new one.
convert_container_to_templateConvert a container into a template (irreversible).
convert_vm_to_templateConvert a VM into a template (irreversible).
create_backup_jobCreate a scheduled backup job.
create_ceph_osdCreate a new Ceph OSD on a device.
create_ceph_poolCreate a new Ceph pool.
create_cluster_firewall_ruleCreate a cluster-level firewall rule.
create_containerCreate a new LXC container.
create_container_firewall_ruleCreate a firewall rule for an LXC container.
create_container_snapshotCreate a snapshot of a container.
create_directory_storageCreate a directory-based storage mount from a device.
create_firewall_aliasCreate a firewall alias (named IP address or CIDR).
create_firewall_groupCreate a new firewall security group.
create_firewall_group_ruleAdd a rule to a firewall security group.
create_firewall_ipsetCreate a new firewall IP set.
create_groupCreate a new group.
create_ha_groupCreate an HA group.
create_ha_resourceAdd a resource to HA management.
create_lvmCreate a new LVM volume group on a device.
create_lvmthinCreate a new LVM thin pool.
create_node_network_interfaceCreate a network interface on a node.
create_poolCreate a resource pool.
create_replication_jobCreate a storage replication job.
create_roleCreate a new role with specific privileges.
create_sdn_subnetCreate a subnet for an SDN VNet.
create_sdn_vnetCreate an SDN VNet.
create_sdn_zoneCreate an SDN zone.
create_storageCreate a new storage pool configuration.
create_userCreate a new user.
create_user_tokenCreate a new API token for a user.
create_vmCreate a new QEMU virtual machine.
create_vm_firewall_ruleCreate a firewall rule for a QEMU VM.
create_vm_snapshotCreate a snapshot of a VM.
create_vzdumpStart an immediate backup (vzdump) on a node.
create_zfs_poolCreate a new ZFS pool.
delete_backup_jobDelete a scheduled backup job.
delete_cluster_firewall_ruleDelete a cluster-level firewall rule.
delete_containerDelete a container.
delete_container_snapshotDelete a container snapshot.
delete_firewall_aliasDelete a firewall alias.
delete_firewall_ipset_entryRemove an IP/CIDR from an IP set.
delete_groupDelete a group.
delete_ha_groupDelete an HA group.
delete_ha_resourceRemove a resource from HA management.
delete_poolDelete a resource pool.
delete_replication_jobDelete a replication job.
delete_roleDelete a role.
delete_sdn_vnetDelete an SDN VNet.
delete_sdn_zoneDelete an SDN zone.
delete_storageDelete a storage pool configuration (does not delete data on the backend).
delete_storage_volumeDelete a volume from storage.
delete_userDelete a user.
delete_user_tokenDelete an API token.
delete_vmDelete a VM.
delete_vm_snapshotDelete a VM snapshot.
download_appliance_templateDownload an appliance template to local storage.
download_file_restoreDownload a file from a vzdump backup.
download_url_to_storageDownload a file from a URL directly to storage (ISO, template, etc.).
dump_vm_cloudinitDump the Cloud-Init generated config file (user-data, network-data, or meta-data).
get_aclGet the full ACL (access control list) — shows all permission assignments.
get_acme_accountGet ACME account details.
get_acme_directoriesList known ACME directory URLs.
get_acme_pluginGet ACME plugin configuration.
get_acme_tosGet the ACME Terms of Service URL.
get_auth_domainGet authentication domain configuration.
get_backup_jobGet details of a specific backup job.
get_backup_job_included_volumesGet volumes included in a backup job.
get_ceph_configGet the raw Ceph configuration.
get_ceph_crush_rulesGet Ceph CRUSH rules.
get_ceph_flagsGet Ceph global flags (noout, noscrub, etc.).
get_ceph_metadataGet Ceph metadata (versions, services across nodes).
get_ceph_status_clusterGet Ceph cluster status (health, monitors, OSDs, PGs).
get_ceph_status_nodeGet Ceph status from a specific node's perspective.
get_cluster_configGet the current cluster configuration (corosync, nodes, join info).
get_cluster_config_nodesList nodes configured in the cluster.
get_cluster_firewall_optionsGet cluster-wide firewall options (enable, policy_in, policy_out, etc.).
get_cluster_firewall_ruleGet a specific cluster firewall rule.
get_cluster_join_infoGet info needed to join a node to this cluster.
get_cluster_logGet the cluster log (recent events).
get_cluster_optionsGet datacenter/cluster-wide options (keyboard layout, console, language, etc.).
get_cluster_resourcesList all resources across the cluster (VMs, containers, storage, nodes).
get_cluster_statusGet cluster status (nodes online, quorum, HA state).
get_cluster_tasksList recent tasks across all nodes in the cluster.
get_cluster_totemGet the corosync totem configuration.
get_container_configGet the configuration of a container.
get_container_featureCheck if a feature is available for a container (snapshot, clone, copy).
get_container_firewall_optionsGet firewall options for an LXC container.
get_container_interfacesGet network interfaces and IPs of a running container.
get_container_pendingGet pending configuration changes for a container.
get_container_rrddataGet RRD statistics data for a container (CPU, memory, disk, network over time).
get_container_statusGet the current runtime status of a container.
get_disk_smartGet S.M.A.R.T.
get_firewall_group_rulesList rules in a firewall security group.
get_firewall_refsGet available firewall references (aliases, ipsets, names usable in rules).
get_groupGet group details.
get_ha_groupGet HA group configuration.
get_ha_manager_statusGet detailed HA manager status.
get_ha_resourceGet HA resource configuration.
get_ha_statusGet HA manager status (active, quorum, manager status).
get_metric_serverGet metric server configuration.
get_next_vmidGet the next available VMID in the cluster.
get_node_aplinfoList available appliance templates (LXC templates) that can be downloaded.
get_node_apt_updateList available package updates on a node.
get_node_capabilities_qemuGet QEMU capabilities for a node: supported CPU models, machine types, etc.
get_node_certificatesGet certificate info for a node.
get_node_configGet the configuration of a node (description, wakeonlan, etc.).
get_node_disksList physical disks on a node.
get_node_dnsGet DNS settings for a node.
get_node_firewall_logGet firewall log for a node.
get_node_firewall_optionsGet firewall options for a specific node.
get_node_hardware_pciList PCI hardware devices on a node (for passthrough).
get_node_hardware_usbList USB hardware devices on a node.
get_node_hostsGet the /etc/hosts file content for a node.
get_node_journalRead systemd journal entries from a node.
get_node_netstatGet network statistics for a node (per-interface traffic).
get_node_networkGet network interface configuration for a node.
get_node_network_interfaceGet details for a specific network interface.
get_node_reportGenerate a system report for a node (useful for diagnostics).
get_node_statusGet detailed status of a specific node including CPU, memory, disk, uptime, and kernel info.
get_node_storage_scanScan for available storage targets (NFS, CIFS, iSCSI, LVM, ZFS, PBS).
get_node_storage_statusGet usage status of a storage pool on a node (total, used, available).
get_node_subscriptionGet subscription status for a node.
get_node_syslogRead system log (syslog) entries from a node.
get_node_timeGet the current time and timezone of a node.
get_node_versionGet Proxmox VE version information for a specific node.
get_permissionsCheck effective permissions for a user on a given path.
get_poolGet pool configuration and members.
get_replication_jobGet a specific replication job configuration.
get_roleGet role details and its privileges.
get_sdn_controllerGet SDN controller configuration.
get_sdn_ipamGet IPAM plugin configuration.
get_sdn_vnetGet SDN VNet configuration.
get_sdn_zoneGet SDN zone configuration.
get_storage_configGet configuration of a specific storage pool.
get_storage_rrddataGet RRD statistics for a storage pool (usage over time).
get_storage_volume_infoGet details about a specific volume in storage.
get_task_logGet log output of a specific task.
get_task_statusGet the status of a specific task by its UPID.
get_userGet details for a specific user.
get_user_tokenGet details for a specific API token.
get_versionGet the Proxmox VE API version information.
get_vm_cloudinitGet Cloud-Init configuration for a VM.
get_vm_configGet the configuration of a VM.
get_vm_featureCheck if a specific feature is available/supported for a VM (e.g.
get_vm_firewall_optionsGet firewall options for a QEMU VM.
get_vm_pendingGet pending configuration changes for a VM (not yet applied).
get_vm_rrddataGet RRD statistics data for a VM (CPU, memory, disk, network over time).
get_vm_snapshot_configGet the configuration stored in a VM snapshot.
get_vm_spiceproxyCreate a SPICE proxy connection for a VM console.
get_vm_statusGet the current runtime status of a VM (state, CPU, memory, disk, network, uptime).
get_vm_vncproxyCreate a VNC proxy connection ticket for a VM (for console access).
get_vzdump_defaultsGet the default vzdump configuration for a node.
get_vzdump_extractconfigExtract the guest configuration from a vzdump backup archive.
get_zfs_poolGet details of a ZFS pool.
initialize_gptInitialize a disk with GPT partition table (WARNING: destroys all data).
join_clusterJoin a node to an existing cluster.
list_acme_accountsList ACME (Let's Encrypt) accounts.
list_acme_pluginsList ACME DNS challenge plugins.
list_auth_domainsList configured authentication realms/domains (PAM, PVE, LDAP, AD, OpenID).
list_backup_file_restoreList files in a vzdump backup for single-file restore.
list_backup_jobsList all scheduled backup jobs (vzdump) in the cluster.
list_ceph_fsList CephFS filesystems.
list_ceph_managersList Ceph managers.
list_ceph_mdsList Ceph metadata servers (MDS, for CephFS).
list_ceph_monitorsList Ceph monitors.
list_ceph_osdsList Ceph OSDs on a node.
list_ceph_poolsList Ceph pools.
list_cluster_firewall_rulesList cluster-level firewall rules.
list_container_firewall_rulesList firewall rules for an LXC container.
list_container_snapshotsList all snapshots of a container.
list_containersList all LXC containers on a node with status, memory, CPU, and disk info.
list_dir_mappingsList directory mappings.
list_directory_storageList directory-based storage mounts on a node.
list_file_restoreList files in a backup volume for file-level restore (PBS backups).
list_firewall_aliasesList cluster firewall aliases (named IP addresses/ranges).
list_firewall_groupsList firewall security groups (reusable sets of rules).
list_firewall_ipset_entriesList entries in a firewall IP set.
list_firewall_ipsetsList cluster firewall IP sets (named groups of IPs).
list_firewall_macrosList available firewall macros (predefined rule sets like SSH, HTTP, etc.).
list_groupsList all user groups.
list_ha_groupsList HA groups (define which nodes can run HA resources).
list_ha_resourcesList all HA-managed resources.
list_lvm_volumesList LVM volume groups on a node.
list_lvmthin_poolsList LVM thin pools on a node.
list_metric_serversList configured metric servers (InfluxDB, Graphite).
list_node_firewall_rulesList firewall rules for a node.
list_node_servicesList all system services on a node (pve, ssh, cron, etc.).
list_node_storageList storage pools available on a specific node with usage info.
list_node_tasksList recent tasks on a node.
list_nodesList all nodes in the Proxmox cluster with their status, CPU, memory, and uptime.
list_notification_endpointsList all configured notification endpoints (sendmail, gotify, smtp, webhook).
list_notification_matchersList all notification matchers (rules that route notifications).
list_notification_targetsList all notification targets.
list_pci_mappingsList PCI device mappings for passthrough.
list_poolsList all resource pools.
list_realm_sync_jobsList realm synchronization jobs.
list_replication_jobsList all replication jobs in the cluster.
list_rolesList all available roles.
list_scheduled_jobsList all scheduled cluster jobs (realm-sync, etc.).
list_sdn_controllersList SDN controllers (e.g.
list_sdn_dnsList SDN DNS plugins.
list_sdn_ipamsList IPAM (IP Address Management) plugins.
list_sdn_subnetsList subnets for an SDN VNet.
list_sdn_vnetsList SDN virtual networks (VNets).
list_sdn_zonesList SDN zones.
list_storageList all configured storage pools at the datacenter level.
list_storage_contentList content of a storage pool (disk images, ISOs, templates, backups).
list_tfaList TFA (two-factor auth) entries.
list_usb_mappingsList USB device mappings for passthrough.
list_user_tokensList API tokens for a user.
list_usersList all users in Proxmox.
list_vm_firewall_rulesList firewall rules for a QEMU VM.
list_vm_snapshotsList all snapshots of a VM.
list_vmsList all QEMU virtual machines on a node with status, memory, CPU, and disk info.
list_zfs_poolsList ZFS pools on a node.
manage_node_serviceStart, stop, restart, or reload a system service on a node.
migrate_containerMigrate a container to another node.
migrate_ha_resourceRequest migration of an HA resource to a different node.
migrate_vmMigrate a VM to another node in the cluster.
move_container_volumeMove a container volume to different storage or to another container.
move_vm_diskMove a VM disk to different storage or attach to another VM.
order_node_certificateOrder/renew ACME certificate for a node.
proxmox_api_rawMake an arbitrary Proxmox API call for any endpoint not covered by specific tools.
prune_storage_backupsPrune (delete) old backups from storage according to retention policy.
reboot_containerReboot a container.
reboot_vmReboot a VM via ACPI.
register_acme_accountRegister a new ACME account.
relocate_ha_resourceRequest relocation of an HA resource to a different node.
reset_vmHard reset a VM (like pressing the reset button).
resize_container_diskResize a container disk/volume.
resize_vm_diskResize a VM disk.
resume_containerResume a suspended container.
resume_vmResume a suspended/paused VM.
rollback_container_snapshotRollback a container to a previous snapshot.
rollback_vm_snapshotRollback a VM to a previous snapshot (current state will be lost).
run_apt_updateRefresh the package index on a node (apt update).
send_vm_keySend a key event to a VM (e.g.
send_vm_monitor_commandSend a QEMU monitor command to a VM (advanced/low-level).
set_ceph_flagsSet a Ceph global flag.
set_cluster_firewall_optionsSet cluster-wide firewall options.
set_node_firewall_optionsSet firewall options for a node.
set_vm_firewall_optionsSet firewall options for a QEMU VM.
shutdown_containerGracefully shut down a container.
shutdown_vmGracefully shut down a VM via ACPI.
start_containerStart a container.
start_vmStart a VM.
startall_nodeStart all VMs and containers on a node (respecting boot order).
stop_containerHard-stop a container (immediate, like power off).
stop_taskStop (abort) a running task.
stop_vmHard-stop a VM (like pulling the power plug).
stopall_nodeStop all VMs and containers on a node.
suspend_containerSuspend (freeze) a container.
suspend_vmSuspend a VM (pause execution or hibernate to disk).
sync_auth_domainSync users/groups from an external auth domain (LDAP/AD).
test_notification_targetSend a test notification to a target.
update_aclAdd or remove ACL entries (permission assignments).
update_backup_jobUpdate a scheduled backup job.
update_cluster_firewall_ruleUpdate a cluster-level firewall rule.
update_cluster_optionsUpdate datacenter/cluster-wide options.
update_container_configUpdate the configuration of an existing container.
update_groupUpdate a group.
update_ha_groupUpdate an HA group.
update_ha_resourceUpdate an HA resource configuration.
update_poolUpdate a resource pool (add/remove members).
update_roleUpdate role privileges.
update_sdn_vnetUpdate an SDN VNet.
update_storageUpdate an existing storage pool configuration.
update_userUpdate an existing user.
update_vm_cloudinitSet Cloud-Init parameters for a VM (user, password, SSH keys, network).
update_vm_configUpdate the configuration of an existing VM.
upload_to_storageUpload a file (ISO, template, etc.) to storage.
vm_agent_execExecute a command inside a VM via the QEMU Guest Agent.
vm_agent_exec_statusGet the status/result of a command previously executed via the guest agent.
vm_agent_file_readRead a file from inside a VM via the guest agent.
vm_agent_file_writeWrite content to a file inside a VM via the guest agent.
vm_agent_get_infoGet various system information from a VM via the guest agent.
vm_agent_set_passwordSet a user password inside a VM via the guest agent.
wakeonlan_nodeSend a Wake-on-LAN magic packet to a node.

⁠Tools Details

⁠Tool: add_firewall_ipset_entry

Add an IP/CIDR to an IP set.

ParametersTypeDescription
cidrstringIP address or CIDR.
namestringIP set name.
commentstring optionalDescription.
nomatchboolean optionalExclude this entry (nomatch).

⁠Tool: allocate_storage_volume

Allocate a new disk volume in storage.

ParametersTypeDescription
filenamestringVolume name.
nodestringThe node name.
sizestringVolume size (e.g. '10G').
storagestringThe storage ID.
vmidintegerVM ID to associate with.
formatstring optionalDisk format (raw, qcow2, vmdk). Auto-detected if empty.

⁠Tool: apply_sdn_changes

Apply pending SDN configuration changes to all nodes.

⁠Tool: bulk_migrate_guests

Bulk migrate guests to a target node.

ParametersTypeDescription
targetstringTarget node name.
vmsstring optionalComma-separated VMIDs.

⁠Tool: bulk_shutdown_guests

Bulk shutdown guests across the cluster.

ParametersTypeDescription
vmsstring optionalComma-separated list of VMIDs (empty = all).

⁠Tool: bulk_start_guests

Bulk start guests across the cluster.

ParametersTypeDescription
vmsstring optionalComma-separated list of VMIDs (empty = all).

⁠Tool: change_password

Change a user's password.

ParametersTypeDescription
passwordstringNew password.
useridstringUser ID (format: 'user@realm').

⁠Tool: clone_container

Clone a container.

ParametersTypeDescription
newidintegerID for the new container.
nodestringThe source node name.
vmidintegerThe source container ID.
descriptionstring optionalDescription.
fullboolean optionalFull clone (True) or linked clone (False).
hostnamestring optionalHostname for the clone.
poolstring optionalResource pool.
snapnamestring optionalSnapshot to clone from.
storagestring optionalTarget storage for full clone.
targetstring optionalTarget node (default: same node).

⁠Tool: clone_vm

Clone a VM to create a new one. Can be a full copy or linked clone.

ParametersTypeDescription
newidintegerThe VMID for the new clone.
nodestringThe source node name.
vmidintegerThe source VM ID.
descriptionstring optionalDescription for the clone.
fullboolean optionalFull clone (True) or linked clone (False).
namestring optionalName for the clone.
poolstring optionalResource pool.
snapnamestring optionalSnapshot name to clone from.
storagestring optionalTarget storage for full clone.
targetstring optionalTarget node for the clone (default: same node).

⁠Tool: convert_container_to_template

Convert a container into a template (irreversible).

ParametersTypeDescription
nodestringThe node name.
vmidintegerThe container ID.

⁠Tool: convert_vm_to_template

Convert a VM into a template (irreversible).

ParametersTypeDescription
nodestringThe node name.
vmidintegerThe VM ID.

⁠Tool: create_backup_job

Create a scheduled backup job.

ParametersTypeDescription
storagestringTarget storage ID for backups.
all_guestsboolean optionalBackup all guests.
commentstring optionalDescription.
compressstring optionalCompression: 'none', 'lzo', 'gzip', 'zstd'.
enabledboolean optionalEnable the job.
mailnotificationstring optional'always' or 'failure'.
mailtostring optionalComma-separated email addresses.
maxfilesinteger optionalMax backup files to keep (0 = unlimited, deprecated - use prune_backups).
modestring optionalBackup mode: 'snapshot', 'suspend', 'stop'.
nodestring optionalOnly back up guests on this node.
notes_templatestring optionalTemplate for backup notes.
prune_backupsstring optionalRetention schedule (e.g. 'keep-daily=7,keep-weekly=4').
schedulestring optionalSchedule in systemd calendar format (e.g. 'daily', 'weekly', '02:00').
vmidstring optionalComma-separated VMIDs to back up (if not all_guests).

⁠Tool: create_ceph_osd

Create a new Ceph OSD on a device.

ParametersTypeDescription
devstringBlock device for the OSD (e.g. '/dev/sdb').
nodestringThe node name.
db_devstring optionalSeparate block device for DB.
encryptedboolean optionalEncrypt the OSD.
wal_devstring optionalSeparate block device for WAL.

⁠Tool: create_ceph_pool

Create a new Ceph pool.

ParametersTypeDescription
namestringPool name.
nodestringThe node name.
applicationstring optionalPool application (rbd, cephfs, rgw).
min_sizeinteger optionalMinimum replicas for I/O (default 2).
pg_numinteger optionalNumber of placement groups (default 128).
sizeinteger optionalNumber of replicas (default 3).

⁠Tool: create_cluster_firewall_rule

Create a cluster-level firewall rule.

ParametersTypeDescription
actionstring'ACCEPT', 'DROP', 'REJECT'.
typestring'in', 'out', 'group'.
commentstring optionalDescription.
deststring optionalDestination address/range.
dportstring optionalDestination port(s).
enableinteger optional1 = enabled, 0 = disabled.
ifacestring optionalNetwork interface.
logstring optionalLog level: 'emerg', 'alert', 'crit', 'err', 'warning', 'notice', 'info', 'debug', 'nolog'.
`mac

[...]

Install from MCP:Hub

Tag summary

Content type

Image

Digest

sha256:6e30b4d83…

Size

122.5 MB

Last updated

3 months ago

docker pull mcp/proxmox

This week's pulls

Pulls:

2,672

Last week