World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
MCP server for Ubiquiti UniFi Network and Protect. 63 tools, 16 agent skills.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 6/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 18/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Unifi MCP. Sigue https://mcp.popnx.com/i/mikeholownych-unifi-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Unifi MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (UNIFI_DEVICES) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Unifi MCP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "unifi": { "command": "uvx", "args": [ "mcp-unifi" ], "env": { "UNIFI_DEVICES": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En UNIFI_PASSWORD, UNIFI_DEVICES deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Unifi MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
UNIFI_DEVICES Arreglo JSON de configuraciones de dispositivos UniFi (name, url, api_key, services, site). Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
SettingsDeveloperEdit Config
{
"mcpServers": {
"unifi": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Unifi MCP o muestra una herramienta de Unifi MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
UNIFI_MODE Modo de autenticación: local (sesión), local_api_key (Integration API) o cloud UNIFI_USERNAME Nombre de usuario del controlador para la autenticación de sesión (UNIFI_MODE=local) UNIFI_VERIFY_SSL Verificar certificados SSL (false para autofirmados) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Unifi MCP
Unifi MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Unifi MCP
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Unifi MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (UNIFI_DEVICES) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Unifi MCP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user unifi --env UNIFI_DEVICES=your-value --env UNIFI_PASSWORD=your-value -- uvx mcp-unifi 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En UNIFI_PASSWORD, UNIFI_DEVICES deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Unifi MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
UNIFI_DEVICES Arreglo JSON de configuraciones de dispositivos UniFi (name, url, api_key, services, site). Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user unifi --env UNIFI_DEVICES=your-value --env UNIFI_PASSWORD=your-value -- uvx mcp-unifiCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Unifi MCP en la lista como conectado
Usa Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Unifi MCP o muestra una herramienta de Unifi MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
UNIFI_MODE Modo de autenticación: local (sesión), local_api_key (Integration API) o cloud UNIFI_USERNAME Nombre de usuario del controlador para la autenticación de sesión (UNIFI_MODE=local) UNIFI_VERIFY_SSL Verificar certificados SSL (false para autofirmados) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Unifi MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (UNIFI_DEVICES) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Unifi MCP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "unifi": { "command": "uvx", "args": [ "mcp-unifi" ], "env": { "UNIFI_DEVICES": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En UNIFI_PASSWORD, UNIFI_DEVICES deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Unifi MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
UNIFI_DEVICES Arreglo JSON de configuraciones de dispositivos UniFi (name, url, api_key, services, site). Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de Unifi MCP, UNIFI_PASSWORD, UNIFI_DEVICES está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Unifi MCP o muestra una herramienta de Unifi MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
UNIFI_MODE Modo de autenticación: local (sesión), local_api_key (Integration API) o cloud UNIFI_USERNAME Nombre de usuario del controlador para la autenticación de sesión (UNIFI_MODE=local) UNIFI_VERIFY_SSL Verificar certificados SSL (false para autofirmados) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Unifi MCP (créala en el sitio del autor) · 1 ajuste(s) que rellenar (UNIFI_DEVICES) · Instala Python (uv) en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Unifi MCP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "unifi": { "type": "stdio", "command": "uvx", "args": [ "mcp-unifi" ], "env": { "UNIFI_DEVICES": "your-value", "UNIFI_PASSWORD": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En UNIFI_PASSWORD, UNIFI_DEVICES deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Unifi MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
UNIFI_DEVICES Arreglo JSON de configuraciones de dispositivos UniFi (name, url, api_key, services, site). Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
En la configuración de Unifi MCP, UNIFI_PASSWORD, UNIFI_DEVICES está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Unifi MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Unifi MCP o muestra una herramienta de Unifi MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
UNIFI_MODE Modo de autenticación: local (sesión), local_api_key (Integration API) o cloud UNIFI_USERNAME Nombre de usuario del controlador para la autenticación de sesión (UNIFI_MODE=local) UNIFI_VERIFY_SSL Verificar certificados SSL (false para autofirmados) Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user unifi --env UNIFI_DEVICES=your-value --env UNIFI_PASSWORD=your-value -- uvx mcp-unifiClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"unifi": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"unifi": {
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"unifi": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-unifi"
],
"env": {
"UNIFI_DEVICES": "your-value",
"UNIFI_PASSWORD": "your-value"
}
}
}
}UNIFI_DEVICES obligatorio envUNIFI_MODE envUNIFI_USERNAME envUNIFI_PASSWORD secreto obligatorio envUNIFI_VERIFY_SSL envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub mikeholownych, dueña del repo
Último cambio de código: hace 25 días
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para mcp-unifi@0.8.2
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/mikeholownych-unifi-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: UNIFI_PASSWORD
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 25 días, y la última versión (0.8.2) llegó al registro hace 3 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| Este Unifi MCP | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
mcp-name: io.github.mikeholownych/unifi-mcp
An MCP (Model Context Protocol) server that provides AI assistants like Claude with access to UniFi Network and Protect infrastructure management and analysis capabilities. It uses the native MCP SDK 2 MCPServer API (not FastMCP 3) and communicates over stdio by default.
Credits: This project started as a fork of gbassaragh/Unifi-mcp and has since evolved into a fully independent project. Thanks to @gbassaragh for the excellent starting point.
UNIFI_MODE=local, requests now correctly use the traditional controller API (/proxy/network) with cookie + CSRF session auth. Upstream always routed through the Integration API regardless of mode.api_base_url now respects the configured auth mode instead of unconditionally returning the Integration API endpoint.device parameterpoll_events, retry_webhook_deliveries, capture_observations, and prune_runtime_data| Mode | Auth | Best for |
|---|---|---|
local_api_key | Integration API key | Recommended default; broad read access |
local | Username/password session | Full feature access: firewall rules, WLAN configs, site settings, events, alarms, DPI |
cloud | api.ui.com key | Remote/cloud-managed controllers |
When API keys are used (Integration API), a subset of controller features is only available via legacy session auth (UNIFI_MODE=local): network events, alarms, DPI statistics, speed tests, WLAN configs, firewall rules, port profiles, and routing tables. Tools for these features return a clear error explaining how to enable them rather than failing silently. Insight tools degrade gracefully and report data limitations.
Note on local accounts: SSO/Ubiquiti-account admins protected by MFA cannot complete session login. Create a local admin on your console (*Restrict to Local Access Only*) for
UNIFI_MODE=local.
Bundled skills (in skills/) teach agents proven workflows for this server — including controller-specific gotchas (Network 10 removed endpoints, zone-pair rules, WPA3 transition).
Full documentation: See SKILLS.md for usage guide, expected results, troubleshooting, and how to request new functionality.
| Skill | Type | Purpose |
|---|---|---|
unifi-network-audit | read-only | Full site audit: devices, clients, WiFi posture, firewall, structured report |
unifi-troubleshoot-client | read-only | Diagnose a misbehaving device: RF, roaming, blocking, IP layer |
unifi-wifi-optimize | write-gated | Channel plan, widths, WPA3 transition, band steering — approval-gated |
unifi-grant-device-access | write-gated | Give a device a reserved IP + scoped zone-firewall access |
unifi-internet-down | read-only triage | "Internet is dead!" — plain-English outage diagnosis, ISP escalation script |
unifi-whos-home | read-only | "Who's on my WiFi?" — friendly inventory, intruder checks with randomized-MAC awareness |
unifi-setup-new-device | write-gated | Get any new gadget online: pairing pitfalls (2.4GHz/WPA3), naming, IP reservation |
unifi-dns-triage | read-only | "Site won't load but ping works" — resolution vs connectivity split, forced-internal-DNS patterns |
unifi-mdns-discovery | read-only+ | AirPrint/Cast broken across VLANs — mDNS reflection, IGMP/IPTV cautions |
unifi-port-forwarding | write-gated | Self-hosted service exposure incl. hairpin NAT, CGNAT detection, zone-policy pairing |
unifi-vpn | write-gated | WireGuard/Teleport setup + failure ladder (handshake/MTU/zone-policies) |
unifi-firmware-campaign | write-gated | Staged firmware updates: snapshot, canary, verify, stuck-device ladder |
unifi-mesh-backhaul | read-only | Slow far-room WiFi: wireless-uplink/hop diagnosis, wired-backhaul guidance |
unifi-ids-ips-triage | read-only+ | Threat alerts: false-positive vs real, suppression, IPS throughput cost |
unifi-backup-migration | write-gated | What backups contain, migration rules of thumb, pre-migration snapshots |
unifi-network-map | doc-writer | Persistent labeled topology (zones/VLANs/deps) that sharpens every other skill |
Just describe your problem naturally — the agent matches your request to the right skill and follows its workflow:
unifi-internet-down diagnoses WAN, modem, gatewayunifi-whos-home lists devices, flags unknownsunifi-network-audit produces a full health reportunifi-setup-new-device guides WiFi pairingWrite-gated skills (marked above) modify your network — they always ask approval before applying changes.
Skills for non-technical users avoid jargon, translate every technical term, and require confirmation before disruptive actions.
Install (per project): copy into .claude/skills/:
git clone https://github.com/mikeholownych/unifi-mcp.git
mkdir -p .claude/skills && cp -r unifi-mcp/skills/* .claude/skills/
See SKILLS.md for full usage guide, expected results, troubleshooting, and how to request new functionality.
Skills reference MCP tools by their plain names (get_firewall_policies, …); your MCP client prefixes them automatically.
This server is built for operation on a trusted local network, talking to UniFi consoles by IP address. With that in mind:
UNIFI_VERIFY_SSL=false). UniFi OS ships self-signed certificates, and controllers are reached by IP on the LAN, so certificate verification is expected to fail. Enable UNIFI_VERIFY_SSL=true only when your controller presents a CA-trusted certificate.UNIFI_* credentials are supplied (e.g. when deployed and configured via environment variables). Device-bound tool calls then return a clear No device configured error until a device is set.tools/call is gated by read/write/admin OIDC scopes, and startup fails if any tool is unclassified. Over stdio (local IPC) no auth is required — stdio is assumed to be a trusted local process.UNIFI_MODE=local): network events, alarms, DPI statistics, speed tests, WLAN/firewall configs, port profiles, and routing tables. Tools for these return a clear error explaining how to enable them.# Clone the repository
git clone https://github.com/mikeholownych/unifi-mcp.git cd unifi-mcp
uv sync
pip install -e .
Create a .env file in the project root (or set environment variables). See .env.example for all options.
UNIFI_CACHE_TTL controls the shared GET cache lifetime across client instances (default: 30 seconds). Mutation verification defaults to five fresh reads with exponential delays of 0.5, 1, 2, and 2 seconds. Tune this with UNIFI_MUTATION_VERIFY_ATTEMPTS, UNIFI_MUTATION_VERIFY_INITIAL_DELAY, and UNIFI_MUTATION_VERIFY_MAX_DELAY when a controller converges more slowly or quickly.
SQLite-backed runtime persistence is disabled by default. Enable it only when persistent runtime state is needed:
UNIFI_RUNTIME_ENABLED=true
By default, the database is runtime.db under UNIFI_DATA_DIR. If UNIFI_DATA_DIR is not set, the server follows the XDG data convention: $XDG_DATA_HOME/unifi-mcp when XDG_DATA_HOME is an absolute path, otherwise ~/.local/share/unifi-mcp. The resulting default database is therefore $XDG_DATA_HOME/unifi-mcp/runtime.db or ~/.local/share/unifi-mcp/runtime.db.
Set an explicit data directory or database path when needed:
UNIFI_DATA_DIR=/var/lib/unifi-mcp
UNIFI_RUNTIME_DATABASE=/var/lib/unifi-mcp/runtime.db
UNIFI_DATA_DIR and UNIFI_RUNTIME_DATABASE must resolve to absolute paths. UNIFI_RUNTIME_DATABASE overrides the database derived from UNIFI_DATA_DIR.
Runtime persistence enables event storage and management tools, but does not start background work. Enable the scheduler separately:
UNIFI_RUNTIME_ENABLED=true
UNIFI_AUTOMATION_ENABLED=true
Event ingestion is capability-based polling, not a claim of universal UniFi push support:
UNIFI_MODE=local.username and password for e