opn-mcp (OPNsense)
access level: configurableโ Source-reviewed Oct 2026
We read this project's source code and tool definitions (Oct 2026). This is a code review, not a live test against real systems. Re-check after upgrades.
| Repository | https://github.com/bigbatmanorg/opn-mcp |
|---|---|
| Category | Network/firewall |
| Systems touched | OPNsense firewall: whole core + plugin API (2,469 endpoints, 26.7.4 index), firewall rules and logs, services, settings models |
| Access (as described) | configurable (read-only default) |
| License / price | BSD-2-Clause / free |
| GitHub stars | 1 |
| Read tools | opn_api_search, opn_api_describe, opn_overview, opn_neighbors, opn_firewall_log, opn_ping, opn_items/opn_settings get/search |
| Write / delete / exec tools | opn_api (any endpoint), opn_items add/set/del/toggle + apply, opn_settings set, opn_service, firmware update/reboot, opn_firewall_confirm / opn_firewall_revert_now |
| Read-only mode | Yes: read-only unless OPNSENSE_ALLOW_WRITES=true; destructive calls (delete, stop, reboot, firmware update, revert) also need confirm=true; firewall applies arm a 60 s auto-revert unless confirmed |
| Safety notes | OPNSENSE_VERIFY_SSL defaults to false in the code โ set true or a CA path. Use a dedicated API user limited to the pages you need, not root. The auto-revert timer lives in the server process, so it won't fire if the server stops mid-change. Very new single-maintainer project โ lab first. |
| Verified | yes (README + source review 2026-11-14) |
| Notes | Brand new (created 2026-11-03, v0.1.0). Generic API tools plus model CRUD and curated overview/service/firewall-log/ping tools; request bodies validated against OPNsense model XML. Added 2026-11-14. |
๐ฌ SysAdmin Agents
The SysAdmin Agents newsletter: new MCP servers, agent skills and safety notes for sysadmins. One email a week.