{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wnjufufgdnqy","handle":"proxmox-model-context-protocol","url":"https://wellknown.network/agents/proxmox-model-context-protocol","links":{"self":"https://wellknown.network/agents/proxmox-model-context-protocol/record.json","html":"https://wellknown.network/agents/proxmox-model-context-protocol","markdown":"https://wellknown.network/agents/proxmox-model-context-protocol/record.md","api":"https://wellknown.network/api/v1/agents/proxmox-model-context-protocol","status":"https://wellknown.network/api/v1/agents/proxmox-model-context-protocol/status","claim":"https://wellknown.network/agents/proxmox-model-context-protocol/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/proxmox-model-context-protocol/claim.json","badge":"https://wellknown.network/agents/proxmox-model-context-protocol/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/proxmox-model-context-protocol/history","tools":"https://wellknown.network/api/v1/agents/proxmox-model-context-protocol/tools"},"ard":{"identifier":"urn:air::server:proxmox-model-context-protocol","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"proxmox-model-context-protocol","summary":"MCP server for full management of a Proxmox VE hypervisor, with local safety barriers","description":"# proxmox-model-context-protocol\n\nAn MCP (Model Context Protocol) server that lets an AI assistant such as Claude manage a\nProxmox VE hypervisor.\n\nIt has 118 tools for guests, snapshots, backups, storage, networking, firewall, SDN,\nusers and ACLs, node administration and commands inside guests. `pve_api_call` reaches\nany other API endpoint. The server starts read-only.\n\n**Status: alpha.** Tool names, parameters and configuration may change between\nreleases. Tested on single-node Proxmox VE 9.1 and 9.2.\n\nThe server uses an API token with full privileges. Proxmox VE does not limit what the\nmodel can do with it; all safeguards described below run locally in this server. Keep\nclients read-only unless they need to change things, and review `critical.env`.\n\n## Contents\n\n- [Features](#features)\n- [Safety model](#safety-model)\n- [Requirements](#requirements)\n- [Quick start](#quick-start)\n- [Connecting an MCP client](#connecting-an-mcp-client)\n- [Write mode and critical operations](#write-mode-and-critical-operations)\n- [Commands inside guests and on the node](#commands-inside-guests-and-on-the-node)\n- [Configuration reference](#configuration-reference)\n- [Command line](#command-line)\n- [Limitations](#limitations)\n- [Security and license](#security-and-license)\n\n## Features\n\n| Area | Examples |\n|---|---|\n| Inventory and monitoring | cluster resources, guest and node status, metrics, tasks and task logs, node journal |\n| Guests | create a VM or container, clone, start, shut down, stop, reboot, delete, convert to a template |\n| Configuration | guest config, disk resize and move, migration, pending changes |\n| Snapshots and backups | snapshots, rollback, backups, backup jobs and schedules, restore, retention, guests without a backup |\n| Storage | storage definitions, content, download from a URL, upload, appliance templates, volume protection |\n| Networking | node interfaces with a review of pending changes, firewall rules, aliases and IP sets, SDN zones, VNets and subnets |\n|…","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["llm","mcp","model-context-protocol","proxmox","proxmox-ve","pve","virtualization"],"pricing":null,"endpoints":[{"url":"pypi:proxmox-model-context-protocol","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.monitoring","name":"Monitoring & Observability","confidence":0.802,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"proxmox-model-context-protocol","registry":"pypi","observedAt":"2026-11-05T22:26:28.939Z","publishedAt":"2026-10-29T20:57:19.350400Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"proxmox-model-context-protocol","url":"https://pypi.org/project/proxmox-model-context-protocol/","firstSeenAt":"2026-10-30T20:22:21.590Z","fetchedAt":"2026-11-05T22:25:15.257Z","normalizedAt":"2026-11-05T22:25:15.257Z"}]},"firstSeenAt":"2026-10-30T20:22:21.590Z","updatedAt":"2026-11-05T22:26:28.939Z"}