Unraid Management Agent is a free MCP server tool by Ruaan Deysel, designed for monitoring and control of Unraid systems. Developed primarily in Go, it functions as an Unraid plugin, installable via a plugin URL or the Unraid Community Applications store. This platform-agnostic agent provides a vital bridge for real-time data collection and operational management, catering to users who need flexible server interaction beyond the standard WebUI. It connects directly to system sources, offering granular insights and control capabilities for diverse Unraid environments.

What does Unraid Management Agent connect to?

The Unraid Management Agent connects directly to Unraid OS servers, gathering data from core system sources. It accesses information from /proc, /sys, kernel interfaces, and uses native libvirt bindings for virtual machine data. Categorized as an MCP server tool, its primary role is to serve as a bridge for monitoring and control. This direct integration ensures accurate and timely data collection, enabling deep oversight of server operations and status across various system components.

Core features and tools

The agent exposes extensive callable tools. For real-time monitoring, collectors cover System (CPU, RAM, temps), Array (state, parity), Disk (metrics), Network, Docker, VM, UPS, GPU, Share, Hardware, and Registration. Control operations include Docker (start, stop, restart, pause, unpause), Virtual Machines (start, stop, restart, pause, resume, hibernate, force-stop), Array (start, stop), Parity (start, stop, pause, resume), Disk (spin up, spin down), and User Scripts. Configuration endpoints allow GET requests for settings like disk thresholds and network services.

Who is it for?

Unraid Management Agent serves Unraid users who require flexible server monitoring and control without constant WebUI interaction. It is also suitable for developers building custom dashboards or mobile applications, and users who want to apply AI for server management. This tool allows for advanced automation and remote management scenarios. Skip this if you only use the standard Unraid WebUI and do not require external monitoring, control, or AI integration for your server.

How to get started

The authentication model is unauthenticated by default. To enable authentication, an API token must be set, which then requires an "Authorization: Bearer <token>" header for requests using the REST API transport protocol.

Use cases

• Building custom dashboards, for instance with Home Assistant, to display real-time system metrics, array status, and Docker container information.
• Enabling AI agents to monitor server health, check logs, and perform control actions such as restarting Docker containers automatically.
• Automating server tasks, including starting or stopping virtual machines, initiating parity checks, or managing disk spin-down based on custom logic.

Unraid Management Agent provides a powerful interface for Unraid server management, extending capabilities beyond the native WebUI. Its direct system access and support for REST API, WebSockets, Prometheus, and MQTT offer versatile integration options. This tool empowers users to automate tasks, create custom monitoring solutions, and integrate AI for enhanced control.