UniFi semantic-analysis MCP — fleet health, anomaly detection, cross-site analytics
Connect Runs on your machine
claude mcp add unifi -e UNIFI_API_KEY=<UNIFI_API_KEY> -e UNIFI_API_URL=<UNIFI_API_URL> -e UNIFI_API_KEY_OWNER=<UNIFI_API_KEY_OWNER> -e UNIFI_TOOLS=<UNIFI_TOOLS> -e UNIFI_DISABLE=<UNIFI_DISABLE> -e UNIFI_LOCAL_URL=<UNIFI_LOCAL_URL> -e UNIFI_LOCAL_USER=<UNIFI_LOCAL_USER> -e UNIFI_LOCAL_PASS=<UNIFI_LOCAL_PASS> -e UNIFI_LOCAL_SITE=<UNIFI_LOCAL_SITE> -e UNIFI_LOCAL_INSECURE=<UNIFI_LOCAL_INSECURE> -- npx -y @us-all/[email protected]
{
"mcpServers": {
"unifi": {
"command": "npx",
"args": [
"-y",
"@us-all/[email protected]"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_URL": "<UNIFI_API_URL>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_TOOLS": "<UNIFI_TOOLS>",
"UNIFI_DISABLE": "<UNIFI_DISABLE>",
"UNIFI_LOCAL_URL": "<UNIFI_LOCAL_URL>",
"UNIFI_LOCAL_USER": "<UNIFI_LOCAL_USER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>",
"UNIFI_LOCAL_SITE": "<UNIFI_LOCAL_SITE>",
"UNIFI_LOCAL_INSECURE": "<UNIFI_LOCAL_INSECURE>"
}
}
}
}
{
"mcpServers": {
"unifi": {
"command": "npx",
"args": [
"-y",
"@us-all/[email protected]"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_URL": "<UNIFI_API_URL>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_TOOLS": "<UNIFI_TOOLS>",
"UNIFI_DISABLE": "<UNIFI_DISABLE>",
"UNIFI_LOCAL_URL": "<UNIFI_LOCAL_URL>",
"UNIFI_LOCAL_USER": "<UNIFI_LOCAL_USER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>",
"UNIFI_LOCAL_SITE": "<UNIFI_LOCAL_SITE>",
"UNIFI_LOCAL_INSECURE": "<UNIFI_LOCAL_INSECURE>"
}
}
}
}
{
"servers": {
"unifi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@us-all/[email protected]"
],
"env": {
"UNIFI_API_KEY": "<UNIFI_API_KEY>",
"UNIFI_API_URL": "<UNIFI_API_URL>",
"UNIFI_API_KEY_OWNER": "<UNIFI_API_KEY_OWNER>",
"UNIFI_TOOLS": "<UNIFI_TOOLS>",
"UNIFI_DISABLE": "<UNIFI_DISABLE>",
"UNIFI_LOCAL_URL": "<UNIFI_LOCAL_URL>",
"UNIFI_LOCAL_USER": "<UNIFI_LOCAL_USER>",
"UNIFI_LOCAL_PASS": "<UNIFI_LOCAL_PASS>",
"UNIFI_LOCAL_SITE": "<UNIFI_LOCAL_SITE>",
"UNIFI_LOCAL_INSECURE": "<UNIFI_LOCAL_INSECURE>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
UNIFI_API_KEYRequired, secret | UniFi Site Manager API key (https://unifi.ui.com). |
UNIFI_API_URLOptional | UniFi Site Manager API base URL (default: https://api.ui.com). |
UNIFI_API_KEY_OWNEROptional, secret | Owner-role API key — enables 33 Cloud Connector tools for per-device/per-client deep data. |
UNIFI_TOOLSOptional | Comma-separated category allowlist. Default: all categories enabled. |
UNIFI_DISABLEOptional | Comma-separated category disablelist. |
UNIFI_LOCAL_URLOptional | Local controller URL (e.g. https://10.10.1.1). Enables 2 local-only tools (get-port-errors, list-port-flap-summary) that surface per-port errors + SFP DDM the Cloud API does not expose. Requires LAN reachability. |
UNIFI_LOCAL_USEROptional | Controller local account username (required when UNIFI_LOCAL_URL set). Viewer/Limited-Admin role is sufficient. |
UNIFI_LOCAL_PASSOptional, secret | Controller local account password (required when UNIFI_LOCAL_URL set). |
UNIFI_LOCAL_SITEOptional | Site slug for legacy /api/s/{site}/* (default: default). |
UNIFI_LOCAL_INSECUREOptional | Set to 'true' to accept self-signed cert from the local controller (typical for UDM Pro). |
Details
| Package | @us-all/[email protected] (NPM, stdio) |
| First published | 19 Jun 2026 |
| Last updated | 19 Jun 2026 |
| Registry name | io.github.us-all/unifi |
More data and analytics servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
