Setup guide

Set up pfsense-mcp-server in Windsurf

communitystdiounknown

Model Context Protocol (MCP) server for pfSense firewall management. Control firewall rules, VPNs, DNS, DHCP and diagnostics in natural language from Claude Desktop, Claude Code or any MCP client — 333 wire-format-verified tools for the pfSense REST API, with safety guardrails, config backup and rollback on every change.

01Configuration

{
  "mcpServers": {
    "pfsense-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gensecaihq/pfsense-mcp-server",
        "pfsense-mcp-server"
      ]
    }
  }
}

Add this to ~/.codeium/windsurf/mcp_config.json. Generated from the captured install method (uvx); the mcpServers shape is shared across Claude Desktop, Cursor, Windsurf, Cline, and VS Code.

02Steps

Make sure Windsurf is installed and up to date.
Open ~/.codeium/windsurf/mcp_config.json and add the block above (merge into any existing mcpServers).
Provide any required API keys/credentials as environment variables.
Restart Windsurf and confirm pfsense-mcp-server’s tools appear.

03Other runtimes

Claude Desktop Cursor Cline Continue Goose VS Code OpenAI Agents SDK LangGraph CrewAI

04Provenance

config_sourcegenerated from captured install method

last_checked2026-08-16 17:54Z

sourcesGitHub repo search [p4]

Next step

Want agents that act within guardrails? Apex is the live governed-agent product — paced, capped, and fully-logged actions with approvals before anything runs.

Explore Apex →

See also: server page · is it safe? · alternatives