MCP server · Security
OPNsense MCP server
by coreyhines
Ask your AI about your OPNsense firewall and let it check logs, devices, rules and traffic for you.

This is a helper that connects your AI assistant to your OPNsense firewall. Instead of logging into the firewall yourself and clicking around, you just ask a question in plain words and the AI looks it up for you. It is handy for anyone who runs a home lab or looks after a small office network.
What is an MCP server? The 30-second version
On its own, your AI can only chat. An MCP server is a small helper program that gives your AI a new skill or a connection to another app. This one connects your AI to your OPNsense firewall, so the AI can look things up or make changes there when you ask. You set it up once, and after that it just works in the background while you talk to your AI.
What this MCP server does
You ask your AI something about your firewall, like what devices are on the network or what got blocked today. The AI passes that request to this helper program. The helper talks to your OPNsense firewall over its API, which is just a way for programs to ask the firewall questions. The firewall sends back the data, and the AI turns it into a clear answer for you. For rule changes, the helper can also tell the firewall to add, edit, turn on or off, or remove a rule.
Click to zoomWhat you can do with it
- See which devices are on your network right now
- Check DHCP leases to find which device has which address
- Read recent firewall logs and see what was blocked
- List your firewall rules and their current state
- Add, edit, turn on or off, or remove a firewall rule
- Check system status and interface information
- Capture packets from traffic you want to inspect
Try asking your AI
- “What's happening on my network right now?”
- “Show me the latest firewall blocks from the last hour.”
- “Tell me about the host at 192.168.1.42.”
- “Capture packets from the suspicious traffic on the WAN interface.”
What it gives back to you
You get answers in the chat, in plain language. That might be a list of devices, a summary of recent blocks, the details of a rule, or the status of an interface. If you asked for a packet capture, you get the capture data back. If you asked it to change a rule, it tells you what it changed.
Before you start
What you need
- An OPNsense firewall you can reach on your network
- An API key and API secret from your OPNsense firewall (these are like a username and password for programs; you create them in the firewall settings)
- The address of your firewall, like firewall.local or an IP address
- Python and the uv tool installed on the computer running the helper
Good to know
This helper can change your firewall rules, so a wrong request could open or close network access by mistake; check before you let it make changes.
Install it with your AI
Add OPNsense MCP server to your AI, no technical skills needed
You don't install anything by hand. You copy one prompt, paste it into an AI that can work on your computer, and it checks, installs and connects the server for you, asking you when it needs something.
Sign in to get the install prompt
Members get a ready-made prompt that lets the Claude desktop app check OPNsense MCP server, install it and connect it for them, step by step. You don't need any technical skills: you copy, paste and answer a few questions. Your connected AI can also find and install any of the 4,066 MCP servers here for you.
Who it's for
Home lab owners, small office admins, and IT or security people who look after an OPNsense firewall and want quick answers without logging in.





