MCP server for Proxmox homelab — modular, AI-extensible. 65+ tools across 17 domains.
homelab-mcp has 34 well-named tools with consistent verb_noun patterns (adguard_stats, devbox_exec, lidarr_add_artist). All tools have descriptions (10 - 200 chars, within baseline 194 avg). Input schemas are present and typed for all tools. However, parameter descriptions are sparse or generic in ~40% of tools (e.g., devbox_exec 'command' lacks format/safety guidance; bazarr_download_subtitle 'language' lacks examples or enum). Output schemas are not documented, LLMs cannot predict response structure. Error handling is basic (no recovery guidance, no categorization). Composition is strong: tools chain well (search_artist → add_artist), and IDs flow correctly. Security is good: no secrets in params, SSH-based isolation. Overall: solid foundation, but missing output documentation and parameter depth.
Check if a domain is blocked by AdGuard Home and which rule matches.
Show AdGuard Home DNS query stats: total queries, blocked count, block rate, top queried and blocked domains.
Enable or disable AdGuard Home DNS filtering protection.
Trigger a manual subtitle download for a specific movie or episode in Bazarr.
Show Bazarr wanted subtitle counts and the first items needing subtitles for movies and episodes.
Run docker compose up/down/restart/pull/logs for a project on the devbox.
Output schemas not documented. LLMs cannot predict response structure, forcing them to guess field names and types for downstream tool chaining.
Parameter descriptions lack format/constraint guidance. E.g., devbox_exec 'command' does not specify what commands are blocked or allowed; bazarr_download_subtitle 'language' lacks enum or examples.
Error handling lacks recovery guidance. Tools return generic errors without suggesting next steps (e.g., 'not found' should suggest search_* alternatives).
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Show all running Docker containers on the devbox.
Execute a shell command on the devbox via SSH. Dangerous commands are blocked.
Run git status, pull, log, or clone on the devbox.
List directory contents on the devbox (ls -la).
Deploy a project: git pull, docker compose pull, docker compose up -d, then show status.
Scan a base path for docker-compose projects and show git remote + container status for each.
Health check for a deployed project: container status and recent logs.
Read the contents of a file on the devbox (up to 100 KB).
Write content to a file on the devbox. Parent directories are created automatically.
Get the panel list for a Grafana dashboard by UID. Returns panel IDs, types, and titles.
List all Grafana dashboards with their UIDs, folder, and tags.
Query the actual data values from a specific Grafana dashboard panel. Returns the last N data points. Use grafana_get_dashboard first to find the panel_id.
List all available homelab tools grouped by service domain. Call this first in any session to discover what you can do. Returns each domain (e.g. Proxmox, Radarr, Plex) with its tool names and descriptions.
Run a health check against all configured homelab services. Pings every service URL found in .env and reports which are reachable with latency, and which are down with the error reason. Results are cached for 30 seconds.
Add a music artist to Lidarr and trigger an automatic album download search.
Show active and queued music downloads in Lidarr with progress and ETA.
List all artists in the Lidarr library with album counts and disk usage.
Remove an artist from the Lidarr library by Lidarr artist ID.
Search for a music artist by name. Returns MusicBrainz IDs and album counts. Use before lidarr_add_artist.
All-in-one homelab status: Proxmox node health, container status, active downloads, library stats, and storage — all in a single call.
Get recent log output from a media service container running on the devbox.
Restart a media service container on the devbox.
Show the status and uptime of all running containers on the devbox.
Send a message to Telegram via the homelab bot. Use to confirm destructive operations, report issues found via MCP, or send homelab alerts.
Show GPU temperature, utilization, VRAM usage, and power draw (runs on Proxmox host).
Check homelab security: SSH config and Proxmox firewall status.
Show Tailscale VPN status on the devbox: connected peers, IPs, and which devices are online.
Send a Wake-on-LAN magic packet to wake a machine by its MAC address. Requires wakeonlan or etherwake on the devbox.
Destructive tools (lidarr_remove_artist, devbox_write_file) lack confirmation/dry-run patterns. Agents can accidentally delete data without safeguards.
No pagination or result limits documented. Tools like devbox_project_list and media_dashboard may return unbounded results, risking context window exhaustion.