Pfsense MCP Server

Managing a pfSense firewall means clicking through web UI tabs, remembering field names, and hoping you don't fat-finger a rule that locks you out.

Local serverstdioPython

What is the Pfsense MCP Server?

Managing a pfSense firewall means clicking through web UI tabs, remembering field names, and hoping you don't fat-finger a rule that locks you out. With this MCP

What the server does

  • Every destructive operation requires explicit confirmation and shows you exactly what will happen
  • Automatic config backup before every delete/reboot — with a one-line rollback command
  • Rate limiting prevents runaway AI loops from flooding your firewall with rules
  • Input sanitization blocks command injection, path traversal, and XSS in every parameter

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
tvlcWebGUI port type-mismatch report (#7)

How to install the Pfsense MCP Server

{
  "mcpServers": {
    "pfsense": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gensecaihq/pfsense-mcp-server@v1.1.0",
        "pfsense-mcp-server"
      ],
      "env": {
        "PFSENSE_URL": "https://192.168.1.1",
        "AUTH_METHOD": "basic",
        "PFSENSE_USERNAME": "admin",
        "PFSENSE_PASSWORD": "YOUR_PFSENSE_PASSWORD",
        "PFSENSE_VERSION": "CE_2_8_1",
        "PFSENSE_CA_FILE": "/path/to/pfsense-ca.pem"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PFSENSE_URLDeclared in the maintainer’s client configuration.Check documentation
AUTH_METHODDeclared in the maintainer’s client configuration.Check documentation
PFSENSE_USERNAMEDeclared in the maintainer’s client configuration.Check documentation
PFSENSE_PASSWORDDeclared in the maintainer’s client configuration.Check documentation
PFSENSE_VERSIONDeclared in the maintainer’s client configuration.Check documentation
PFSENSE_CA_FILEDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Pfsense to tvlc.”
  • “Use Pfsense to Domain.”
  • “Use Pfsense to Aliases.”

Frequently asked questions

Managing a pfSense firewall means clicking through web UI tabs, remembering field names, and hoping you don't fat-finger a rule that locks you out. With this MCP Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.