Index / Network/firewall

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.
Repositoryhttps://github.com/bigbatmanorg/opn-mcp
CategoryNetwork/firewall
Systems touchedOPNsense 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 / priceBSD-2-Clause / free
GitHub stars1 (checked Oct 2026)
Read toolsopn_api_search, opn_api_describe, opn_overview, opn_neighbors, opn_firewall_log, opn_ping, opn_items/opn_settings get/search
Write / delete / exec toolsopn_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 modeYes: 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 notesOPNSENSE_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.
Verifiedyes (README + source review 2026-11-14)
NotesBrand 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.