Better Unraid MCP
mswdev/better-unraid-mcp
Monitor and manage an Unraid server from any MCP client: array, Docker, VMs, ZFS, logs, and UPS.
- GitHub stars
- 3
- tools
- 42
- auth
- Secret needed
- transport
- STDIO
- env vars
- 5
- last updated
- Nov 12, 2026
Tools
42 toolsPublic tool metadata for what this MCP can expose to an agent.
system_infoOS, kernel, uptime, hostname, and CPU summary.
OS, kernel, uptime, hostname, and CPU summary.
No parameter schema in public metadata yet.
array_statusArray state, capacity, current parity-check status, and per-disk health.
Array state, capacity, current parity-check status, and per-disk health.
No parameter schema in public metadata yet.
parity_historyRecent parity checks (date, status, errors, speed).
Recent parity checks (date, status, errors, speed).
No parameter schema in public metadata yet.
disk_listPhysical disks with model, size, SMART status, temperature, and partitions.
Physical disks with model, size, SMART status, temperature, and partitions.
No parameter schema in public metadata yet.
disk_smart_reportFull smartctl attribute report for one disk (SSH).
Full smartctl attribute report for one disk (SSH).
No parameter schema in public metadata yet.
disk_spinSpins a disk up or down (SSH; `confirm`): array slots through emhttpd so the state stays consistent, unassigned `/dev/sdX` through sdspin (ATA only).
Spins a disk up or down (SSH; `confirm`): array slots through emhttpd so the state stays consistent, unassigned `/dev/sdX` through sdspin (ATA only).
No parameter schema in public metadata yet.
share_listUser shares with usage; filter by name.
User shares with usage; filter by name.
No parameter schema in public metadata yet.
mover_statusWhether the mover (cache-to-array migration) is running, plus its schedule.
Whether the mover (cache-to-array migration) is running, plus its schedule.
No parameter schema in public metadata yet.
system_healthOne severity-scored health rollup (OK / WARNING / CRITICAL) across array, capacity, disks and temperatures, parity, notifications, UPS, and pending container updates. Start here.
One severity-scored health rollup (OK / WARNING / CRITICAL) across array, capacity, disks and temperatures, parity, notifications, UPS, and pending container updates. Start here.
No parameter schema in public metadata yet.
connection_doctorSelf-test of this MCP server's plumbing: GraphQL reachability and latency, API key validity, versions, schema skew, SSH connectivity, rate-limit config, and read-only mode.
Self-test of this MCP server's plumbing: GraphQL reachability and latency, API key validity, versions, schema skew, SSH connectivity, rate-limit config, and read-only mode.
No parameter schema in public metadata yet.
gpu_metricsGPU utilization over SSH: full metrics from nvidia-smi, a one-line summary parsed from intel_gpu_top, or a clear report when neither is present.
GPU utilization over SSH: full metrics from nvidia-smi, a one-line summary parsed from intel_gpu_top, or a clear report when neither is present.
No parameter schema in public metadata yet.
process_listThe host's busiest processes by CPU or memory (SSH).
The host's busiest processes by CPU or memory (SSH).
No parameter schema in public metadata yet.
mover_actionStarts or stops the mover over SSH (requires `confirm: true`). Stopping can leave partial files on the destination.
Starts or stops the mover over SSH (requires `confirm: true`). Stopping can leave partial files on the destination.
No parameter schema in public metadata yet.
system_powerReboots or shuts down the whole server over SSH. Requires `confirm: true` and `acknowledge_risk: true`.
Reboots or shuts down the whole server over SSH. Requires `confirm: true` and `acknowledge_risk: true`.
No parameter schema in public metadata yet.
array_actionStarts or stops the array. Stopping takes every share, container, and VM offline, so `stop` also requires `acknowledge_risk: true`.
Starts or stops the array. Stopping takes every share, container, and VM offline, so `stop` also requires `acknowledge_risk: true`.
No parameter schema in public metadata yet.
array_disk_actionAdds a disk to the array, mounts or unmounts an array disk, or clears disk statistics. Requires `confirm` + `acknowledge_risk`.
Adds a disk to the array, mounts or unmounts an array disk, or clears disk statistics. Requires `confirm` + `acknowledge_risk`.
No parameter schema in public metadata yet.
parity_checkStarts (optionally correcting), pauses, resumes, or cancels a parity check.
Starts (optionally correcting), pauses, resumes, or cancels a parity check.
No parameter schema in public metadata yet.
docker_container_listContainers with state, image, and update availability; filter by name.
Containers with state, image, and update availability; filter by name.
No parameter schema in public metadata yet.
docker_container_logsRecent log lines for a container, with tail and time-based paging.
Recent log lines for a container, with tail and time-based paging.
No parameter schema in public metadata yet.
docker_network_listDocker networks (driver, scope, IPv6/internal/attachable).
Docker networks (driver, scope, IPv6/internal/attachable).
No parameter schema in public metadata yet.
docker_port_conflictsContainer and LAN port conflicts.
Container and LAN port conflicts.
No parameter schema in public metadata yet.
docker_statsPer-container CPU, memory, network, and block IO usage, hungriest first.
Per-container CPU, memory, network, and block IO usage, hungriest first.
No parameter schema in public metadata yet.
docker_container_actionStart, stop, pause, unpause, or restart a container.
Start, stop, pause, unpause, or restart a container.
No parameter schema in public metadata yet.
docker_container_removePermanently deletes a container (irreversible) and optionally its image. Needs Unraid 7.3+.
Permanently deletes a container (irreversible) and optionally its image. Needs Unraid 7.3+.
No parameter schema in public metadata yet.
docker_container_updatePulls the latest image and recreates containers, by id or all with updates. Needs Unraid 7.3+.
Pulls the latest image and recreates containers, by id or all with updates. Needs Unraid 7.3+.
No parameter schema in public metadata yet.
docker_autostart_setSets which containers start on boot without losing the existing boot order. Needs Unraid 7.3+.
Sets which containers start on boot without losing the existing boot order. Needs Unraid 7.3+.
No parameter schema in public metadata yet.
vm_listVirtual machines with run state; filter by name.
Virtual machines with run state; filter by name.
No parameter schema in public metadata yet.
vm_actionStart, stop, pause, resume, forceStop, reboot, or reset a VM by name or id. `forceStop` and `reset` are ungraceful and also require `acknowledge_risk: true`.
Start, stop, pause, resume, forceStop, reboot, or reset a VM by name or id. `forceStop` and `reset` are ungraceful and also require `acknowledge_risk: true`.
No parameter schema in public metadata yet.
vm_snapshot_listLists a VM's libvirt snapshots through virsh (SSH; the GraphQL API doesn't expose them).
Lists a VM's libvirt snapshots through virsh (SSH; the GraphQL API doesn't expose them).
No parameter schema in public metadata yet.
vm_snapshot_createCreates an EXTERNAL disk snapshot through virsh. Requires `confirm` + `acknowledge_risk`. Revert and delete stay in the Unraid UI on purpose.
Creates an EXTERNAL disk snapshot through virsh. Requires `confirm` + `acknowledge_risk`. Revert and delete stay in the Unraid UI on purpose.
No parameter schema in public metadata yet.
notification_overviewUnread and archived counts broken down by importance.
Unread and archived counts broken down by importance.
No parameter schema in public metadata yet.
notification_listNotifications by type (`unread` or `archive`) with paging; the source of truth for ids.
Notifications by type (`unread` or `archive`) with paging; the source of truth for ids.
No parameter schema in public metadata yet.
notification_alertsDeduplicated unread warnings and alerts: the "needs attention now" view.
Deduplicated unread warnings and alerts: the "needs attention now" view.
No parameter schema in public metadata yet.
notification_archiveArchives or unarchives notifications (reversible, no confirmation needed).
Archives or unarchives notifications (reversible, no confirmation needed).
No parameter schema in public metadata yet.
notification_unreadMarks one notification as unread again (reversible, no confirmation needed).
Marks one notification as unread again (reversible, no confirmation needed).
No parameter schema in public metadata yet.
notification_createCreates a notification (no confirmation needed).
Creates a notification (no confirmation needed).
No parameter schema in public metadata yet.
notification_recalculateRe-syncs cached overview counts from disk (no confirmation needed).
Re-syncs cached overview counts from disk (no confirmation needed).
No parameter schema in public metadata yet.
notification_deletePermanently deletes notifications (irreversible).
Permanently deletes notifications (irreversible).
No parameter schema in public metadata yet.
log_listThe server's log files with size and last-modified time.
The server's log files with size and last-modified time.
No parameter schema in public metadata yet.
log_readTails or windows a log file (default 100 lines, max 2000), with paging hints.
Tails or windows a log file (default 100 lines, max 2000), with paging hints.
No parameter schema in public metadata yet.
system_metricsPoint-in-time CPU load, memory pressure, per-interface network rates, and server time. Temperature data is opt-in.
Point-in-time CPU load, memory pressure, per-interface network rates, and server time. Temperature data is opt-in.
No parameter schema in public metadata yet.
metrics_historyRecent CPU, memory, and network history from the opt-in in-memory recorder (`MCP_METRICS_HISTORY=true`): 30-second min/avg/max buckets for up to 24 hours.
Recent CPU, memory, and network history from the opt-in in-memory recorder (`MCP_METRICS_HISTORY=true`): 30-second min/avg/max buckets for up to 24 hours.
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
UNRAID_API_URL*Full Unraid GraphQL endpoint, including /graphql
UNRAID_API_KEY*secretUnraid API key (Settings → Management Access → API Keys)
UNRAID_SSH_HOSTOptional: SSH host for host-level tools
UNRAID_SSH_PASSWORDsecretOptional: SSH password (or set UNRAID_SSH_KEY_PATH)
MCP_READ_ONLYSet true to register only read-only tools
Readme
Better Unraid MCP
Monitor and manage your Unraid server in plain English, from any MCP client.
Details
- Repository
- github.com/mswdev/better-unraid-mcp
- Website
- github.com/mswdev/better-unraid-mcp#readme
- Categories
- Cloud & Infrastructure, Monitoring & Observability
- Package
better-unraid-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
