# parthmstech/pfsense-mcp

Source: https://glimind.com/server/glama%2Fparthmstech%2Fpfsense-mcp
Registry id: `glama/parthmstech/pfsense-mcp`
Status: unknown

## Tools (80)

- `add_alias_entry`: Add address entries to an existing alias. Args: alias: Name of the alias to add entries to (the API's ``id`` field — an alias's id is its name). address: Comma-
- `add_dhcpd_option`: Set a custom DHCP option on an interface. Args: interface: Interface to set the option on (lan/optN). Sent as ``parent_id``. option: DHCP option number (1-254).
- `add_dnsmasq_host_override_alias`: Add an alias to a DNS Forwarder (dnsmasq) host override. Args: override_id: ID of the host override to add the alias to. host: Hostname of the alias. domain: Do
- `add_schedule_time_range`
- `add_unbound_access_list_row`: Add a network row to a DNS Resolver (Unbound) access list. Args: list_id: ID of the access list to add the row to. row: Network address to match. Sent as ``netw
- `add_unbound_host_override_alias`: Add an alias to a DNS Resolver (Unbound) host override. Args: override_id: ID of the host override to add the alias to. host: Hostname of the alias. domain: Dom
- `apply_dns_forwarder`: Apply pending DNS Forwarder (dnsmasq) configuration changes.
- `apply_dns_resolver`: Apply pending DNS Resolver (Unbound) configuration changes.
- `apply_firewall_changes`: Apply pending firewall rule changes to the running config.
- `create_alias`
- `create_ca`: Create or import a certificate authority. Args: name: Descriptive name for the CA (maps to the contract's ``descr``). fields: Additional CA fields. The v1 contr
- `create_certificate`: Create or import a certificate. Args: name: Descriptive name for the certificate (maps to ``descr``). fields: Additional certificate fields. The v1 contract req
- `create_crl`: Create a certificate revocation list. Args: name: Descriptive name for the CRL (maps to ``descr``). fields: Additional CRL fields. The v1 contract requires ``ca
- `create_dhcp_reservation`: Create a DHCP static reservation. Args: interface: Interface the reservation applies to (lan/optN). Sent as ``parent_id``. mac: Client MAC address (e.g. 'aa:bb:
- `create_dnsmasq_host_override`: Create a DNS Forwarder (dnsmasq) host override. Args: host: Hostname portion of the override (e.g. 'www'). ip: IPv4 or IPv6 address the host resolves to. domain
- `create_firewall_rule`
- `create_schedule`: Create a firewall schedule. Args: name: Schedule name (1-32 chars, alphanumeric/underscore). timerange: List of time range objects for the schedule (required by
- `create_unbound_access_list`
- `create_unbound_host_override`: Create a DNS Resolver (Unbound) host override. Args: host: Hostname portion of the override (e.g. 'www'). ip: IPv4 or IPv6 address the host resolves to. May be 
- `create_virtual_ip`
- `delete_alias`: Delete an alias. Requires confirm=True. v2 targets the item via an ``id`` query parameter.
- `delete_alias_entry`: Remove an address entry from an alias. Requires confirm=True. Args: alias: Name of the alias to remove the entry from (the API's ``id`` field — an alias's id is
- `delete_ca`: Delete a certificate authority. Requires confirm=True. Args: ca_id: The ``refid`` of the CA to delete. confirm: Must be True to proceed.
- `delete_certificate`: Delete a certificate. Requires confirm=True. Args: cert_id: The ``refid`` of the certificate to delete. confirm: Must be True to proceed.
- `delete_crl`: Delete a certificate revocation list. Requires confirm=True. Args: crl_id: The ``refid`` of the CRL to delete. confirm: Must be True to proceed.
- `delete_dhcp_reservation`: Delete a DHCP static reservation. Requires confirm=True. Args: reservation_id: The reservation's id (from list_dhcp_reservations). interface: Interface the rese
- `delete_dnsmasq_host_override`: Delete a DNS Forwarder (dnsmasq) host override. Requires confirm=True. Args: override_id: ID of the host override to delete. confirm: Must be True to proceed. v
- `delete_firewall_rule`: Delete a firewall rule. Requires confirm=True. v2 targets the rule via an ``id`` query parameter.
- `delete_firewall_states`
- `delete_schedule`: Delete a firewall schedule. Requires confirm=True. v2 targets the schedule via an ``id`` query parameter (the schedule's name serves as its id).
- `delete_schedule_time_range`: Delete a time range from a firewall schedule. Requires confirm=True. Args: name: Name of the schedule to remove the range from (the API's ``parent_id``). time_r
- `delete_unbound_access_list`: Delete a DNS Resolver (Unbound) access list. Requires confirm=True. Args: list_id: ID of the access list to delete. confirm: Must be True to proceed. v2 targets
- `delete_unbound_access_list_row`: Delete a row from a DNS Resolver (Unbound) access list. Requires confirm=True. Args: list_id: ID of the access list the row belongs to. row_id: ID of the row wi
- `delete_unbound_host_override`: Delete a DNS Resolver (Unbound) host override. Requires confirm=True. Args: override_id: ID of the host override to delete. confirm: Must be True to proceed. v2
- `delete_virtual_ip`: Delete a virtual IP. Requires confirm=True. v2 targets the item via an ``id`` query parameter and applies the deletion immediately via the ``apply`` parameter.
- `dns_lookup`: Perform a DNS lookup for a hostname from the pfSense router. Args: host: Hostname to resolve.
- `flush_firewall_rules`: Delete all firewall rules. Requires confirm=True. v2 flushes the ruleset via the plural DELETE with ``all=true`` (the plural DELETE without ``all`` requires que
- `flush_unbound_host_overrides`: Remove all DNS Resolver (Unbound) host overrides. Requires confirm=True. Args: confirm: Must be True to proceed. v2 deletes the whole collection via DELETE on t
- `get_alias`: Get a single alias by name or ID. v2 targets the alias via the ``id`` query parameter — an alias's id is its name.
- `get_alias_advanced`: Get the advanced alias settings.
- `get_dhcpd_settings`: Get the DHCP Server (dhcpd) configuration for an interface. Args: interface: Interface to read settings for (lan/optN). v2 targets the interface via the ``id`` 
- `get_dns_resolver`: Get the DNS Resolver (Unbound) configuration.
- `get_dns_settings`: Get the system DNS server settings (upstream DNS servers, domain).
- `get_firewall_rule`: Get a single firewall rule by its ID. v2 targets the rule via the ``id`` query parameter — the rule's config index (the ``tracker`` field is read-only in v2).
- `get_firewall_states`: List the current firewall states table.
- `get_firewall_states_size`: Get the maximum number of firewall state entries.
- `list_aliases`: List all firewall aliases (host, network, port).
- `list_cas`: List all certificate authorities (CAs).
- `list_certificates`: List all certificates.
- `list_crls`: List all certificate revocation lists (CRLs).
- `list_dhcp_leases`: List all current DHCP leases.
- `list_dhcp_reservations`: List DHCP static reservations (MAC-to-IP mappings) on an interface. Args: interface: Interface to list reservations for (lan/optN). v2 returns mappings for all 
- `list_dnsmasq_host_overrides`: List DNS Forwarder (dnsmasq) host overrides.
- `list_firewall_rules`: List firewall rules, optionally filtered by interface (wan/lan/optN). v2 list endpoints do not filter by query params — the full collection is fetched and filte
- `list_interfaces`: List all pfSense interfaces with their configuration.
- `list_schedules`: List all firewall schedules.
- `list_unbound_access_lists`: List DNS Resolver (Unbound) access lists.
- `list_unbound_host_overrides`: List DNS Resolver (Unbound) host overrides.
- `list_virtual_ips`: List all virtual IPs.
- `ping`: Ping a host from the pfSense router. Args: host: Hostname or IP address to ping. count: Number of ping packets to send (1-100).
- `restart_dhcpd`: Restart the DHCP Server (dhcpd) service on an interface. Requires confirm=True. Args: interface: Interface to restart DHCP on (lan/optN). v2 acts on the dhcpd s
- `run_command`: Run an arbitrary shell command on the pfSense firewall. Requires confirm=True. WARNING: this executes the command with root privileges on the firewall. A mistak
- `sort_firewall_rules`: Sort existing firewall rules by a rule field. Args: field: Firewall rule field to sort by (e.g. 'tracker', 'descr'). option: ascend, descend, natural, numeric, 
- `start_dhcpd`: Start the DHCP Server (dhcpd) service on an interface. Args: interface: Interface to start DHCP on (lan/optN). v2 acts on the dhcpd service as a whole; the para
- `stop_dhcpd`: Stop the DHCP Server (dhcpd) service on an interface. Requires confirm=True. Args: interface: Interface to stop DHCP on (lan/optN). v2 acts on the dhcpd service
- `traceroute`: Run a traceroute from the pfSense router to a host. Args: host: Hostname or IP address to trace. max_hops: Maximum number of hops (1-64).
- `update_alias`: Update an existing alias. Only provided fields are changed. Args: alias_id: Alias name or ID. address: New comma-separated addresses/ports. description: New des
- `update_alias_advanced`: Update the advanced alias settings. Only provided fields change. Args: aliasesresolveinterval: Interval (seconds) at which hostnames in aliases are updated. che
- `update_certificate`: Update an existing certificate. Args: cert_id: The ``refid`` of the certificate to update. fields: Fields to change. The v1 contract requires ``crt`` and ``prv`
- `update_dhcpd_settings`
- `update_dns_resolver`: Update DNS Resolver (Unbound) settings. Args: fields: Unbound settings to change. Known fields: enable (bool), dnssec (bool), description (str), apply (bool). O
- `update_dns_settings`: Update the system DNS server settings. Args: servers: DNS servers to assign the system (replaces existing values). Sent as ``dnsserver``. domain: Optional domai
- `update_dnsmasq_host_override`: Update a DNS Forwarder (dnsmasq) host override. Args: override_id: ID of the host override to update (from list_dnsmasq_host_overrides). fields: Fields to chang
- `update_firewall_rule`
- `update_firewall_states_size`: Update the maximum number of firewall state entries. Args: maximumstates: Maximum state entries (integer, min 10).
- `update_schedule`: Update an existing firewall schedule. Only provided fields change. Args: name: Name of the schedule to update (a schedule's name serves as its id in v2). descri
- `update_unbound_access_list`: Update a DNS Resolver (Unbound) access list. Args: list_id: ID of the access list to update (from list_unbound_access_lists). fields: Fields to change (name, ac
- `update_unbound_host_override`: Update a DNS Resolver (Unbound) host override. Args: override_id: ID of the host override to update (from list_unbound_host_overrides). fields: Fields to change
- `update_virtual_ip`
- `wol_send`: Send a Wake-on-LAN (WOL) magic packet to a host. Args: mac: MAC address of the host to wake (e.g. 'aa:bb:cc:dd:ee:ff'). interface: Interface the host is connect

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
