UniFi

Name: UniFi
Author: mattoddie

de mattoddieversión 0.6.1i★ 0iSe ejecuta en tu computadora

Nombre en el registroio.github.mattoddie/unifi-mcp

Instalar

Resumen

Descripción del creador (original en inglés)

Manage a Ubiquiti UniFi network: devices, clients, WiFi, firewall and VPN. Read-only by default.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi2 de 2 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiMuy nuevo★ 0

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Ciberseguridad
Debes completar: UNIFI_URL, UNIFI_API_KEY, UNIFI_PASSWORD

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 2 de 2 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: MCP_TRANSPORT, UNIFI_URL, UNIFI_API_KEY, UNIFI_USERNAME, UNIFI_PASSWORD, UNIFI_TLS_FINGERPRINT, UNIFI_VERIFY_SSL, UNIFI_SITE, UNIFI_ALLOW_WRITES, UNIFI_ALLOW_DELETES, UNIFI_TOOLSETS, UNIFI_AUDIT_LOG

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

DockerDocker instalado

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Descargar el archivo .mcpb del creador

El enlace lleva al archivo del propio creador; no lo alojamos ni lo reempaquetamos. Abre el archivo y Claude Desktop lo instalará.

Ejecuta esto en tu terminal

claude mcp add unifi --env MCP_TRANSPORT=your-value --env UNIFI_URL=your-value --env UNIFI_API_KEY=your-value --env UNIFI_USERNAME=your-value --env UNIFI_PASSWORD=your-value --env UNIFI_TLS_FINGERPRINT=your-value --env UNIFI_VERIFY_SSL=your-value --env UNIFI_SITE=your-value --env UNIFI_ALLOW_WRITES=your-value --env UNIFI_ALLOW_DELETES=your-value --env UNIFI_TOOLSETS=your-value --env UNIFI_AUDIT_LOG=your-value -- docker run -i --rm -e MCP_TRANSPORT -e UNIFI_URL -e UNIFI_API_KEY -e UNIFI_USERNAME -e UNIFI_PASSWORD -e UNIFI_TLS_FINGERPRINT -e UNIFI_VERIFY_SSL -e UNIFI_SITE -e UNIFI_ALLOW_WRITES -e UNIFI_ALLOW_DELETES -e UNIFI_TOOLSETS -e UNIFI_AUDIT_LOG ghcr.io/mattoddie/unifi-mcp:0.6.1

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "unifi": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "UNIFI_URL",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_USERNAME",
        "-e",
        "UNIFI_PASSWORD",
        "-e",
        "UNIFI_TLS_FINGERPRINT",
        "-e",
        "UNIFI_VERIFY_SSL",
        "-e",
        "UNIFI_SITE",
        "-e",
        "UNIFI_ALLOW_WRITES",
        "-e",
        "UNIFI_ALLOW_DELETES",
        "-e",
        "UNIFI_TOOLSETS",
        "-e",
        "UNIFI_AUDIT_LOG",
        "ghcr.io/mattoddie/unifi-mcp:0.6.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "UNIFI_URL": "your-value",
        "UNIFI_API_KEY": "your-value",
        "UNIFI_USERNAME": "your-value",
        "UNIFI_PASSWORD": "your-value",
        "UNIFI_TLS_FINGERPRINT": "your-value",
        "UNIFI_VERIFY_SSL": "your-value",
        "UNIFI_SITE": "your-value",
        "UNIFI_ALLOW_WRITES": "your-value",
        "UNIFI_ALLOW_DELETES": "your-value",
        "UNIFI_TOOLSETS": "your-value",
        "UNIFI_AUDIT_LOG": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "unifi": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_TRANSPORT",
        "-e",
        "UNIFI_URL",
        "-e",
        "UNIFI_API_KEY",
        "-e",
        "UNIFI_USERNAME",
        "-e",
        "UNIFI_PASSWORD",
        "-e",
        "UNIFI_TLS_FINGERPRINT",
        "-e",
        "UNIFI_VERIFY_SSL",
        "-e",
        "UNIFI_SITE",
        "-e",
        "UNIFI_ALLOW_WRITES",
        "-e",
        "UNIFI_ALLOW_DELETES",
        "-e",
        "UNIFI_TOOLSETS",
        "-e",
        "UNIFI_AUDIT_LOG",
        "ghcr.io/mattoddie/unifi-mcp:0.6.1"
      ],
      "env": {
        "MCP_TRANSPORT": "your-value",
        "UNIFI_URL": "your-value",
        "UNIFI_API_KEY": "your-value",
        "UNIFI_USERNAME": "your-value",
        "UNIFI_PASSWORD": "your-value",
        "UNIFI_TLS_FINGERPRINT": "your-value",
        "UNIFI_VERIFY_SSL": "your-value",
        "UNIFI_SITE": "your-value",
        "UNIFI_ALLOW_WRITES": "your-value",
        "UNIFI_ALLOW_DELETES": "your-value",
        "UNIFI_TOOLSETS": "your-value",
        "UNIFI_AUDIT_LOG": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

MCP_TRANSPORT env
The image serves HTTP by default; this runs it over stdio.
UNIFI_URL obligatorio env
Address of your UniFi console. For a legacy self-hosted Network application, include the port.
UNIFI_API_KEY secreto env
API key from UniFi Network → Settings → Control Plane → Integrations. Or use a username and password.
UNIFI_USERNAME env
A local (not Ubiquiti cloud) account, used instead of an API key. Required for legacy controllers.
UNIFI_PASSWORD secreto env
The local account's password, used with the username.
UNIFI_TLS_FINGERPRINT env
Recommended for an https controller with a self-signed certificate: its SHA-256 fingerprint, to pin it.
UNIFI_VERIFY_SSL env
Leave empty when you set a fingerprint. true: publicly trusted certificate. false: skip the check (insecure).
UNIFI_SITE env
The site's short name, used when a request doesn't name a site.
UNIFI_ALLOW_WRITES env
Allow changes: restart devices, block clients, edit WiFi, firewall and networks. Off means read-only.
UNIFI_ALLOW_DELETES env
Also allow deleting configuration and forgetting clients. Needs UNIFI_ALLOW_WRITES.
UNIFI_TOOLSETS env
Optional comma-separated list to expose fewer tools, e.g. overview,devices,clients. Empty means all.
UNIFI_AUDIT_LOG env
Set to stderr to log every change the assistant makes or previews as JSON lines. Off when empty.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué apps pueden usarlo

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

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 11 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub mattoddie, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: ayer
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Reseñas de usuarios

Aún no hay reseñas

Comparado con otros en Ciberseguridadi

Más estrellas que el 0% de los otros 1025 servidores de esta categoría
Publicado en el registro más recientemente que el 67% de los otros 1025 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1025 servidores de esta categoría

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.

Preguntas frecuentes

¿Es seguro UniFi?

Superó 2 de 2 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.

¿Qué claves o códigos necesita?

Debes completar: UNIFI_URL, UNIFI_API_KEY, UNIFI_PASSWORD

¿Se ejecuta en mi computadora o en la nube?

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).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez ayer, y la última versión (0.6.1) llegó al registro hace 19 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker, MCPB en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Robin: AI-Powered Dark Web OSINT, HOL Guard, UniFi Network MCP

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados 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

