Hey everyone!

I wanted a faster, more flexible way to keep tabs on my Unraid server and control things like Docker containers and VMs without always needing to jump into the WebUI.

The Unraid Management Agent is a lightweight tool built in Go that acts as a bridge between your server and whatever you want to use to monitor it. It’s designed to be "snappy"—it uses an event-driven setup, meaning you get real-time updates via WebSockets and a standard REST API.

I’ve focused on making it as "set and forget" as possible. It has zero external dependencies, so it won't clutter your system. Whether you're building a custom dashboard, a mobile app, or using AI to help you manage your server, this plugin provides the hooks to make that happen.

Just a heads up: I've built it to work alongside the new official API in Unraid 7.2+, so you can use both without any issues!

Built-in AI Support (MCP)

One of the coolest features is the built-in Model Context Protocol (MCP) support.

If you use AI tools like Claude Desktop, Cursor, or custom LLM agents, you can connect them directly to your Unraid server. This lets the AI "see" your server's health, check logs, or even restart a stuck Docker container for you. It essentially makes your Unraid server "AI-ready" out of the box.

Key Features

• 54+ AI Tools: Deep integration for LLMs via MCP to monitor and control your system.

• Real-time Monitoring: CPU, RAM, Array status, Disk health (SMART), Network throughput, UPS status, and GPU metrics.

• Docker & VM Control: Start, stop, restart, pause, and resume containers or virtual machines via API.

• System Operations: Start/stop the array, trigger parity checks, and spin up/down individual disks.

• Low Overhead: Written in Go with native system calls—it’s fast and doesn't lean on heavy shell commands.

How to Install

The plugin can be installed via Community Applications just search for Unraid Management Agent

Configuration

Once installed, go to Settings > Unraid Management Agent.

• Port: The default port is 8043.

• Intervals: You can adjust how often it collects data to save on power/CPU.

• AI Setup: Check the MCP Guide MCP Instructions in the GitHub docs to connect your LLMs.

Support

This has been tested on Unraid 7.x (amd64). If you find a bug or have a feature request (especially for hardware I don't have, like specific RAID controllers or UPS models), please feel free to open an issue on Github

Edited February 15Feb 15 by PanicMechanic007
Update MCP instructions link

The CA description should mention that it also has an MCP server and what benefits REST has for ai-agents, because when setting up my agent, i was only searching for "mcp" in CA, got dissappointed and then went to google...

your hyperlink to mcp integration is dead

On 2/13/2026 at 8:24 AM, tvxyvbt5 said:

your hyperlink to mcp integration is dead

This should work now. Latest plugin update supports the modern mcp protocols. streaming http and stdio.

Instructions located here.

https://github.com/ruaan-deysel/unraid-management-agent/blob/main/docs/integrations/mcp.md

Also please log any issues in GitHub

Edited February 14Feb 14 by PanicMechanic007

Any way to change the network/endpoint it chooses? I have multiple vlans and it just randomly decided to choose one; I could solve it via pfsense that HA and your plugin could communicate, would be lovely if you could choose.

Thanks in advance!

Edited April 9Apr 9 by Hank Moody

via MCP is possible to limit changes on unraid? like an MCP setting that only allow to consume data but not to change or modify anything in unraid, like a read only mode where any MCP skill that changes anything in unraid is blocked by the plugin

easy to use, approval required for potentially destructive commands, granular control..... Nicely done!

On 4/16/2026 at 8:44 PM, L0rdRaiden said:

via MCP is possible to limit changes on unraid? like an MCP setting that only allow to consume data but not to change or modify anything in unraid, like a read only mode where any MCP skill that changes anything in unraid is blocked by the plugin

Hey, sorry for late reply. Latest version has the option has read-only mode for ai agents if you use mcp

e

On 4/9/2026 at 5:51 PM, Hank Moody said:

Any way to change the network/endpoint it chooses? I have multiple vlans and it just randomly decided to choose one; I could solve it via pfsense that HA and your plugin could communicate, would be lovely if you could choose.

Thanks in advance!

Hello, you now have to option to set a bind address. Any issues open a bug report in github.

Hi, I am not sure if it is this, or HA integration from HACKs for this, but I have checked through that it is every time this plugin have updated automatically, when all fans are in 100% on server.. does this conflict or override somehow Dynamix fan control? And is there fast and easy way to tell this "No you are not allowed to touch fan speeds, thank you" (I did disable fan controls from HA integration, but seems it does not help).

On 6/15/2026 at 4:01 PM, ByteHeaven said:

Hi, I am not sure if it is this, or HA integration from HACKs for this, but I have checked through that it is every time this plugin have updated automatically, when all fans are in 100% on server.. does this conflict or override somehow Dynamix fan control? And is there fast and easy way to tell this "No you are not allowed to touch fan speeds, thank you" (I did disable fan controls from HA integration, but seems it does not help).

Hello, Thanks for letting me know about this. I have added detection for 3rd party fan control plugins like the dynamics auto fan control and FanCTRL Plus plugin. When either of the plugins are installed and enabled the unraid management agent will just go into monitor mode and not interfere with the plugins and settings.

Edited June 16Jun 16 by PanicMechanic007
Updates

Hi, great, hope next update then fix this :) Just updated last version a moment ago (last nights build?) on manual update, and it did it, immediately when restarting this plugin. Fans went haywire full speed... Earlier: rebooting system fixed this, but tried other thing now and started disable/enable Fan auto controls, it did not help, but redirecting and applying them one by one fixed (which is annoying slow, so nice if this is on next update fixed, thank you :) ). Also atm rebooting is annoying, when there is some "feature" aka bug in 7.3.1 NFS (have to find where to put report on that), when you cannot mount NFS shares from Mac unless you a) turn of NFS b) reboot server c) turn on NFS (thanks Reddit for this instructions...). But that's off topic for this, just let you know how symptoms go and what fix them now, if your detection on next nights update fix this, nice (I have quite noisy server with all fans full speed :-D And it seldom needs that much cooling on, but it is good to be there when it is needed...)

