UniFi Network MCP server

Read from the package source without running it. The installed server may list more.

• unifi_adopt_device

  Adopt a pending device into the Unifi Network by MAC address

• unifi_archive_alarm

  Archive (resolve/dismiss) a specific alarm by its ID

• unifi_archive_all_alarms

  Archive (resolve/dismiss) all active alarms

• unifi_authorize_guest

  Authorize a guest client to access the guest network by MAC address

• unifi_block_client

  Block a client/device from the network by MAC address

• unifi_create_acl_rulewrite action

  Create a new MAC ACL rule for Layer 2 access control within a VLAN.

• unifi_create_client_groupwrite action

  Create a new client group (network member group).

• unifi_create_firewall_policywrite action

  Create a firewall policy. Auto-detects legacy vs zone-based format.

• unifi_create_networkwrite action

  Create a new network (LAN/VLAN) with schema validation. Requires confirmation.

• unifi_create_port_forwardwrite action

  Create a new port forwarding rule on your Unifi Network controller using schema validation.

• unifi_create_qos_rulewrite action

  Create a new QoS rule on the Unifi Network controller. Requires confirmation.

• unifi_create_routewrite action

  Create a new static route.

• unifi_create_simple_firewall_policywrite action

  Create a firewall rule with a compact schema and optional preview.

• unifi_create_simple_port_forwardwrite action

  Create port forward with compact input.

• unifi_create_simple_qos_rulewrite action

  Create a QoS rule with a compact schema and optional preview.

• unifi_create_usergroupwrite action

  Create a new user group.

• unifi_create_voucherwrite action

  Create one or more hotspot vouchers.

• unifi_create_wlanwrite action

  Create a new WLAN (SSID) with comprehensive validation.

• unifi_delete_acl_rulewrite action

  Delete a MAC ACL rule. Requires confirmation. WARNING: Removing an ALLOW rule

• unifi_delete_client_groupwrite action

  Delete a client group. Requires confirmation.

• unifi_delete_firewall_policywrite action

  Delete a firewall policy by ID.

• unifi_force_reconnect_client

  Force a client to reconnect to the network (kick) by MAC address

• unifi_get_acl_rule_details

  Get detailed configuration for a specific MAC ACL rule by ID.

• unifi_get_alerts

  Get recent alerts from the Unifi Network controller

• unifi_get_client_details

  Implementation for getting client details.

• unifi_get_client_group_details

  Get detailed configuration for a specific client group by ID.

• unifi_get_client_stats

  Get statistics for a specific client/device

• unifi_get_device_details

  Implementation for getting device details.

• unifi_get_device_radio

  Implementation for getting focused radio config and stats for an AP.

• unifi_get_device_stats

  Implementation for getting device stats.

• unifi_get_dpi_stats

  Get Deep Packet Inspection (DPI) statistics (applications and categories)

• unifi_get_event_types

  Get list of event type prefixes.

• unifi_get_firewall_policy_details

  Get detailed configuration for a specific firewall policy by ID.

• unifi_get_network_details

  Get details for a specific network by ID.

• unifi_get_network_health

  Implementation for getting network health.

• unifi_get_network_stats

  Get network statistics from the Unifi Network controller

• unifi_get_port_forward

  Get a specific port forwarding rule by ID from your Unifi Network controller.

• unifi_get_qos_rule_details

  Get details for a specific QoS rule by ID.

• unifi_get_route_details

  Get detailed information about a specific static route by its ID

• unifi_get_site_settings

  Get current site settings (e.g., country code, timezone, connectivity monitoring).

• unifi_get_snmp_settings

  Get current SNMP settings for the site (enabled state, community string).

• unifi_get_system_info

  Implementation for getting system info.

• unifi_get_top_clients

  Get a list of top clients by usage (sorted by total bytes)

• unifi_get_traffic_route_details

  Get detailed information for a specific traffic route by ID.

• unifi_get_usergroup_details

  Get detailed information about a specific user group by its ID

• unifi_get_voucher_details

  Get detailed information about a specific voucher by its ID

• unifi_get_vpn_client_details

  Get details for a specific VPN client by ID.

• unifi_get_vpn_server_details

  Get details for a specific VPN server by ID.

• unifi_get_wlan_details

  Get details for a specific WLAN by ID.

• unifi_list_acl_rules

  List MAC ACL rules (Policy Engine) for Layer 2 access control.

• unifi_list_active_routes

  List all active routes from the routing table.

• unifi_list_alarms

  List alarms with optional archived filter.

• unifi_list_blocked_clients

  List clients/devices that are currently blocked from the network

