unifi-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UNIFI_TOOLS | No | Comma-sep allowlist of categories. | |
| MCP_HTTP_HOST | No | HTTP bind host | 127.0.0.1 |
| MCP_HTTP_PORT | No | HTTP listen port | 3000 |
| MCP_TRANSPORT | No | http to enable Streamable HTTP transport | stdio |
| UNIFI_API_KEY | Yes | API key from unifi.ui.com (any admin role) | |
| UNIFI_API_URL | No | API base URL | https://api.ui.com/v1 |
| UNIFI_DISABLE | No | Comma-sep denylist. Ignored when UNIFI_TOOLS is set. | |
| MCP_HTTP_TOKEN | No | Bearer token. Required when MCP_TRANSPORT=http | |
| MCP_HTTP_SKIP_AUTH | No | Skip Bearer auth | false |
| UNIFI_API_KEY_OWNER | No | Owner-role API key — enables 35 Cloud Connector tools. If your key has owner role, set this to the same value. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list-sites-overview | Get a health overview of all UniFi sites with status, issues, and device counts |
| analyze-site-health | Analyze health of a specific site by name (e.g., 'USM'). Returns device status, WAN info, reboot detection |
| detect-recent-reboots | Detect devices that rebooted within a time window. Checks all sites by default |
| compare-sites | Side-by-side comparison of all (or selected) sites: device count, online %, WAN avg/min uptime, gateway. Use to spot fleet outliers. |
| firmware-inventory | Group all devices by firmware version + model and surface outdated devices. Helps detect fleet inconsistency and pending upgrades. |
| wan-uptime-trend | Aggregate WAN uptime across all sites with severity flagging (default threshold 95%). Returns per-WAN sorted by lowest uptime first. |
| top-clients-by-bandwidth | Top N clients by bandwidth on a site (combined / tx-only / rx-only). Requires Cloud Connector (UNIFI_API_KEY_OWNER). |
| list-hosts | List all UniFi console hosts (UDM, UDM Pro, Cloud Key, etc.) |
| get-host | Get detailed information about a specific host by ID |
| list-sites | List all sites with statistics (device counts, WAN status, ISP info) |
| list-devices | List all devices across hosts (switches, APs, gateways, cameras) |
| get-isp-metrics | Get ISP performance metrics. May be unavailable depending on account |
| query-isp-metrics | Query ISP metrics with filters. May be unavailable depending on account |
| list-sdwan-configs | List all SD-WAN configurations |
| get-sdwan-config | Get a specific SD-WAN configuration by ID |
| get-sdwan-config-status | Get the status of a specific SD-WAN configuration |
| summarize-site | Deep aggregated site view: devices + WAN status + (opt) clients + networks + WiFi broadcasts in one call. Replaces 4-5 round-trips. Connector-dependent fields auto-skip when owner key absent. Renders an Apps SDK card on ChatGPT clients (Claude clients receive the same JSON text). |
| site-health-timeline | Per-site health snapshot over a lookback window: devices with stability scores, reboots, WAN uptime, optional client count. Replaces 5+ sequential calls (devices + wan + reboots + clients). Caveats[] surfaces partial-data and API limitations. |
| search-tools | Discover available tools by natural language query. Returns matching tool names + descriptions across all categories. Use this first to navigate the 54-tool surface efficiently. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| triage-site-degradation | Investigate a site's health, recent reboots, client impact, and WAN status to produce a triage summary. |
| firmware-rollout-audit | Audit a firmware rollout: which hosts/devices are on the target version, which are lagging, and what to upgrade next. |
| wan-uptime-report | Compute a WAN uptime SLA-style report for a site over a window, with relative ranking against the fleet. |
| cross-site-anomaly-detection | Compute fleet medians across sites and flag sites that deviate >2σ from the median on key health metrics. |
| msp-onboard-site-checklist | Validate that a newly-added site has the firmware, config, and security baselines an MSP would require before going live. |
| msp-monthly-client-report | Generate the monthly customer-facing health report for one site (uptime, devices, top consumers, anomalies, recommended actions). |
| msp-fleet-firmware-plan | Plan a multi-wave firmware upgrade across all sites, ordered by risk-tolerance, with concrete maintenance windows. |
| msp-bandwidth-complaint-investigation | Triage a customer bandwidth complaint by correlating WAN uptime, top consumers, and (when connector is available) DPI category breakdowns. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| devices | All devices across all sites with status, model, firmware |
| reboots-recent | Recent reboot events (last 24h) across all reachable sites |
| hosts | All UniFi consoles (UDM, UDM Pro, Cloud Key) with status |
| summarize-site-card | Apps SDK UI template rendered with summarize-site tool output |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/us-all/unifi-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server