the-real-unifi-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UNIFI_API_KEY | Yes | Site Manager API key with Network scope. Create one at unifi.ui.com under Settings → API. | |
| UNIFI_API_BASE | No | API base URL. This host receives the API key. Must be https:// (plain http:// only for 127.0.0.1, [::1] or localhost) and an origin without path, query or fragment. | https://api.ui.com |
| UNIFI_LOG_LEVEL | No | Log level: debug | info | warn | error. | info |
| UNIFI_CONSOLE_ID | No | Override discovery by pinning to a specific UniFi console. | |
| UNIFI_TIMEOUT_MS | No | Per-request timeout in milliseconds, covering the response headers and the body. | 30000 |
| UNIFI_CONFIRM_WRITES | No | If on, destructive tools require confirm: "YES". Only false, 0, no or off (any case) turn it off. Unset, empty, true, 1, yes and on keep it on; an unknown value keeps it on and logs a warning. | true |
| UNIFI_NETWORK_SITE_ID | No | Override discovery by pinning to a specific Network site. | |
| UNIFI_SITE_MANAGER_SITE_ID | No | Override discovery by pinning to a specific Site Manager site. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| unifi_raw_requestA | Generic escape hatch: executes ANY HTTP method against api.ui.com{path}. Use when no dedicated tool exists. Auth, retry, error parsing and pagination hints are handled automatically. |
| unifi_sm_list_hostsB | Account-level: list all UniFi consoles linked to this Site Manager account. |
| unifi_sm_get_hostB | Account-level: detail for a single host (console). |
| unifi_sm_list_sitesC | Account-level sites. |
| unifi_sm_list_devicesA | Account-level devices view (not the deep Network-API per-site list). |
| unifi_sm_get_isp_metricsC | ISP metrics for a granularity bucket. |
| unifi_sm_query_isp_metricsC | POST a time-window query for ISP metrics. |
| unifi_sm_list_sdwan_configsC | Account-level SD-WAN configurations. |
| unifi_sm_get_sdwan_configC | Get a single SD-WAN configuration. |
| unifi_sm_get_sdwan_config_statusC | Status of a SD-WAN configuration. |
| unifi_sm_identityB | Returns consoleId, networkSiteId, siteManagerSiteId: useful for sanity checks. |
| unifi_net_get_infoA | Reads /v1/info on the Network application via the Cloud Connector. Useful as a health probe. |
| unifi_net_list_sitesA | Lists the local sites that the Network application exposes (NOT the same as Site Manager sites). |
| unifi_net_list_devicesC | Adopted UniFi devices on the current site. |
| unifi_net_get_deviceC | Detail for a single adopted device. |
| unifi_net_get_device_statsD | Latest statistics snapshot. |
| unifi_net_list_pending_devicesB | Devices waiting to be adopted (console-level, no siteId required). |
| unifi_net_adopt_devicesB | Adopts pending devices by MAC. Sends one adoption request per MAC and reports the result per MAC. |
| unifi_net_device_actionC | Generic device action. Uses the |
| unifi_net_reboot_deviceC | Convenience wrapper over device_action with action=RESTART. |
| unifi_net_port_actionC | Action on a switch port. Vendor value: POWER_CYCLE (PoE power-cycle; "power-cycle" is mapped). |
| unifi_net_remove_deviceC | Removes an adopted device from the site. |
| unifi_net_list_clientsC | Currently connected clients on the site. |
| unifi_net_get_clientC | Detail for a connected client by id. |
| unifi_net_client_actionA | Action on a connected client. Vendor values: AUTHORIZE_GUEST_ACCESS, UNAUTHORIZE_GUEST_ACCESS (lowercase and dashes are mapped). The Network API has no block/unblock action. |
| unifi_net_block_clientA | Not supported: the UniFi Network API defines no block action for clients, so this tool returns an error and sends nothing. Kept for compatibility. |
| unifi_net_unblock_clientA | Not supported: the UniFi Network API defines no unblock action for clients, so this tool returns an error and sends nothing. Kept for compatibility. |
| unifi_net_list_networksC | Networks configured on the current site. |
| unifi_net_get_networkC | Detail for one network. |
| unifi_net_get_network_referencesC | References to this network from other objects. |
| unifi_net_create_networkC | Creates a new network on the current site. Body shape per Network API docs. |
| unifi_net_update_networkC | Updates an existing network. |
| unifi_net_delete_networkC | Deletes a network. IRREVERSIBLE. |
| unifi_net_list_wifiD | WLAN broadcasts. |
| unifi_net_get_wifiD | Detail for a WLAN. |
| unifi_net_create_wifiC | Creates a new WLAN. |
| unifi_net_update_wifiC | Updates an existing WLAN. |
| unifi_net_delete_wifiB | Deletes a WLAN. IRREVERSIBLE. |
| unifi_net_list_firewall_zonesC | Lists all firewall zones on the current site. |
| unifi_net_get_firewall_zoneC | Detail for one firewall zone. |
| unifi_net_create_firewall_zoneC | Creates a new firewall zone on the current site. Body shape per Firewall API docs. |
| unifi_net_update_firewall_zoneC | Updates an existing firewall zone. |
| unifi_net_delete_firewall_zoneB | Deletes a firewall zone. IRREVERSIBLE. |
| unifi_net_list_firewall_policiesC | Lists all firewall policies on the current site. |
| unifi_net_get_firewall_policyC | Detail for one firewall policy. |
| unifi_net_create_firewall_policyC | Creates a new firewall policy on the current site. Body shape per Firewall API docs. |
| unifi_net_update_firewall_policyC | Updates an existing firewall policy (full replacement). |
| unifi_net_patch_firewall_policyB | Partially updates an existing firewall policy (PATCH semantics). |
| unifi_net_delete_firewall_policyC | Deletes a firewall policy. IRREVERSIBLE. |
| unifi_net_get_firewall_policy_orderingA | Returns the current ordering of firewall policies on the current site. |
| unifi_net_reorder_firewall_policiesC | Sets the ordering of firewall policies on the current site. |
| unifi_net_list_acl_rulesB | Lists all ACL rules on the current site. |
| unifi_net_get_acl_ruleC | Detail for one ACL rule on the current site. |
| unifi_net_create_acl_ruleC | Creates a new ACL rule on the current site. Body shape per ACL API docs. |
| unifi_net_update_acl_ruleC | Updates an existing ACL rule on the current site (full replacement). |
| unifi_net_delete_acl_ruleC | Deletes an ACL rule on the current site. IRREVERSIBLE. |
| unifi_net_get_acl_rule_orderingA | Returns the current ordering of ACL rules on the current site. |
| unifi_net_reorder_acl_rulesC | Sets the ordering of ACL rules on the current site. |
| unifi_net_list_dns_policiesB | Lists all DNS policies configured on the current site. |
| unifi_net_get_dns_policyC | Detail for one DNS policy. |
| unifi_net_create_dns_policyC | Creates a new DNS policy on the current site. Body shape per Network API docs. |
| unifi_net_update_dns_policyC | Updates an existing DNS policy. |
| unifi_net_delete_dns_policyC | Deletes a DNS policy. IRREVERSIBLE. |
| unifi_net_list_traffic_listsB | Lists all traffic matching lists configured on the current site. |
| unifi_net_get_traffic_listC | Detail for one traffic matching list. |
| unifi_net_create_traffic_listC | Creates a new traffic matching list on the current site. Body shape per Network API docs. |
| unifi_net_update_traffic_listC | Updates an existing traffic matching list. |
| unifi_net_delete_traffic_listC | Deletes a traffic matching list. IRREVERSIBLE. |
| unifi_net_list_vouchersC | Hotspot vouchers configured on the current site. |
| unifi_net_get_voucherC | Hotspot voucher detail for a single voucher. |
| unifi_net_create_vouchersC | Generates one or more hotspot vouchers. Body shape per UniFi docs (count, name, duration, …). |
| unifi_net_delete_voucherB | Deletes a single hotspot voucher. |
| unifi_net_delete_vouchersA | Deletes all vouchers matching |
| unifi_net_list_switch_stacksC | Switch stacks configured on the current site. |
| unifi_net_get_switch_stackC | Switch stack detail for a single stack. |
| unifi_net_list_mclag_domainsC | MCLAG domains configured on the current site. |
| unifi_net_get_mclag_domainC | MCLAG domain detail for a single domain. |
| unifi_net_list_lagsC | Link Aggregation Groups (LAGs) configured on the current site. |
| unifi_net_get_lagC | Link Aggregation Group (LAG) detail for a single LAG. |
| unifi_net_list_wansB | WAN interfaces configured on the current site. |
| unifi_net_list_site_to_site_vpnC | Site-to-site VPN tunnels configured on the current site. |
| unifi_net_list_vpn_serversC | VPN servers configured on the current site. |
| unifi_net_list_radius_profilesC | RADIUS profiles configured on the current site. |
| unifi_net_list_device_tagsC | Device tags configured on the current site. |
| unifi_net_list_dpi_application_categoriesC | DPI application categories known to the UniFi Network API (console-level, no siteId required). |
| unifi_net_list_dpi_applicationsC | DPI applications known to the UniFi Network API (console-level, no siteId required). |
| unifi_net_list_countriesB | List of countries available in the UniFi Network API (console-level, no siteId required). |
| unifi_gen_listhostsC | List Hosts - generated from developer.ui.com/site-manager/v1.0.0/listhosts |
| unifi_gen_gethostbyidC | Get Host by ID - generated from developer.ui.com/site-manager/v1.0.0/gethostbyid |
| unifi_gen_listsitesC | List Sites - generated from developer.ui.com/site-manager/v1.0.0/listsites |
| unifi_gen_listdevicesC | List Devices - generated from developer.ui.com/site-manager/v1.0.0/listdevices |
| unifi_gen_getispmetricsC | Get ISP Metrics - generated from developer.ui.com/site-manager/v1.0.0/getispmetrics |
| unifi_gen_queryispmetricsC | Query ISP Metrics - generated from developer.ui.com/site-manager/v1.0.0/queryispmetrics |
| unifi_gen_listsdwanconfigsB | List SD-WAN Configs - generated from developer.ui.com/site-manager/v1.0.0/listsdwanconfigs |
| unifi_gen_getsdwanconfigbyidC | Get SD-WAN Config by ID - generated from developer.ui.com/site-manager/v1.0.0/getsdwanconfigbyid |
| unifi_gen_getsdwanconfigstatusC | Get SD-WAN Config Status - generated from developer.ui.com/site-manager/v1.0.0/getsdwanconfigstatus |
| unifi_gen_getinfoC | Get Application Info - generated from developer.ui.com/network/v11.0.97/getinfo |
| unifi_gen_getsiteoverviewpageC | List Local Sites - generated from developer.ui.com/network/v11.0.97/getsiteoverviewpage |
| unifi_gen_getadopteddeviceoverviewpageC | List Adopted Devices - generated from developer.ui.com/network/v11.0.97/getadopteddeviceoverviewpage |
| unifi_gen_getadopteddevicedetailsC | Get Adopted Device Details - generated from developer.ui.com/network/v11.0.97/getadopteddevicedetails |
| unifi_gen_getadopteddevicelateststatisticsC | Get Latest Adopted Device Statistics - generated from developer.ui.com/network/v11.0.97/getadopteddevicelateststatistics |
| unifi_gen_getpendingdevicepageC | List Devices Pending Adoption - generated from developer.ui.com/network/v11.0.97/getpendingdevicepage |
| unifi_gen_adoptdeviceC | Adopt Devices - generated from developer.ui.com/network/v11.0.97/adoptdevice |
| unifi_gen_executeportactionC | Execute Port Action - generated from developer.ui.com/network/v11.0.97/executeportaction |
| unifi_gen_executeadopteddeviceactionD | Execute Adopted Device Action - generated from developer.ui.com/network/v11.0.97/executeadopteddeviceaction |
| unifi_gen_removedeviceB | Remove (Unadopt) Device - generated from developer.ui.com/network/v11.0.97/removedevice |
| unifi_gen_getconnectedclientoverviewpageC | List Connected Clients - generated from developer.ui.com/network/v11.0.97/getconnectedclientoverviewpage |
| unifi_gen_getconnectedclientdetailsC | Get Connected Client Details - generated from developer.ui.com/network/v11.0.97/getconnectedclientdetails |
| unifi_gen_executeconnectedclientactionC | Execute Client Action - generated from developer.ui.com/network/v11.0.97/executeconnectedclientaction |
| unifi_gen_getnetworksoverviewpageC | List Networks - generated from developer.ui.com/network/v11.0.97/getnetworksoverviewpage |
| unifi_gen_getnetworkdetailsD | Get Network Details - generated from developer.ui.com/network/v11.0.97/getnetworkdetails |
| unifi_gen_getnetworkreferencesD | Get Network References - generated from developer.ui.com/network/v11.0.97/getnetworkreferences |
| unifi_gen_createnetworkC | Create Network - generated from developer.ui.com/network/v11.0.97/createnetwork |
| unifi_gen_updatenetworkD | Update Network - generated from developer.ui.com/network/v11.0.97/updatenetwork |
| unifi_gen_deletenetworkC | Delete Network - generated from developer.ui.com/network/v11.0.97/deletenetwork |
| unifi_gen_getwifibroadcastpageC | List Wifi Broadcasts - generated from developer.ui.com/network/v11.0.97/getwifibroadcastpage |
| unifi_gen_getwifibroadcastdetailsC | Get Wifi Broadcast Details - generated from developer.ui.com/network/v11.0.97/getwifibroadcastdetails |
| unifi_gen_createwifibroadcastC | Create Wifi Broadcast - generated from developer.ui.com/network/v11.0.97/createwifibroadcast |
| unifi_gen_updatewifibroadcastC | Update Wifi Broadcast - generated from developer.ui.com/network/v11.0.97/updatewifibroadcast |
| unifi_gen_deletewifibroadcastC | Delete Wifi Broadcast - generated from developer.ui.com/network/v11.0.97/deletewifibroadcast |
| unifi_gen_getvouchersC | List Vouchers - generated from developer.ui.com/network/v11.0.97/getvouchers |
| unifi_gen_getvoucherC | Get Voucher Details - generated from developer.ui.com/network/v11.0.97/getvoucher |
| unifi_gen_createvouchersC | Generate Vouchers - generated from developer.ui.com/network/v11.0.97/createvouchers |
| unifi_gen_deletevouchersC | Delete Vouchers - generated from developer.ui.com/network/v11.0.97/deletevouchers |
| unifi_gen_deletevoucherC | Delete Voucher - generated from developer.ui.com/network/v11.0.97/deletevoucher |
| unifi_gen_getfirewallzonesC | List Firewall Zones - generated from developer.ui.com/network/v11.0.97/getfirewallzones |
| unifi_gen_getfirewallzoneD | Get Firewall Zone - generated from developer.ui.com/network/v11.0.97/getfirewallzone |
| unifi_gen_createfirewallzoneC | Create Custom Firewall Zone - generated from developer.ui.com/network/v11.0.97/createfirewallzone |
| unifi_gen_updatefirewallzoneC | Update Firewall Zone - generated from developer.ui.com/network/v11.0.97/updatefirewallzone |
| unifi_gen_deletefirewallzoneC | Delete Custom Firewall Zone - generated from developer.ui.com/network/v11.0.97/deletefirewallzone |
| unifi_gen_getfirewallpoliciesC | List Firewall Policies - generated from developer.ui.com/network/v11.0.97/getfirewallpolicies |
| unifi_gen_getfirewallpolicyC | Get Firewall Policy - generated from developer.ui.com/network/v11.0.97/getfirewallpolicy |
| unifi_gen_createfirewallpolicyC | Create Firewall Policy - generated from developer.ui.com/network/v11.0.97/createfirewallpolicy |
| unifi_gen_updatefirewallpolicyC | Update Firewall Policy - generated from developer.ui.com/network/v11.0.97/updatefirewallpolicy |
| unifi_gen_patchfirewallpolicyC | Patch Firewall Policy - generated from developer.ui.com/network/v11.0.97/patchfirewallpolicy |
| unifi_gen_deletefirewallpolicyC | Delete Firewall Policy - generated from developer.ui.com/network/v11.0.97/deletefirewallpolicy |
| unifi_gen_getfirewallpolicyorderingC | Get User-Defined Firewall Policy Ordering - generated from developer.ui.com/network/v11.0.97/getfirewallpolicyordering |
| unifi_gen_updatefirewallpolicyorderingC | Reorder User-Defined Firewall Policies - generated from developer.ui.com/network/v11.0.97/updatefirewallpolicyordering |
| unifi_gen_getaclrulepageC | List ACL Rules - generated from developer.ui.com/network/v11.0.97/getaclrulepage |
| unifi_gen_getaclruleC | Get ACL Rule - generated from developer.ui.com/network/v11.0.97/getaclrule |
| unifi_gen_createaclruleC | Create ACL Rule - generated from developer.ui.com/network/v11.0.97/createaclrule |
| unifi_gen_updateaclruleC | Update ACL Rule - generated from developer.ui.com/network/v11.0.97/updateaclrule |
| unifi_gen_deleteaclruleC | Delete ACL Rule - generated from developer.ui.com/network/v11.0.97/deleteaclrule |
| unifi_gen_getaclruleorderingB | Get User-Defined ACL Rule Ordering - generated from developer.ui.com/network/v11.0.97/getaclruleordering |
| unifi_gen_updateaclruleorderingC | Reorder User-Defined ACL Rules - generated from developer.ui.com/network/v11.0.97/updateaclruleordering |
| unifi_gen_getswitchstackpageC | List Switch Stacks - generated from developer.ui.com/network/v11.0.97/getswitchstackpage |
| unifi_gen_getswitchstackC | Get Switch Stack - generated from developer.ui.com/network/v11.0.97/getswitchstack |
| unifi_gen_getmclagdomainpageC | List MC-LAG Domains - generated from developer.ui.com/network/v11.0.97/getmclagdomainpage |
| unifi_gen_getmclagdomainC | Get MC-LAG Domain - generated from developer.ui.com/network/v11.0.97/getmclagdomain |
| unifi_gen_getlagpageC | List LAGs - generated from developer.ui.com/network/v11.0.97/getlagpage |
| unifi_gen_getlagC | Get LAG Details - generated from developer.ui.com/network/v11.0.97/getlag |
| unifi_gen_getdnspolicypageC | List DNS Policies - generated from developer.ui.com/network/v11.0.97/getdnspolicypage |
| unifi_gen_getdnspolicyC | Get DNS Policy - generated from developer.ui.com/network/v11.0.97/getdnspolicy |
| unifi_gen_creatednspolicyC | Create DNS Policy - generated from developer.ui.com/network/v11.0.97/creatednspolicy |
| unifi_gen_updatednspolicyC | Update DNS Policy - generated from developer.ui.com/network/v11.0.97/updatednspolicy |
| unifi_gen_deletednspolicyC | Delete DNS Policy - generated from developer.ui.com/network/v11.0.97/deletednspolicy |
| unifi_gen_gettrafficmatchinglistsC | List Traffic Matching Lists - generated from developer.ui.com/network/v11.0.97/gettrafficmatchinglists |
| unifi_gen_gettrafficmatchinglistC | Get Traffic Matching List - generated from developer.ui.com/network/v11.0.97/gettrafficmatchinglist |
| unifi_gen_createtrafficmatchinglistC | Create Traffic Matching List - generated from developer.ui.com/network/v11.0.97/createtrafficmatchinglist |
| unifi_gen_updatetrafficmatchinglistC | Update Traffic Matching List - generated from developer.ui.com/network/v11.0.97/updatetrafficmatchinglist |
| unifi_gen_deletetrafficmatchinglistC | Delete Traffic Matching List - generated from developer.ui.com/network/v11.0.97/deletetrafficmatchinglist |
| unifi_gen_getwansoverviewpageC | List WAN Interfaces - generated from developer.ui.com/network/v11.0.97/getwansoverviewpage |
| unifi_gen_getsitetositevpntunnelpageC | List Site-To-Site VPN Tunnels - generated from developer.ui.com/network/v11.0.97/getsitetositevpntunnelpage |
| unifi_gen_getvpnserverpageC | List VPN Servers - generated from developer.ui.com/network/v11.0.97/getvpnserverpage |
| unifi_gen_getradiusprofileoverviewpageC | List Radius Profiles - generated from developer.ui.com/network/v11.0.97/getradiusprofileoverviewpage |
| unifi_gen_getdevicetagpageC | List Device Tags - generated from developer.ui.com/network/v11.0.97/getdevicetagpage |
| unifi_gen_getdpiapplicationcategoriesC | List DPI Application Categories - generated from developer.ui.com/network/v11.0.97/getdpiapplicationcategories |
| unifi_gen_getdpiapplicationsC | List DPI Applications - generated from developer.ui.com/network/v11.0.97/getdpiapplications |
| unifi_gen_getcountriesC | List Countries - generated from developer.ui.com/network/v11.0.97/getcountries |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| unifi-audit-firewall | Walks firewall zones and policies; flags disabled rules, broad allow-any-any rules, policies without descriptions and rules without logging; suggests hardening. |
| unifi-network-health | Summarises configured WANs, device states and firmware updates, and connected clients. |
| unifi-adoption-status | Reports pending adoptions and recommends accept/reject. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| unifi-identity | Discovery output: consoleId + both siteIds + console metadata. |
| unifi-hosts | GET /v1/hosts: list of consoles linked to this Site Manager account. |
TDQS
Scored across 169 tools
The set contains extensive duplication between curated tools and generated tools, e.g. unifi_net_list_networks vs unifi_gen_getnetworksoverviewpage, unifi_net_get_voucher vs unifi_gen_getvoucher, and multiple voucher/firewall/traffic-list variants. Some tools are also near-overlapping actions, such as unifi_net_device_action, unifi_net_reboot_device, and unifi_gen_executeadopteddeviceaction. An agent can often distinguish by prefix, but many boundaries are confusing.
Names mix three families: unifi_net_* snake_case, unifi_sm_* snake_case, and unifi_gen_* concatenated generated endpoint names like unifi_gen_getadopteddeviceoverviewpage. Even within the generated family, verb+resource casing is inconsistent and hard to parse. The surface is not predictable enough for reliable tool selection.
169 tools is far beyond a well-scoped MCP surface and includes many duplicate generated/curated pairs. This volume creates selection noise and maintenance burden rather than a coherent toolkit. The count is an extreme mismatch for practical agent use.
Coverage is broad across networks, Wi-Fi, firewall zones/policies, ACL rules, DNS policies, traffic lists, vouchers, devices, clients, SD-WAN, VPN, and ISP metrics, with many CRUD operations. There are notable dead-end compatibility tools such as unifi_net_block_client and unifi_net_unblock_client that intentionally error, and some resources are read-only, but the overall surface is extensive.