Robin: AI-Powered Dark Web OSINT

Dark web OSINT over Tor: search onion engines, scrape pages, report with your own model.

de apurvsinghgautamEn crecimiento★ 7,9 milActualizado hace 39 días

Se ejecuta en tu computadora

Instalar

HOL Guard

Local-first AI agent security evidence and approval workflows through HOL Guard's stdio MCP server.

de hashgraph-onlineMuy usado↓ 7,1 mil/sem★ 1,1 milActualizado hace 6 días

Se ejecuta en tu computadora

Instalar

UniFi Network MCP

Manage UniFi Network devices, clients, firewall, VLANs, VPNs, and more via MCP.

de sirkirbyMuy usado↓ 11,3 mil/sem★ 1 milActualizado hace 8 meses

Se ejecuta en tu computadora

Instalar

README del creador

Abrir el README

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.

unifi-mcp

Talk to your UniFi network.

An open-source Model Context Protocol server for Ubiquiti UniFi Network. It lets Claude and other AI assistants monitor and manage your sites, devices, clients, WiFi, firewall and more, all from one Docker container.

[unifi-mcp.mattoddie.dev](https://unifi-mcp.mattoddie.dev)

Quick start · Documentation · Tool reference · Contributing

"Why is the lounge TV buffering?"

*The TV is on the Lounge AP at -78 dBm and 12 Mbps, and that AP's 5 GHz radio is at 81% channel utilisation on channel 36. Moving the AP to channel 149 or adding a wired backhaul should fix it. Want me to change the channel?*

Ask about your network in plain English. The assistant picks from 145 tools to look things up and, if you allow it, make changes. Some examples:

🩺 *"Give me a health check of the network."*
🔎 *"Which clients have a weak WiFi signal right now?"*
🔐 *"Review my firewall and port forwards for anything risky."*
🔄 *"Which devices have firmware updates, and when were they last rebooted?"*
🎟️ *"Create 10 one-day guest vouchers limited to 5 Mbps."*
🧱 *"Block the device called 'kids-tablet' until I unblock it."*

Highlights

🐳 Docker-first. There's one small distroless image (ghcr.io/mattoddie/unifi-mcp, about 22 MB) for linux/amd64 and linux/arm64. It serves Streamable HTTP for a long-running service, or stdio for docker run -i. For Claude Desktop there's also a one-click extension bundle (.mcpb) that needs no Docker.
🛡️ Safe by default. The server is read-only unless you turn on writes, and deleting configuration needs a second switch. Destructive tools are labelled so your MCP client asks before running them, and passwords and keys are redacted from output.
🔍 Preview and audit. Every write tool takes dry_run: true to show the request it would send, with a field-level diff of what would change, without changing anything. UNIFI_AUDIT_LOG records each change in a JSON Lines audit log.
🧰 Broad coverage. It covers 14 toolsets: devices, clients, switch ports and PoE, WiFi, networks and VLANs, WAN, DNS, legacy and zone-based firewall, traffic rules and routes, IDS/IPS, VPN, RADIUS, hotspot vouchers, statistics, logs, admins and backups.
🎛️ Tunable. Expose only the toolsets you need, which keeps the model's context small and focused. See Keeping the tool list small.
🔌 Works with your controller. Supports UniFi OS consoles (UDM, UDM Pro/SE, UCG, UDR, UX, Cloud Key Gen2+, UniFi OS Server) and legacy self-hosted Network applications. Auth is an API key or a local account.
🧪 Tested. The test suite runs against a mock controller on every build.

Quick start

You need Docker, a UniFi controller and an MCP client such as Claude Code.

1. Get credentials. On a UniFi OS console, create an API key: UniFi Network → Settings → Control Plane → Integrations → Create API Key. On older controllers, use a local account instead.

2. Start the server.

mkdir unifi-mcp && cd unifi-mcp

curl -fsSLO https://raw.githubusercontent.com/mattoddie/unifi-mcp/main/compose.yaml curl -fsSL https://raw.githubusercontent.com/mattoddie/unifi-mcp/main/example.env -o .env

Edit .env: set UNIFI_URL, UNIFI_API_KEY and a random MCP_AUTH_TOKEN (required; e.g. `openssl rand -hex 32`).

For an https controller, also say how to check its certificate, or the server won't start.

Recommended: pin it with UNIFI_TLS_FINGERPRINT (see docs/security.md). example.env sets

UNIFI_VERIFY_SSL=false, which skips the check: remove it once the fingerprint is set.

docker compose up -d

3. Connect your assistant.

claude mcp add --transport http unifi http://<docker-host>:8080/mcp \

--header "Authorization: Bearer "

Now ask *"How's my network doing?"* in Claude Code.

Using Claude Desktop, VS Code, Cursor or Codex? See Connecting MCP clients. Prefer not to run a service? Use stdio mode with docker run -i.

Claude Desktop in one click

On a Mac or Windows PC with Claude Desktop, you don't need Docker at all. Download the .mcpb bundle for your computer from the latest release, open it, and enter your controller URL, API key and certificate fingerprint in the settings. See Claude Desktop.

unifi-mcp is also listed in the MCP Registry as io.github.mattoddie/unifi-mcp, with the image (over stdio) and the bundles, so clients and directories that read the registry can install it.

Turning on changes

Out of the box the assistant can look but not touch. To let it make changes, add these to .env and run docker compose up -d:

UNIFI_ALLOW_WRITES=true      # restart devices, block clients, edit WiFi/firewall/networks…

UNIFI_ALLOW_DELETES=true # also allow deleting configuration, forgetting clients… (needs writes too) UNIFI_TOOLSETS=overview,devices,clients,wifi,monitoring # optional: expose fewer tools UNIFI_AUDIT_LOG=stderr # optional: log every change (or a file path; see docs/configuration.md)

Ask for a dry run to preview a change first: *"Dry run: disable the guest WiFi. What would change?"* Read Security before turning on writes for a production network.

What it can do

Toolset	What's covered
`overview`	Sites, controller info, site health
`devices`	Device status and details, restart/locate/provision, firmware upgrades (also rolling), radios, PoE outlets, adoption, RF scans, AP groups
`clients`	Online and known clients, block/unblock, reconnect, names, fixed IPs, lock to an AP, forget
`switching`	Switch ports, port profiles, PoE power-cycling, port mirroring, link aggregation, LLDP neighbours
`wifi`	WLANs (SSIDs, security, VLANs, bands), WiFi QR codes
`networks`	Networks/VLANs and DHCP, WAN, local DNS records, bandwidth profiles, dynamic DNS
`firewall`	Port forwards, firewall rules and groups, zone-based policies and zones, traffic rules, QoS rules, NAT rules, switch ACL rules, object-oriented network policies
`routing`	Static routes, policy-based traffic routes
`security`	IDS/IPS threat management, threat log, country blocking, content filtering
`vpn`	VPN servers and site-to-site VPNs, RADIUS profiles and accounts
`hotspot`	Vouchers, hotspot operators, guest authorization, guest portal
`monitoring`	Events, alarms, traffic reports, traffic flows, DPI, speed tests, rogue APs, system log, sessions, anomalies, dashboards
`admin`	Site settings (including SNMP, mDNS and auto-backup), admins, backups, controller updates, sites
`raw`	An escape hatch that calls any controller API path

See the [tool reference](docs/tools.md) for every tool and argument. Ready-made prompts like network_health_check, troubleshoot_client and security_review chain the tools together for common jobs.

Documentation

The docs are also published at [unifi-mcp.mattoddie.dev/docs](https://unifi-mcp.mattoddie.dev/docs/), with search.


🚀 Getting started	Step-by-step setup, from credentials to first question
🔌 Connecting MCP clients	Claude Code, Claude Desktop, VS Code, Cursor, Codex, stdio mode
⚙️ Configuration	Every environment variable, Docker secrets, toolsets
🐳 Deployment	Compose, image tags, upgrades, TLS reverse proxy, hardening
💬 Using unifi-mcp	Example conversations, prompts, how saves and secrets work
🧰 Tool reference	All 145 tools and 5 prompts, generated from the code
🛡️ Security	Threat model, least privilege, safe write setups
📡 Compatibility	Supported controllers and versions, API caveats
🩹 Troubleshooting	Common errors and how to fix them
🛠️ Development	Architecture, adding a tool, testing

Contributing

Contributions are very welcome, whether that's bug reports, compatibility reports from your hardware, docs or new tools. Read the contributing guide to get started, and please follow the code of conduct. To report a vulnerability, see the security policy. Please don't open a public issue for one.

License

*unifi-mcp is an independent community project. It is not affiliated with, endorsed by or sponsored by Ubiquiti Inc. UniFi and Ubiquiti are trademarks of Ubiquiti Inc.*

UniFi

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Reseñas de usuarios

Comparado con otros en Ciberseguridadi

Preguntas frecuentes

Alternativas

Robin: AI-Powered Dark Web OSINT

HOL Guard

UniFi Network MCP

README del creador

unifi-mcp

Highlights

Quick start

Edit .env: set UNIFI_URL, UNIFI_API_KEY and a random MCP_AUTH_TOKEN (required; e.g. openssl rand -hex 32).

For an https controller, also say how to check its certificate, or the server won't start.

Recommended: pin it with UNIFI_TLS_FINGERPRINT (see docs/security.md). example.env sets

UNIFI_VERIFY_SSL=false, which skips the check: remove it once the fingerprint is set.

Claude Desktop in one click

Turning on changes

What it can do

Documentation

Contributing

License

Edit .env: set UNIFI_URL, UNIFI_API_KEY and a random MCP_AUTH_TOKEN (required; e.g. `openssl rand -hex 32`).