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. |
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 |
|---|---|
| list-sites-overviewA | Get a health overview of all UniFi sites with status, issues, and device counts |
| analyze-site-healthA | Analyze health of a specific site by name (e.g., 'USM'). Returns device status, WAN info, reboot detection |
| detect-recent-rebootsA | Detect devices that rebooted within a time window. Checks all sites by default |
| compare-sitesA | Side-by-side comparison of all (or selected) sites: device count, online %, WAN avg/min uptime, gateway. Use to spot fleet outliers. |
| firmware-inventoryA | Group all devices by firmware version + model and surface outdated devices. Helps detect fleet inconsistency and pending upgrades. |
| wan-uptime-trendA | Aggregate WAN uptime across all sites with severity flagging (default threshold 95%). Returns per-WAN sorted by lowest uptime first. |
| top-clients-by-bandwidthA | Top N clients by bandwidth on a site (combined / tx-only / rx-only). Requires Cloud Connector (UNIFI_API_KEY_OWNER). |
| list-hostsA | List all UniFi console hosts (UDM, UDM Pro, Cloud Key, etc.) |
| get-hostA | Get detailed information about a specific host by ID |
| list-sitesA | List all sites with statistics (device counts, WAN status, ISP info) |
| list-devicesB | List all devices across hosts (switches, APs, gateways, cameras) |
| get-isp-metricsB | Get ISP performance metrics. May be unavailable depending on account |
| query-isp-metricsB | Query ISP metrics with filters. May be unavailable depending on account |
| list-sdwan-configsA | List all SD-WAN configurations |
| get-sdwan-configC | Get a specific SD-WAN configuration by ID |
| get-sdwan-config-statusB | Get the status of a specific SD-WAN configuration |
| summarize-siteA | 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-timelineA | 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-toolsA | 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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