• unifi_list_client_groups

  List client groups (network member groups).

• unifi_list_clients

  Implementation for listing clients.

• unifi_list_devices

  Implementation for listing devices.

• unifi_list_events

  List events with optional filtering.

• unifi_list_firewall_policies

  Lists firewall policies for the current UniFi site.

• unifi_list_firewall_zones

  List controller firewall zones (V2 API).

• unifi_list_ip_groups

  List IP groups configured on the controller (V2 API).

• unifi_list_networks

  Lists all networks configured on the UniFi Network controller for the current site using the V1 API structure.

• unifi_list_port_forwards

  List all port forwarding rules on your Unifi Network controller.

• unifi_list_qos_rules

  List all QoS rules on the Unifi Network controller for the current site.

• unifi_list_routes

  List all user-defined static routes.

• unifi_list_traffic_routes

  List all traffic routes.

• unifi_list_usergroups

  List all user groups.

• unifi_list_vouchers

  List all hotspot vouchers.

• unifi_list_vpn_clients

  List all configured VPN clients (Wireguard, OpenVPN, etc).

• unifi_list_vpn_servers

  List all configured VPN servers (Wireguard, OpenVPN, L2TP, etc).

• unifi_list_wlans

  List all configured Wireless LANs (WLANs) on the Unifi Network controller.

• unifi_lookup_by_ip

  Quick IP-to-hostname lookup. Returns only essential fields (hostname, name, MAC) to minimize token usage.

• unifi_reboot_device

  Reboot a specific device by MAC address

• unifi_rename_client

  Rename a client/device in the Unifi Network controller by MAC address

• unifi_rename_device

  Rename a device in the Unifi Network controller by MAC address

• unifi_revoke_voucher

  Revoke/delete a hotspot voucher by its ID, preventing further use

• unifi_set_client_ip_settings

  Set fixed IP and/or local DNS record for a client.

• unifi_toggle_firewall_policy

  Enable or disable a specific firewall policy by ID.

• unifi_toggle_port_forward

  Toggle a port forwarding rule on or off on your Unifi Network controller.

• unifi_toggle_qos_rule_enabled

  Enable or disable a specific QoS rule by ID. Requires confirmation.

• unifi_toggle_traffic_route

  Toggle a traffic route on/off by ID.

• unifi_unauthorize_guest

  Revoke authorization for a guest client by MAC address

• unifi_unblock_client

  Unblock a previously blocked client/device by MAC address

• unifi_update_acl_rulewrite action

  Update an existing MAC ACL rule. Requires the full rule object (PUT replaces entire resource).

• unifi_update_client_groupwrite action

  Update an existing client group. Requires the full group object (PUT replaces entire resource).

• unifi_update_device_radiowrite action

  Implementation for updating AP radio settings.

• unifi_update_firewall_policywrite action

  Update specific fields of an existing firewall policy. Requires confirmation.

• unifi_update_networkwrite action

  Update specific fields of an existing network (LAN/VLAN). Requires confirmation. Note: Network isolation is only supported on 'corporate' networks, not 'guest' networks.

• unifi_update_port_forwardwrite action

  Update specific fields of an existing port forwarding rule using schema validation. Requires confirmation.

• unifi_update_qos_rulewrite action

  Update specific fields of an existing QoS rule. Requires confirmation.

• unifi_update_routewrite action

  Update an existing static route.

• unifi_update_snmp_settingswrite action

  Update SNMP settings for the site (enable/disable, set community string). Requires confirm=true to apply changes.

• unifi_update_traffic_routewrite action

  Update a traffic route's settings.

• unifi_update_usergroupwrite action

  Update an existing user group.

• unifi_update_vpn_client_statewrite action

  Enable or disable a specific VPN client by ID.

• unifi_update_vpn_server_statewrite action

  Enable or disable a specific VPN server by ID.

• unifi_update_wlanwrite action

  Update specific fields of an existing WLAN (SSID). Requires confirmation.

• unifi_upgrade_device

  Initiate a firmware upgrade for a device by MAC address (uses cached firmware by default)

• Code scan49 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 1 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

UniFi Network MCP: common questions

Is UniFi Network MCP server safe?

Mostly: it is graded B (83/100). Read the UniFi Network MCP safety report

How do I install UniFi Network MCP?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does UniFi Network MCP need an API key?

Yes. The registry entry asks for UNIFI_USERNAME, UNIFI_PASSWORD, UNIFI_API_KEY.

Is UniFi Network MCP maintained?

The last commit was in the last day (2026-09-27). The latest release is v0.7.8.