Mcp Pfsense
by antonio-mello-aicommunityv0.1.1
3
This MCP server manages pfSense firewalls through AI assistants like Claude, ChatGPT, and Copilot.
From the registry: Manage pfSense firewalls through AI assistants — rules, DHCP, DNS, and more
Install & configure
Prerequisites
- requiredpfSense with pfrest packageInstall pfrest package on pfSense to provide REST APIhttps://github.com/pfrest/pfSense-pkg-RESTAPI
- requiredpfSense API userCreate a user account with API access
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `mcp-pfsense` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **pfSense with pfrest package** — Install pfrest package on pfSense to provide REST API (https://github.com/pfrest/pfSense-pkg-RESTAPI)
- **pfSense API user** — Create a user account with API access
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["mcp-pfsense"]
- required environment variables:
- `PFSENSE_HOST`: pfSense hostname or IP (example: `10.10.10.1`)
- `PFSENSE_PASSWORD`: API user password (example: `<your-password>`)
- optional environment variables:
- `PFSENSE_USERNAME`: API username (example: `admin`)
- `PFSENSE_PORT`: API port (example: `443`)
- `PFSENSE_SCHEME`: http or https (example: `https`)
- `PFSENSE_VERIFY_SSL`: Verify SSL certificate (example: `false`)
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Tools (17)
get_system_status
Provides system version, CPU, memory, uptime, and temperature.
get_interfaces
Lists network interfaces.
list_firewall_rules
Manages firewall rules with interface filtering.
add_firewall_rule
Adds a new firewall rule.
delete_firewall_rule
Deletes an existing firewall rule.
list_firewall_aliases
Lists firewall aliases.
list_dhcp_leases
Lists active DHCP leases.
list_dhcp_static_mappings
Lists DHCP static mappings.
add_dhcp_static_mapping
Adds a new DHCP static mapping.
delete_dhcp_static_mapping
Deletes an existing DHCP static mapping.
list_dns_host_overrides
Lists DNS host overrides.
add_dns_host_override
Adds a new DNS host override.
delete_dns_host_override
Deletes an existing DNS host override.
get_gateway_status
Provides gateway health status.
Environment variables
PFSENSE_HOSTrequiredpfSense hostname or IP.PFSENSE_PASSWORDrequiredAPI user password.Packages
mcp-pfsense
pypiv0.1.1transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- Mar 10, 2026
- Last commit
- Mar 10, 2026
- Registry name
- io.github.antonio-mello-ai/mcp-pfsense