{
  "slug": "io-github-servosity-proxmox-mcp",
  "name": "io.github.Servosity/proxmox-mcp",
  "title": "Proxmox MCP",
  "description": "Read-only Proxmox VE and Backup Server: which client guests have a verified, recent restore point.",
  "version": "0.1.2",
  "publishedAt": "2026-10-23T15:08:17.700719Z",
  "updatedAt": "2026-10-23T15:08:17.700719Z",
  "repoUrl": "https://github.com/servosity/msp-skills",
  "websiteUrl": null,
  "namespace": {
    "type": "github",
    "owner": "Servosity"
  },
  "kind": "local",
  "packages": [
    {
      "registryType": "mcpb",
      "identifier": "https://github.com/Servosity/msp-skills/releases/download/proxmox-v0.1.2/proxmox-mcp.mcpb",
      "version": "0.1.2",
      "transport": "stdio",
      "runtimeHint": null
    }
  ],
  "remotes": [],
  "envVars": [
    {
      "name": "PROXMOX_HOST",
      "isSecret": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "description": "SHA-256 fingerprint of the PVE certificate to pin (stock Proxmox certificates are self-signed)."
    },
    {
      "name": "PROXMOX_PBS_HOST",
      "isSecret": false,
      "isRequired": false,
      "description": "Optional Proxmox Backup Server host, host:port, or https://host:port (default port 8007)."
    },
    {
      "name": "PROXMOX_PBS_API_TOKEN",
      "isSecret": true,
      "isRequired": false,
      "description": "Optional Proxmox Backup Server API token USER@REALM!TOKENID:SECRET (colon before the secret)."
    },
    {
      "name": "PROXMOX_PBS_TLS_FINGERPRINT",
      "isSecret": false,
      "isRequired": false,
      "description": "Optional SHA-256 fingerprint of the PBS certificate to pin."
    },
    {
      "name": "PROXMOX_BASE_URL",
      "isSecret": false,
      "isRequired": false,
      "description": "Full PVE API base such as https://pve1:8006/api2/json; overrides PROXMOX_HOST. Leave blank to use PROXMOX_HOST."
    },
    {
      "name": "PROXMOX_CLUSTER",
      "isSecret": false,
      "isRequired": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "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",
      "isSecret": false,
      "isRequired": false,
      "description": "Overrides the User-Agent the CLI sends on Proxmox requests. Leave blank to use the CLI's own."
    },
    {
      "name": "PROXMOX_MCP_READ_ONLY",
      "isSecret": false,
      "isRequired": false,
      "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,
      "isRequired": false,
      "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,
      "isRequired": false,
      "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."
    }
  ],
  "category": "cloud-infra",
  "subcategory": "servers",
  "company": "",
  "categoryAuto": true,
  "checks": [
    {
      "id": "source-linked",
      "label": "Source repository linked",
      "result": "pass",
      "detail": "https://github.com/servosity/msp-skills"
    },
    {
      "id": "version-pinned",
      "label": "Version pinned",
      "result": "pass",
      "detail": "Every package has an explicit version"
    },
    {
      "id": "secrets-requested",
      "label": "Secrets requested",
      "result": "warn",
      "detail": "Asks for 4 secrets: PROXMOX_API_TOKEN, PROXMOX_PBS_API_TOKEN, PROXMOX_MCP_HTTP_TOKEN, PRINTING_PRESS_CLIENT_PROFILE"
    },
    {
      "id": "known-registry",
      "label": "Known package registry",
      "result": "pass",
      "detail": "All packages come from npm, PyPI, OCI, NuGet or MCPB"
    },
    {
      "id": "namespace",
      "label": "Namespace ownership",
      "result": "info",
      "detail": "Name verified via GitHub account Servosity"
    },
    {
      "id": "meta-text",
      "label": "Registry text aimed at the AI",
      "result": "pass",
      "detail": "Description and settings contain no hidden characters or instructions to the AI"
    },
    {
      "id": "code-flags",
      "label": "Code red flags",
      "result": "info",
      "detail": "Package could not be read (too large)"
    }
  ],
  "scannedAt": "2026-10-29",
  "level": "Scanned",
  "install": [],
  "curated": true,
  "stars": 64,
  "archived": false,
  "pushedAt": "2026-10-28T15:14:18Z",
  "health": {
    "score": 63,
    "parts": {
      "popularity": 0.21303032796741,
      "activity": 1,
      "issues": 0.8829787234042553,
      "security": 0.8
    },
    "fail": 0,
    "warn": 1,
    "raw": {
      "stars": 67,
      "forks": 14,
      "downloads": null,
      "hn": {
        "n": 0,
        "pts": 0,
        "t": []
      },
      "issuesOpen": 11,
      "issuesClosed": 83,
      "prsMerged": 379,
      "commits90": 1049,
      "release": "2026-10-27T22:35:28Z",
      "pushed": "2026-10-28T15:14:18Z",
      "growth": null,
      "growthDays": null,
      "archived": false
    },
    "at": "2026-10-31T07:42:38.200Z"
  },
  "icon": "/icons/s/io-github-servosity-proxmox-mcp.png"
}