Manage Proxmox VE infrastructure including virtual machines, containers, storage, networking, fir...
10K+
Manage Proxmox VE infrastructure including virtual machines, containers, storage, networking, firewall rules, high availability, and more.
| Attribute | Details |
|---|---|
| Docker Image | mcp/proxmox |
| Author | GethosTheWalrus |
| Repository | https://github.com/GethosTheWalrus/proxmox-mcp |
| Attribute | Details |
|---|---|
| Dockerfile | https://github.com/GethosTheWalrus/proxmox-mcp/blob/060b7f5bbbf14bb69f1dac928f1566125e0b03b5/Dockerfile |
| Commit | 060b7f5bbbf14bb69f1dac928f1566125e0b03b5 |
| Docker Image built by | Docker Inc. |
| Docker Scout Health Score | |
| Verify Signature | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/proxmox --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| Licence | Other |
| Tools provided by this Server | Short Description |
|---|---|
add_firewall_ipset_entry | Add an IP/CIDR to an IP set. |
allocate_storage_volume | Allocate a new disk volume in storage. |
apply_sdn_changes | Apply pending SDN configuration changes to all nodes. |
bulk_migrate_guests | Bulk migrate guests to a target node. |
bulk_shutdown_guests | Bulk shutdown guests across the cluster. |
bulk_start_guests | Bulk start guests across the cluster. |
change_password | Change a user's password. |
clone_container | Clone a container. |
clone_vm | Clone a VM to create a new one. |
convert_container_to_template | Convert a container into a template (irreversible). |
convert_vm_to_template | Convert a VM into a template (irreversible). |
create_backup_job | Create a scheduled backup job. |
create_ceph_osd | Create a new Ceph OSD on a device. |
create_ceph_pool | Create a new Ceph pool. |
create_cluster_firewall_rule | Create a cluster-level firewall rule. |
create_container | Create a new LXC container. |
create_container_firewall_rule | Create a firewall rule for an LXC container. |
create_container_snapshot | Create a snapshot of a container. |
create_directory_storage | Create a directory-based storage mount from a device. |
create_firewall_alias | Create a firewall alias (named IP address or CIDR). |
create_firewall_group | Create a new firewall security group. |
create_firewall_group_rule | Add a rule to a firewall security group. |
create_firewall_ipset | Create a new firewall IP set. |
create_group | Create a new group. |
create_ha_group | Create an HA group. |
create_ha_resource | Add a resource to HA management. |
create_lvm | Create a new LVM volume group on a device. |
create_lvmthin | Create a new LVM thin pool. |
create_node_network_interface | Create a network interface on a node. |
create_pool | Create a resource pool. |
create_replication_job | Create a storage replication job. |
create_role | Create a new role with specific privileges. |
create_sdn_subnet | Create a subnet for an SDN VNet. |
create_sdn_vnet | Create an SDN VNet. |
create_sdn_zone | Create an SDN zone. |
create_storage | Create a new storage pool configuration. |
create_user | Create a new user. |
create_user_token | Create a new API token for a user. |
create_vm | Create a new QEMU virtual machine. |
create_vm_firewall_rule | Create a firewall rule for a QEMU VM. |
create_vm_snapshot | Create a snapshot of a VM. |
create_vzdump | Start an immediate backup (vzdump) on a node. |
create_zfs_pool | Create a new ZFS pool. |
delete_backup_job | Delete a scheduled backup job. |
delete_cluster_firewall_rule | Delete a cluster-level firewall rule. |
delete_container | Delete a container. |
delete_container_snapshot | Delete a container snapshot. |
delete_firewall_alias | Delete a firewall alias. |
delete_firewall_ipset_entry | Remove an IP/CIDR from an IP set. |
delete_group | Delete a group. |
delete_ha_group | Delete an HA group. |
delete_ha_resource | Remove a resource from HA management. |
delete_pool | Delete a resource pool. |
delete_replication_job | Delete a replication job. |
delete_role | Delete a role. |
delete_sdn_vnet | Delete an SDN VNet. |
delete_sdn_zone | Delete an SDN zone. |
delete_storage | Delete a storage pool configuration (does not delete data on the backend). |
delete_storage_volume | Delete a volume from storage. |
delete_user | Delete a user. |
delete_user_token | Delete an API token. |
delete_vm | Delete a VM. |
delete_vm_snapshot | Delete a VM snapshot. |
download_appliance_template | Download an appliance template to local storage. |
download_file_restore | Download a file from a vzdump backup. |
download_url_to_storage | Download a file from a URL directly to storage (ISO, template, etc.). |
dump_vm_cloudinit | Dump the Cloud-Init generated config file (user-data, network-data, or meta-data). |
get_acl | Get the full ACL (access control list) — shows all permission assignments. |
get_acme_account | Get ACME account details. |
get_acme_directories | List known ACME directory URLs. |
get_acme_plugin | Get ACME plugin configuration. |
get_acme_tos | Get the ACME Terms of Service URL. |
get_auth_domain | Get authentication domain configuration. |
get_backup_job | Get details of a specific backup job. |
get_backup_job_included_volumes | Get volumes included in a backup job. |
get_ceph_config | Get the raw Ceph configuration. |
get_ceph_crush_rules | Get Ceph CRUSH rules. |
get_ceph_flags | Get Ceph global flags (noout, noscrub, etc.). |
get_ceph_metadata | Get Ceph metadata (versions, services across nodes). |
get_ceph_status_cluster | Get Ceph cluster status (health, monitors, OSDs, PGs). |
get_ceph_status_node | Get Ceph status from a specific node's perspective. |
get_cluster_config | Get the current cluster configuration (corosync, nodes, join info). |
get_cluster_config_nodes | List nodes configured in the cluster. |
get_cluster_firewall_options | Get cluster-wide firewall options (enable, policy_in, policy_out, etc.). |
get_cluster_firewall_rule | Get a specific cluster firewall rule. |
get_cluster_join_info | Get info needed to join a node to this cluster. |
get_cluster_log | Get the cluster log (recent events). |
get_cluster_options | Get datacenter/cluster-wide options (keyboard layout, console, language, etc.). |
get_cluster_resources | List all resources across the cluster (VMs, containers, storage, nodes). |
get_cluster_status | Get cluster status (nodes online, quorum, HA state). |
get_cluster_tasks | List recent tasks across all nodes in the cluster. |
get_cluster_totem | Get the corosync totem configuration. |
get_container_config | Get the configuration of a container. |
get_container_feature | Check if a feature is available for a container (snapshot, clone, copy). |
get_container_firewall_options | Get firewall options for an LXC container. |
get_container_interfaces | Get network interfaces and IPs of a running container. |
get_container_pending | Get pending configuration changes for a container. |
get_container_rrddata | Get RRD statistics data for a container (CPU, memory, disk, network over time). |
get_container_status | Get the current runtime status of a container. |
get_disk_smart | Get S.M.A.R.T. |
get_firewall_group_rules | List rules in a firewall security group. |
get_firewall_refs | Get available firewall references (aliases, ipsets, names usable in rules). |
get_group | Get group details. |
get_ha_group | Get HA group configuration. |
get_ha_manager_status | Get detailed HA manager status. |
get_ha_resource | Get HA resource configuration. |
get_ha_status | Get HA manager status (active, quorum, manager status). |
get_metric_server | Get metric server configuration. |
get_next_vmid | Get the next available VMID in the cluster. |
get_node_aplinfo | List available appliance templates (LXC templates) that can be downloaded. |
get_node_apt_update | List available package updates on a node. |
get_node_capabilities_qemu | Get QEMU capabilities for a node: supported CPU models, machine types, etc. |
get_node_certificates | Get certificate info for a node. |
get_node_config | Get the configuration of a node (description, wakeonlan, etc.). |
get_node_disks | List physical disks on a node. |
get_node_dns | Get DNS settings for a node. |
get_node_firewall_log | Get firewall log for a node. |
get_node_firewall_options | Get firewall options for a specific node. |
get_node_hardware_pci | List PCI hardware devices on a node (for passthrough). |
get_node_hardware_usb | List USB hardware devices on a node. |
get_node_hosts | Get the /etc/hosts file content for a node. |
get_node_journal | Read systemd journal entries from a node. |
get_node_netstat | Get network statistics for a node (per-interface traffic). |
get_node_network | Get network interface configuration for a node. |
get_node_network_interface | Get details for a specific network interface. |
get_node_report | Generate a system report for a node (useful for diagnostics). |
get_node_status | Get detailed status of a specific node including CPU, memory, disk, uptime, and kernel info. |
get_node_storage_scan | Scan for available storage targets (NFS, CIFS, iSCSI, LVM, ZFS, PBS). |
get_node_storage_status | Get usage status of a storage pool on a node (total, used, available). |
get_node_subscription | Get subscription status for a node. |
get_node_syslog | Read system log (syslog) entries from a node. |
get_node_time | Get the current time and timezone of a node. |
get_node_version | Get Proxmox VE version information for a specific node. |
get_permissions | Check effective permissions for a user on a given path. |
get_pool | Get pool configuration and members. |
get_replication_job | Get a specific replication job configuration. |
get_role | Get role details and its privileges. |
get_sdn_controller | Get SDN controller configuration. |
get_sdn_ipam | Get IPAM plugin configuration. |
get_sdn_vnet | Get SDN VNet configuration. |
get_sdn_zone | Get SDN zone configuration. |
get_storage_config | Get configuration of a specific storage pool. |
get_storage_rrddata | Get RRD statistics for a storage pool (usage over time). |
get_storage_volume_info | Get details about a specific volume in storage. |
get_task_log | Get log output of a specific task. |
get_task_status | Get the status of a specific task by its UPID. |
get_user | Get details for a specific user. |
get_user_token | Get details for a specific API token. |
get_version | Get the Proxmox VE API version information. |
get_vm_cloudinit | Get Cloud-Init configuration for a VM. |
get_vm_config | Get the configuration of a VM. |
get_vm_feature | Check if a specific feature is available/supported for a VM (e.g. |
get_vm_firewall_options | Get firewall options for a QEMU VM. |
get_vm_pending | Get pending configuration changes for a VM (not yet applied). |
get_vm_rrddata | Get RRD statistics data for a VM (CPU, memory, disk, network over time). |
get_vm_snapshot_config | Get the configuration stored in a VM snapshot. |
get_vm_spiceproxy | Create a SPICE proxy connection for a VM console. |
get_vm_status | Get the current runtime status of a VM (state, CPU, memory, disk, network, uptime). |
get_vm_vncproxy | Create a VNC proxy connection ticket for a VM (for console access). |
get_vzdump_defaults | Get the default vzdump configuration for a node. |
get_vzdump_extractconfig | Extract the guest configuration from a vzdump backup archive. |
get_zfs_pool | Get details of a ZFS pool. |
initialize_gpt | Initialize a disk with GPT partition table (WARNING: destroys all data). |
join_cluster | Join a node to an existing cluster. |
list_acme_accounts | List ACME (Let's Encrypt) accounts. |
list_acme_plugins | List ACME DNS challenge plugins. |
list_auth_domains | List configured authentication realms/domains (PAM, PVE, LDAP, AD, OpenID). |
list_backup_file_restore | List files in a vzdump backup for single-file restore. |
list_backup_jobs | List all scheduled backup jobs (vzdump) in the cluster. |
list_ceph_fs | List CephFS filesystems. |
list_ceph_managers | List Ceph managers. |
list_ceph_mds | List Ceph metadata servers (MDS, for CephFS). |
list_ceph_monitors | List Ceph monitors. |
list_ceph_osds | List Ceph OSDs on a node. |
list_ceph_pools | List Ceph pools. |
list_cluster_firewall_rules | List cluster-level firewall rules. |
list_container_firewall_rules | List firewall rules for an LXC container. |
list_container_snapshots | List all snapshots of a container. |
list_containers | List all LXC containers on a node with status, memory, CPU, and disk info. |
list_dir_mappings | List directory mappings. |
list_directory_storage | List directory-based storage mounts on a node. |
list_file_restore | List files in a backup volume for file-level restore (PBS backups). |
list_firewall_aliases | List cluster firewall aliases (named IP addresses/ranges). |
list_firewall_groups | List firewall security groups (reusable sets of rules). |
list_firewall_ipset_entries | List entries in a firewall IP set. |
list_firewall_ipsets | List cluster firewall IP sets (named groups of IPs). |
list_firewall_macros | List available firewall macros (predefined rule sets like SSH, HTTP, etc.). |
list_groups | List all user groups. |
list_ha_groups | List HA groups (define which nodes can run HA resources). |
list_ha_resources | List all HA-managed resources. |
list_lvm_volumes | List LVM volume groups on a node. |
list_lvmthin_pools | List LVM thin pools on a node. |
list_metric_servers | List configured metric servers (InfluxDB, Graphite). |
list_node_firewall_rules | List firewall rules for a node. |
list_node_services | List all system services on a node (pve, ssh, cron, etc.). |
list_node_storage | List storage pools available on a specific node with usage info. |
list_node_tasks | List recent tasks on a node. |
list_nodes | List all nodes in the Proxmox cluster with their status, CPU, memory, and uptime. |
list_notification_endpoints | List all configured notification endpoints (sendmail, gotify, smtp, webhook). |
list_notification_matchers | List all notification matchers (rules that route notifications). |
list_notification_targets | List all notification targets. |
list_pci_mappings | List PCI device mappings for passthrough. |
list_pools | List all resource pools. |
list_realm_sync_jobs | List realm synchronization jobs. |
list_replication_jobs | List all replication jobs in the cluster. |
list_roles | List all available roles. |
list_scheduled_jobs | List all scheduled cluster jobs (realm-sync, etc.). |
list_sdn_controllers | List SDN controllers (e.g. |
list_sdn_dns | List SDN DNS plugins. |
list_sdn_ipams | List IPAM (IP Address Management) plugins. |
list_sdn_subnets | List subnets for an SDN VNet. |
list_sdn_vnets | List SDN virtual networks (VNets). |
list_sdn_zones | List SDN zones. |
list_storage | List all configured storage pools at the datacenter level. |
list_storage_content | List content of a storage pool (disk images, ISOs, templates, backups). |
list_tfa | List TFA (two-factor auth) entries. |
list_usb_mappings | List USB device mappings for passthrough. |
list_user_tokens | List API tokens for a user. |
list_users | List all users in Proxmox. |
list_vm_firewall_rules | List firewall rules for a QEMU VM. |
list_vm_snapshots | List all snapshots of a VM. |
list_vms | List all QEMU virtual machines on a node with status, memory, CPU, and disk info. |
list_zfs_pools | List ZFS pools on a node. |
manage_node_service | Start, stop, restart, or reload a system service on a node. |
migrate_container | Migrate a container to another node. |
migrate_ha_resource | Request migration of an HA resource to a different node. |
migrate_vm | Migrate a VM to another node in the cluster. |
move_container_volume | Move a container volume to different storage or to another container. |
move_vm_disk | Move a VM disk to different storage or attach to another VM. |
order_node_certificate | Order/renew ACME certificate for a node. |
proxmox_api_raw | Make an arbitrary Proxmox API call for any endpoint not covered by specific tools. |
prune_storage_backups | Prune (delete) old backups from storage according to retention policy. |
reboot_container | Reboot a container. |
reboot_vm | Reboot a VM via ACPI. |
register_acme_account | Register a new ACME account. |
relocate_ha_resource | Request relocation of an HA resource to a different node. |
reset_vm | Hard reset a VM (like pressing the reset button). |
resize_container_disk | Resize a container disk/volume. |
resize_vm_disk | Resize a VM disk. |
resume_container | Resume a suspended container. |
resume_vm | Resume a suspended/paused VM. |
rollback_container_snapshot | Rollback a container to a previous snapshot. |
rollback_vm_snapshot | Rollback a VM to a previous snapshot (current state will be lost). |
run_apt_update | Refresh the package index on a node (apt update). |
send_vm_key | Send a key event to a VM (e.g. |
send_vm_monitor_command | Send a QEMU monitor command to a VM (advanced/low-level). |
set_ceph_flags | Set a Ceph global flag. |
set_cluster_firewall_options | Set cluster-wide firewall options. |
set_node_firewall_options | Set firewall options for a node. |
set_vm_firewall_options | Set firewall options for a QEMU VM. |
shutdown_container | Gracefully shut down a container. |
shutdown_vm | Gracefully shut down a VM via ACPI. |
start_container | Start a container. |
start_vm | Start a VM. |
startall_node | Start all VMs and containers on a node (respecting boot order). |
stop_container | Hard-stop a container (immediate, like power off). |
stop_task | Stop (abort) a running task. |
stop_vm | Hard-stop a VM (like pulling the power plug). |
stopall_node | Stop all VMs and containers on a node. |
suspend_container | Suspend (freeze) a container. |
suspend_vm | Suspend a VM (pause execution or hibernate to disk). |
sync_auth_domain | Sync users/groups from an external auth domain (LDAP/AD). |
test_notification_target | Send a test notification to a target. |
update_acl | Add or remove ACL entries (permission assignments). |
update_backup_job | Update a scheduled backup job. |
update_cluster_firewall_rule | Update a cluster-level firewall rule. |
update_cluster_options | Update datacenter/cluster-wide options. |
update_container_config | Update the configuration of an existing container. |
update_group | Update a group. |
update_ha_group | Update an HA group. |
update_ha_resource | Update an HA resource configuration. |
update_pool | Update a resource pool (add/remove members). |
update_role | Update role privileges. |
update_sdn_vnet | Update an SDN VNet. |
update_storage | Update an existing storage pool configuration. |
update_user | Update an existing user. |
update_vm_cloudinit | Set Cloud-Init parameters for a VM (user, password, SSH keys, network). |
update_vm_config | Update the configuration of an existing VM. |
upload_to_storage | Upload a file (ISO, template, etc.) to storage. |
vm_agent_exec | Execute a command inside a VM via the QEMU Guest Agent. |
vm_agent_exec_status | Get the status/result of a command previously executed via the guest agent. |
vm_agent_file_read | Read a file from inside a VM via the guest agent. |
vm_agent_file_write | Write content to a file inside a VM via the guest agent. |
vm_agent_get_info | Get various system information from a VM via the guest agent. |
vm_agent_set_password | Set a user password inside a VM via the guest agent. |
wakeonlan_node | Send a Wake-on-LAN magic packet to a node. |
add_firewall_ipset_entryAdd an IP/CIDR to an IP set.
| Parameters | Type | Description |
|---|---|---|
cidr | string | IP address or CIDR. |
name | string | IP set name. |
comment | string optional | Description. |
nomatch | boolean optional | Exclude this entry (nomatch). |
allocate_storage_volumeAllocate a new disk volume in storage.
| Parameters | Type | Description |
|---|---|---|
filename | string | Volume name. |
node | string | The node name. |
size | string | Volume size (e.g. '10G'). |
storage | string | The storage ID. |
vmid | integer | VM ID to associate with. |
format | string optional | Disk format (raw, qcow2, vmdk). Auto-detected if empty. |
apply_sdn_changesApply pending SDN configuration changes to all nodes.
bulk_migrate_guestsBulk migrate guests to a target node.
| Parameters | Type | Description |
|---|---|---|
target | string | Target node name. |
vms | string optional | Comma-separated VMIDs. |
bulk_shutdown_guestsBulk shutdown guests across the cluster.
| Parameters | Type | Description |
|---|---|---|
vms | string optional | Comma-separated list of VMIDs (empty = all). |
bulk_start_guestsBulk start guests across the cluster.
| Parameters | Type | Description |
|---|---|---|
vms | string optional | Comma-separated list of VMIDs (empty = all). |
change_passwordChange a user's password.
| Parameters | Type | Description |
|---|---|---|
password | string | New password. |
userid | string | User ID (format: 'user@realm'). |
clone_containerClone a container.
| Parameters | Type | Description |
|---|---|---|
newid | integer | ID for the new container. |
node | string | The source node name. |
vmid | integer | The source container ID. |
description | string optional | Description. |
full | boolean optional | Full clone (True) or linked clone (False). |
hostname | string optional | Hostname for the clone. |
pool | string optional | Resource pool. |
snapname | string optional | Snapshot to clone from. |
storage | string optional | Target storage for full clone. |
target | string optional | Target node (default: same node). |
clone_vmClone a VM to create a new one. Can be a full copy or linked clone.
| Parameters | Type | Description |
|---|---|---|
newid | integer | The VMID for the new clone. |
node | string | The source node name. |
vmid | integer | The source VM ID. |
description | string optional | Description for the clone. |
full | boolean optional | Full clone (True) or linked clone (False). |
name | string optional | Name for the clone. |
pool | string optional | Resource pool. |
snapname | string optional | Snapshot name to clone from. |
storage | string optional | Target storage for full clone. |
target | string optional | Target node for the clone (default: same node). |
convert_container_to_templateConvert a container into a template (irreversible).
| Parameters | Type | Description |
|---|---|---|
node | string | The node name. |
vmid | integer | The container ID. |
convert_vm_to_templateConvert a VM into a template (irreversible).
| Parameters | Type | Description |
|---|---|---|
node | string | The node name. |
vmid | integer | The VM ID. |
create_backup_jobCreate a scheduled backup job.
| Parameters | Type | Description |
|---|---|---|
storage | string | Target storage ID for backups. |
all_guests | boolean optional | Backup all guests. |
comment | string optional | Description. |
compress | string optional | Compression: 'none', 'lzo', 'gzip', 'zstd'. |
enabled | boolean optional | Enable the job. |
mailnotification | string optional | 'always' or 'failure'. |
mailto | string optional | Comma-separated email addresses. |
maxfiles | integer optional | Max backup files to keep (0 = unlimited, deprecated - use prune_backups). |
mode | string optional | Backup mode: 'snapshot', 'suspend', 'stop'. |
node | string optional | Only back up guests on this node. |
notes_template | string optional | Template for backup notes. |
prune_backups | string optional | Retention schedule (e.g. 'keep-daily=7,keep-weekly=4'). |
schedule | string optional | Schedule in systemd calendar format (e.g. 'daily', 'weekly', '02:00'). |
vmid | string optional | Comma-separated VMIDs to back up (if not all_guests). |
create_ceph_osdCreate a new Ceph OSD on a device.
| Parameters | Type | Description |
|---|---|---|
dev | string | Block device for the OSD (e.g. '/dev/sdb'). |
node | string | The node name. |
db_dev | string optional | Separate block device for DB. |
encrypted | boolean optional | Encrypt the OSD. |
wal_dev | string optional | Separate block device for WAL. |
create_ceph_poolCreate a new Ceph pool.
| Parameters | Type | Description |
|---|---|---|
name | string | Pool name. |
node | string | The node name. |
application | string optional | Pool application (rbd, cephfs, rgw). |
min_size | integer optional | Minimum replicas for I/O (default 2). |
pg_num | integer optional | Number of placement groups (default 128). |
size | integer optional | Number of replicas (default 3). |
create_cluster_firewall_ruleCreate a cluster-level firewall rule.
| Parameters | Type | Description |
|---|---|---|
action | string | 'ACCEPT', 'DROP', 'REJECT'. |
type | string | 'in', 'out', 'group'. |
comment | string optional | Description. |
dest | string optional | Destination address/range. |
dport | string optional | Destination port(s). |
enable | integer optional | 1 = enabled, 0 = disabled. |
iface | string optional | Network interface. |
log | string optional | Log level: 'emerg', 'alert', 'crit', 'err', 'warning', 'notice', 'info', 'debug', 'nolog'. |
| `mac |
[...]
Content type
Image
Digest
sha256:6e30b4d83…
Size
122.5 MB
Last updated
3 months ago
docker pull mcp/proxmoxPulls:
2,672
Last week