io.github.us-all/unifi

@us-all/unifi-mcp

UniFi semantic-analysis MCP — fleet health, anomaly detection, cross-site analytics

269/wk 7 tools GitHub npm

No known CVEs

No license

Actively maintained

Last commit 11d ago

Works with most clients

Transport: stdio, http

7 tools · ~327 tok

Grade A · 0.2% of 200K ctx

Edit this pageView history

Other

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "unifi": {
      "env": {
        "UNIFI_API_KEY": "<your-key>",
        "UNIFI_API_KEY_OWNER": "<owner-key-or-same-key-if-role=owner>"
      },
      "args": [
        "-y",
        "@us-all/unifi-mcp"
      ],
      "command": "npx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-us-all-unifi)](https://mcppedia.org/s/io-github-us-all-unifi)

Read me

What io.github.us-all/unifi does

The MSP-style UniFi MCP — built around the official Site Manager API + Cloud Connector with cross-site analytics no other UniFi MCP exposes. > 54 tools split across 7 semantic-analysis aggregations, 9 raw Site Manager, and 35 Cloud Connector — plus 2 optional local controller tools that surface per-port error counters and SFP DDM the Cloud API doesn't expose. Severity verdicts (healthy/info/warning/critical) on top of curated thresholds. 8 MCP Prompts (4 fleet-wide ops + 4 MSP workflows). Read

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

npx -y '@us-all/unifi-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

87/100across 5 weighted dimensions

How we score →

0255075100

−13

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked @us-all/unifi-mcp against OSV.dev.

Inventory

Tools (7)

Click any tool to inspect its schema.

~327 tokens total

Inventory

Prompts (8)

triage-site-degradation

Fleet ops: triage site degradation with device statuses, WAN uptime, reboots, and bandwidth analysis

firmware-rollout-audit

Fleet ops: audit firmware versions across fleet and plan rollouts

wan-uptime-report

Fleet ops: generate WAN uptime reports with outage analysis

cross-site-anomaly-detection

Fleet ops: detect anomalies across sites by comparing clients, traffic patterns, and firmware

msp-onboard-site-checklist

MSP workflow: onboarding checklist for new sites

msp-monthly-client-report

MSP workflow: generate monthly client activity and health reports

msp-fleet-firmware-plan

MSP workflow: plan firmware updates across entire managed fleet

msp-bandwidth-complaint-investigation

MSP workflow: investigate and resolve bandwidth complaints

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.us-all/unifi safe to use?: io.github.us-all/unifi has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install io.github.us-all/unifi?: io.github.us-all/unifi supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.us-all/unifi do?: io.github.us-all/unifi provides 7 tools: site-health-timeline, summarize-site, firmware-inventory, compare-sites, wan-uptime-trend and 2 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.us-all/unifi?: io.github.us-all/unifi is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.us-all/unifi actively maintained?: io.github.us-all/unifi is actively maintained — last commit was 11 days ago.

Similar servers

Others in other

View all →

Pi Lean Ctx95

Pi Coding Agent extension (CLI-first) — routes bash/read/grep/find/ls through lean-ctx CLI for strong token savings. Optional MCP bridge can register advanced tools.

3.0k 6

io.github.asklokesh/loki-mode94

Autonomous spec-to-product coding-agent CLI with an MCP server exposing 34 tools over stdio.

993 8

Sigmap94

97% token reduction for AI coding sessions — zero deps, 21 languages, MCP server

531 6

Sunpeak93

App framework, testing framework, and inspector for MCP Apps.

193 1

MCP Security Weekly

Get CVE alerts and security updates for io.github.us-all/unifi and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "unifi": { "env": { "UNIFI_API_KEY": "<your-key>", "UNIFI_API_KEY_OWNER": "<owner-key-or-same-key-if-role=owner>" }, "args": [ "-y", "@us-all/unifi-mcp" ], "command": "npx" } } }

UniFi MCP Server

The MSP-style UniFi MCP — built around the official Site Manager API + Cloud Connector with cross-site analytics no other UniFi MCP exposes.

54 tools split across 7 semantic-analysis aggregations, 9 raw Site Manager, and 35 Cloud Connector — plus 2 optional local controller tools that surface per-port error counters and SFP DDM the Cloud API doesn't expose. Severity verdicts (healthy/info/warning/critical) on top of curated thresholds. 8 MCP Prompts (4 fleet-wide ops + 4 MSP workflows). Read-only — Ubiquiti's API keys don't ship write yet.

What it does that others don't

Site Manager analytics — site-health-timeline, summarize-site, firmware-inventory, compare-sites, wan-uptime-trend, top-clients-by-bandwidth, list-sites-overview. No other UniFi MCP exposes these.

Severity verdicts, not just numbers — every analysis tool returns healthy / info / warning / critical / unknown with a curated reason. Curated thresholds (e.g. WAN uptime <90% = critical, startupTime <1h = critical post-reboot).

Cloud Connector first-class — 35 tools through the official /v1/connector/consoles/{id}/... proxy. connectorAvailable (capability) vs connectorResolved (this-call) split.

Aggregation tools — fold 3–7 sequential calls into 1 with caveats array surfacing partial failures (e.g. Site Manager API can't window-bound WAN uptime — that's surfaced explicitly).

MCP Prompts (8) — fleet ops: triage-site-degradation, firmware-rollout-audit, wan-uptime-report, cross-site-anomaly-detection. MSP workflows: msp-onboard-site-checklist, msp-monthly-client-report, msp-fleet-firmware-plan, msp-bandwidth-complaint-investigation.

Token-efficient by design — smallest schema footprint of all @us-all/* MCPs (default ~5K tokens with owner key). Fleet of 200+ devices analyzable inside a single session.

Apps SDK card — summarize-site renders as a fleet-status card on ChatGPT clients (online %, WAN uptime, gateway, devices) via _meta["openai/outputTemplate"]. Claude clients receive the same JSON content.

stdio + Streamable HTTP — defaults to stdio. Set MCP_TRANSPORT=http for ChatGPT Apps SDK or remote clients (Bearer auth via MCP_HTTP_TOKEN).

Local controller direct access (v1.13.0) — opt-in UNIFI_LOCAL_* env enables 2 tools that bypass the Cloud Connector and hit the controller's legacy /api/s/{site}/stat/device/{mac} directly on the LAN: get-port-errors (port-level rx/tx errors, link-flap counters, SFP DDM — Rx/Tx Power dBm, temperature, voltage, TX/RX fault) and list-port-flap-summary (fleet-wide port instability ranking). Surfaces data the Integration API doesn't expose. Requires LAN reachability.

Try this — 5 prompts

Connect the server to Claude Desktop or Claude Code, then paste any of these:

MSP morning check — "Fleet health check across all my UniFi sites. Flag anything not healthy with severity, top 3 issues."

Firmware rollout audit — *"Find devices on outdated firmware across every site. Group by site, show current vs lat

Frequently Asked Questions

Is io.github.us-all/unifi safe to use?

io.github.us-all/unifi has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install io.github.us-all/unifi?

io.github.us-all/unifi supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.us-all/unifi do?

io.github.us-all/unifi provides 7 tools: site-health-timeline, summarize-site, firmware-inventory, compare-sites, wan-uptime-trend and 2 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.us-all/unifi?

io.github.us-all/unifi is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is io.github.us-all/unifi actively maintained?

io.github.us-all/unifi is actively maintained — last commit was 11 days ago.