Edited June 16Jun 16 by ByteHeaven

3 hours ago, ByteHeaven said:

Hi, great, hope next update then fix this :) Just updated last version a moment ago (last nights build?) on manual update, and it did it, immediately when restarting this plugin. Fans went haywire full speed... Earlier: rebooting system fixed this, but tried other thing now and started disable/enable Fan auto controls, it did not help, but redirecting and applying them one by one fixed (which is annoying slow, so nice if this is on next update fixed, thank you :) ). Also atm rebooting is annoying, when there is some "feature" aka bug in 7.3.1 NFS (have to find where to put report on that), when you cannot mount NFS shares from Mac unless you a) turn of NFS b) reboot server c) turn on NFS (thanks Reddit for this instructions...). But that's off topic for this, just let you know how symptoms go and what fix them now, if your detection on next nights update fix this, nice (I have quite noisy server with all fans full speed :-D And it seldom needs that much cooling on, but it is good to be there when it is needed...)

The plugin has a diagnostic section were you enable debug logging and allows you to download diagnostic file. You can send that to me as that will help to troubleshoot. You can also send me the Unraid diagnostic log. Attach the 2 zip files

Sure, I turned on debug logging, and get logs next time it does this and upload them :)

1 hour ago, ByteHeaven said:

Sure, I turned on debug logging, and get logs next time it does this and upload them :)

Thanks. You can also open an issue and attach the unraid and unraid management agent logs here https://github.com/ruaan-deysel/unraid-management-agent

You can also disable fan monitoring in the HACS --> Unraid Management Agent integration. That will disable fan control and monitoring.

And just checking. Do you have this plugin installed? I tested with this plugin enabled and disabled and unraid management agent detects it and if enabled only monitors the fans but if disabled it will control the fans too.

At the moment my system is just set by BIOS to automatically control the fans so I dont bother with this plugin.

Edited June 17Jun 17 by PanicMechanic007

Just a general query, you seem to have two ways to connect Home Assistant to unRAID, this agent based one and this one solely using the unRAID API https://github.com/ruaan-deysel/ha-unraid

Any recommendations which to use and will they both be developed going forward?

Thanks.

On 6/17/2026 at 10:18 AM, PanicMechanic007 said:

Thanks. You can also open an issue and attach the unraid and unraid management agent logs here https://github.com/ruaan-deysel/unraid-management-agent

You can also disable fan monitoring in the HACS --> Unraid Management Agent integration. That will disable fan control and monitoring.

And just checking. Do you have this plugin installed? I tested with this plugin enabled and disabled and unraid management agent detects it and if enabled only monitors the fans but if disabled it will control the fans too.

At the moment my system is just set by BIOS to automatically control the fans so I don't i, bother with this plugin.

Hi, great seems problem was fixed (or it got fixes when I was investigating problems with fans and switched from dynamic plugin to fanctrl plus :) )

But there was now update to this, and my fans did not go full blown tornado because of it :) Thanks by the way great add-on, had to look a way to shutdown Unraid with home assistant from Raspberry Pi when electricity price raise too high for my taste ;) (earlier had that docker api thing, but it stopped working after Unraid update, so had to look an alternative to give that simple shutdown command from HA..). Now this works again so I do not have to think about it.. almost... also victims on last Unraid update was NFS mount on MacOS... only fix atm seem to be: turn off NDS share, reboot server, turn on NFS shares when it goes to some mode "cannot connect" (even when Unraid lists them as shares). It loose it on every reboot or every network disconnection.. sorry for off topic...