Proxmox MCP

{
  "name": "io.github.Servosity/proxmox-mcp",
  "icons": [
    {
      "src": "https://raw.githubusercontent.com/servosity/msp-skills/main/docs/assets/social/proxmox/proxmox-512x512.png",
      "sizes": [
        "512x512"
      ],
      "mimeType": "image/png"
    }
  ],
  "title": "Proxmox MCP",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.1.0",
  "packages": [
    {
      "version": "0.1.0",
      "transport": {
        "type": "stdio"
      },
      "fileSha256": "85a7edcfcc04465ea4bda8483ea1574a84bbbb50ec8214831f5a6a8bd81a1343",
      "identifier": "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.0/proxmox-mcp.mcpb",
      "registryType": "mcpb",
      "environmentVariables": [
        {
          "name": "PROXMOX_HOST",
          "isRequired": true,
          "description": "Proxmox VE host name or IP (API on port 8006)."
        },
        {
          "name": "PROXMOX_API_TOKEN",
          "isSecret": true,
          "isRequired": true,
          "description": "Proxmox VE API token USER@REALM!TOKENID=SECRET; PVEAuditor, plus Datastore.AllocateSpace and VM.Backup if backups live on PVE storage."
        },
        {
          "name": "PROXMOX_TLS_FINGERPRINT",
          "description": "SHA-256 fingerprint of the PVE certificate to pin (stock Proxmox certificates are self-signed)."
        },
        {
          "name": "PROXMOX_PBS_HOST",
          "description": "Optional Proxmox Backup Server host, host:port, or https://host:port (default port 8007)."
        },
        {
          "name": "PROXMOX_PBS_API_TOKEN",
          "isSecret": true,
          "description": "Optional Proxmox Backup Server API token USER@REALM!TOKENID:SECRET (colon before the secret)."
        },
        {
          "name": "PROXMOX_PBS_TLS_FINGERPRINT",
          "description": "Optional SHA-256 fingerprint of the PBS certificate to pin."
        },
        {
          "name": "PROXMOX_BASE_URL",
          "description": "Full PVE API base such as https://pve1:8006/api2/json; overrides PROXMOX_HOST. Leave blank to use PROXMOX_HOST."
        },
        {
          "name": "PROXMOX_CLUSTER",
          "description": "Name of the clusters.toml entry to use by default (same as --cluster). Leave blank to run across every configured cluster."
        },
        {
          "name": "PROXMOX_CLUSTERS_FILE",
          "description": "Path to the clusters.toml that lists client clusters. Leave blank for the default. Each cluster's token variables must also be in the server's environment."
        },
        {
          "name": "PROXMOX_USER_AGENT",
          "description": "Overrides the User-Agent the CLI sends on Proxmox requests. Leave blank to use the CLI's own."
        },
        {
          "name": "PROXMOX_MCP_READ_ONLY",
          "description": "Set to 1 to drop the sync, export, workflow archive and learnings forget/reject MCP tools. The learning-store tools (teach, playbook) still write locally. Proxmox itself is never written either way. Leave blank for the full tool set."
        },
        {
          "name": "PROXMOX_MCP_HTTP_TOKEN",
          "isSecret": true,
          "description": "Required only when running the MCP server with --transport http (a remote or hosted deployment); the server refuses to start without it. Callers must send a matching Authorization: Bearer header. Not needed for the default local stdio transport that Claude Desktop uses."
        },
        {
          "name": "PRINTING_PRESS_CLIENT_PROFILE",
          "isSecret": true,
          "description": "Leave blank. This connector registers no tenant-gated profile source, so the value is read but changes nothing; select client clusters with PROXMOX_CLUSTER or clusters.toml instead."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/servosity/msp-skills",
    "source": "github",
    "subfolder": "skills/proxmox"
  },
  "description": "Read-only Proxmox VE and Backup Server: which client guests have a verified, recent restore point."
}