Repository navigation
With homebutler mcp --max-risk read, an agent can look at your servers and change nothing through this process.
Two boundaries come with that sentence. Read mode stops changes, not reading: docker_logs and docker_inspect show whatever a container printed or was configured with, and network_scan pings the whole subnet. It also covers this MCP process only, so the CLI and homebutler serve on the same machine are unaffected. report stays available in read mode and never saves a snapshot there, so an agent can still be asked what changed. Without the flag, the server offers every tool, as before.
✨ Features
homebutler mcp --max-risk read|write|destructivesets the highest tool class the MCP server offers (#348). Withread, an agent can look but this server changes nothing: tools above the ceiling are left out oftools/listand refused when called by name, with an error naming the ceiling, andreportalways runs asno_saveagainst the last snapshot saved by cron or by hand. The default isdestructive, every tool, as before. Read mode stops changes, not reading, anddocs/mcp-server.mdsays which read tools ask things outside the machine (network_scanpings the subnet). A reducedtools/listis markedcacheScope: privateso a shared cache cannot hand it to another client