UniFi MCP Server
UniFi MCP Server
mcp-name: io.github.mikeholownych/unifi-mcp
Un servidor MCP (Model Context Protocol) que proporciona a asistentes de IA como Claude acceso a las capacidades de gestión y análisis de la infraestructura de UniFi Network y Protect.
Créditos: Este proyecto comenzó como un fork de gbassaragh/Unifi-mcp y desde entonces ha evolucionado hasta convertirse en un proyecto totalmente independiente. Gracias a @gbassaragh por el excelente punto de partida.
Mejoras respecto al upstream
Corregido el enrutamiento de autenticación de sesión local — en
UNIFI_MODE=local, las peticiones ahora usan correctamente la API del controlador tradicional (/proxy/network) con autenticación de sesión por cookie + CSRF. El upstream siempre enrutaba a través de la Integration API independientemente del modo.Resolución de URL base según el modo —
api_base_urlahora respeta el modo de autenticación configurado en lugar de devolver incondicionalmente el endpoint de la Integration API.Suite de pruebas ampliada — 57 pruebas superadas que cubren configuración, comportamiento del cliente de red, registro de herramientas del servidor e integraciones con Protect.
Related MCP server: UniFi MCP Server
Características
UniFi Network
Gestión de dispositivos: Listar, reiniciar, localizar y actualizar dispositivos UniFi (APs, switches, routers)
Gestión de clientes: Supervisar clientes conectados, bloquear/desbloquear, ver estadísticas de tráfico
Gestión de sitios: Ver la salud del sitio, configuraciones de red, VLANs y ajustes inalámbricos
Estadísticas y supervisión: Eventos, alarmas, pruebas de velocidad y estadísticas DPI
Información basada en IA: Análisis de red, recomendaciones de optimización y resolución de problemas
UniFi Protect
Gestión de cámaras: Listar cámaras, ver el estado, obtener instantáneas en vivo
Supervisión del sistema: Estado del NVR, resúmenes de salud de las cámaras
Accesorios: Gestionar luces, sensores, timbres y visores
Liveviews: Acceder a las distribuciones de vistas de cámara configuradas
Compatibilidad con múltiples dispositivos
Configurar varios dispositivos UniFi (gateways, NVRs, etc.)
Dirigirse a dispositivos específicos por nombre: todas las herramientas de red y Protect aceptan un parámetro opcional
deviceClaves de API por dispositivo: cada dispositivo configurado se autentica con su propia clave
Combinación de servicios de Network y Protect entre dispositivos
Modos de autenticación
Mode | Auth | Best for |
| Integration API key | Recommended default; broad read access |
| Username/password session | Full feature access: firewall rules, WLAN configs, site settings, events, alarms, DPI |
| api.ui.com key | Remote/cloud-managed controllers |
Cuando se utilizan claves de API (Integration API), un subconjunto de las funciones del controlador solo está disponible mediante la autenticación de sesión heredada (UNIFI_MODE=local): eventos de red, alarmas, estadísticas DPI, pruebas de velocidad, configuraciones WLAN, reglas de firewall, perfiles de puerto y tablas de enrutamiento. Las herramientas para estas funciones devuelven un error claro que explica cómo habilitarlas en lugar de fallar silenciosamente. Las herramientas de información se degradan con elegancia y notifican las limitaciones de los datos.
Nota sobre cuentas locales: Los administradores con SSO/cuenta de Ubiquiti protegidos por MFA no pueden completar el inicio de sesión. Crea un administrador local en tu consola (Restrict to Local Access Only) para
UNIFI_MODE=local.
Habilidades del agente
Las habilidades incluidas (en skills/) enseñan a los agentes flujos de trabajo probados para este servidor, incluidas las particularidades específicas del controlador (endpoints eliminados en Network 10, reglas de pares de zonas, transición WPA3).
Documentación completa: Consulta SKILLS.md para la guía de uso, los resultados esperados, la resolución de problemas y cómo solicitar nuevas funcionalidades.
Referencia rápida
Skill | Type | Purpose |
| solo lectura | Auditoría completa del sitio: dispositivos, clientes, postura WiFi, firewall, informe estructurado |
| solo lectura | Diagnosticar un dispositivo con problemas: RF, roaming, bloqueo, capa IP |
| con bloqueo de escritura | Plan de canales, anchos, transición WPA3, band steering: sujeto a aprobación |
| con bloqueo de escritura | Dar a un dispositivo una IP reservada + acceso de firewall por zonas con ámbito definido |
| triaje de solo lectura | «¡Mi internet está caído!» — diagnóstico de la caída en lenguaje claro, script de escalado al ISP |
| solo lectura | «¿Quién está en mi WiFi?» — inventario amigable, comprobación de intrusos con detección de MAC aleatorizadas |
| con bloqueo de escritura | Poner en línea cualquier dispositivo nuevo: errores comunes de emparejado (2.4GHz/WPA3), nombre, reserva de IP |
| solo lectura | «El sitio no carga pero el ping funciona» — separación entre resolución y conectividad, patrones de DNS interno forzado |
| solo lectura+ | AirPrint/Cast roto entre VLANs — reflexión mDNS, precauciones con IGMP/IPTV |
| con bloqueo de escritura | Exposición de servicios autoalojados, incl. NAT hairpin, detección de CGNAT, emparejado con políticas de zona |
| con bloqueo de escritura | Configuración de WireGuard/Teleport + escalera de fallos (handshake/MTU/políticas de zona) |
| con bloqueo de escritura | Actualizaciones de firmware por fases: snapshot, canary, verificación, escalera para dispositivos atascados |
| solo lectura | WiFi lento en habitaciones lejanas: diagnóstico de uplink/saltos inalámbricos, guía de backhaul por cable |
| solo lectura+ | Alertas de amenazas: falso positivo vs real, supresión, coste de rendimiento de IPS |
| con bloqueo de escritura | Qué contienen las copias de seguridad, reglas prácticas de migración, instantáneas previas a la migración |
| escritor de documentación | Topología etiquetada persistente (zonas/VLANs/deps) que mejora todas las demás habilidades |
Cómo funcionan las habilidades
Simplemente describe tu problema con naturalidad: el agente asocia tu solicitud con la habilidad adecuada y sigue su flujo de trabajo:
«Mi internet está caído» →
unifi-internet-downdiagnostica WAN, módem, gateway«¿Quién está en mi WiFi?» →
unifi-whos-homelista los dispositivos y marca los desconocidos«Audita mi red» →
unifi-network-auditgenera un informe de salud completo«Configura mi nueva TV» →
unifi-setup-new-deviceguía el emparejado WiFi
Las habilidades con bloqueo de escritura (marcadas arriba) modifican tu red: siempre piden aprobación antes de aplicar cambios.
Las habilidades para usuarios no técnicos evitan la jerga, traducen cada término técnico y requieren confirmación antes de realizar acciones disruptivas.
Instalación (por proyecto): copia en .claude/skills/:
git clone https://github.com/mikeholownych/unifi-mcp.git
mkdir -p .claude/skills && cp -r unifi-mcp/skills/* .claude/skills/Consulta SKILLS.md para la guía de uso completa, los resultados esperados, la resolución de problemas y cómo solicitar nuevas funcionalidades.
Las habilidades referencian las herramientas MCP por sus nombres simples (get_firewall_policies, …); tu cliente MCP les añade el prefijo automáticamente.
Hardware compatible
UniFi Dream Machine (UDM, UDM-Pro, UDM-SE)
UniFi Cloud Gateway (UCG-Ultra, UCG-Fiber)
UniFi Network Video Recorder (UNVR, UNVR-Pro)
UniFi Network Application (autoalojada)
Cloud Key tradicional (Gen1, Gen2, Gen2+)
Instalación
Usando uv (Recomendado)
# Clone the repository
git clone https://github.com/mikeholownych/unifi-mcp.git
cd unifi-mcp
# Install dependencies
uv syncUsando pip
pip install -e .Configuración
Crea un archivo .env en la raíz del proyecto (o define las variables de entorno). Consulta .env.example para ver todas las opciones.
Configuración de múltiples dispositivos (Recomendada)
Configura varios dispositivos UniFi con diferentes servicios:
UNIFI_DEVICES='[
{
"name": "main-gateway",
"url": "https://192.168.1.1",
"api_key": "your-gateway-api-key",
"services": ["network"],
"site": "default"
},
{
"name": "nvr",
"url": "https://192.168.1.2",
"api_key": "your-nvr-api-key",
"services": ["network", "protect"],
"site": "default"
}
]'
UNIFI_VERIFY_SSL=falseCampos de configuración del dispositivo:
Field | Description | Default |
| Nombre descriptivo para dirigirse al dispositivo | (obligatorio) |
| URL base del dispositivo UniFi | (obligatorio) |
| Clave de API de UniFi OS Control Plane | (obligatorio) |
| Matriz: |
|
| Nombre del sitio para operaciones de red |
|
| Verificar certificados SSL |
|
| Usuario para eventos de Protect (opcional) |
|
| Contraseña para eventos de Protect (opcional) |
|
Nota: Los campos username y password solo son necesarios para las herramientas de eventos de Protect (eventos de movimiento, detecciones inteligentes). Las operaciones básicas de cámara funcionan solo con la clave de API.
Para crear una clave de API:
Inicia sesión en tu controlador UniFi
Ve a Ajustes → Control Plane → API
Crea una nueva clave de API con los permisos adecuados
Configuración heredada de un solo dispositivo
Por compatibilidad con versiones anteriores, la configuración de un solo dispositivo sigue siendo compatible:
UNIFI_MODE=local_api_key
UNIFI_CONTROLLER_URL=https://192.168.1.1
UNIFI_CLOUD_API_KEY=your-api-key
UNIFI_SITE=default
UNIFI_VERIFY_SSL=falseAutenticación de sesión local (tradicional)
Para acceso completo a funciones con autenticación de usuario/contraseña:
UNIFI_MODE=local
UNIFI_CONTROLLER_URL=https://192.168.1.1
UNIFI_USERNAME=local-admin
UNIFI_PASSWORD=your-password
UNIFI_SITE=default
UNIFI_IS_UDM=true
UNIFI_VERIFY_SSL=falseAPI en la nube (api.ui.com)
Para acceso a la API en la nube de Ubiquiti:
UNIFI_MODE=cloud
UNIFI_CLOUD_API_KEY=your-api-keyObtén tu clave de API desde unifi.ui.com → sección API.
Uso con Claude Desktop
Añade a tu configuración de Claude Desktop (~/.config/claude/claude_desktop_config.json en Linux o ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):
{
"mcpServers": {
"unifi": {
"command": "uv",
"args": ["run", "--directory", "/path/to/unifi-mcp", "python", "-m", "unifi_mcp.server"],
"env": {
"UNIFI_DEVICES": "[{\"name\":\"gateway\",\"url\":\"https://192.168.1.1\",\"api_key\":\"your-key\",\"services\":[\"network\"]},{\"name\":\"nvr\",\"url\":\"https://192.168.1.2\",\"api_key\":\"your-key\",\"services\":[\"network\",\"protect\"]}]",
"UNIFI_VERIFY_SSL": "false"
}
}
}
}Uso con Claude Code / opencode
# Add the MCP server
claude mcp add unifi -- uv run --directory /path/to/unifi-mcp python -m unifi_mcp.serverO en opencode.json:
{
"mcp": {
"unifi": {
"type": "local",
"command": ["/path/to/unifi-mcp/.venv/bin/python", "-m", "unifi_mcp.server"],
"enabled": true
}
}
}Herramientas disponibles
Gestión de múltiples dispositivos
list_unifi_devices- Lista todos los dispositivos UniFi configurados y sus servicios
Gestión de dispositivos
list_devices- Lista todos los dispositivos de red UniFiget_device_details- Obtiene información detallada del dispositivorestart_device- Reinicia un dispositivolocate_device- Parpadear el LED para localizar el dispositivoget_device_stats- Obtiene estadísticas de rendimientoupgrade_device- Actualiza el firmwareprovision_device- Fuerza el reaprovisionamiento
Gestión de clientes
list_clients- Lista los clientes conectadoslist_all_clients- Lista todos los clientes conocidos (incluidos los desconectados)get_client_details- Obtiene los detalles del clienteblock_client/unblock_client- Bloquear/desbloquear clienteskick_client- Desconecta un clienteforget_client- Elimina de los clientes conocidosget_client_traffic- Obtiene las estadísticas de tráficoreserve_client_ip- Reservar IP mediante reserva DHCP
Gestión de sitios
list_sites- Lista todos los sitiosget_site_health- Obtiene el estado de salud del sitioget_site_settings- Obtiene los ajustes del sitioget_sysinfo- Obtiene la información del sistemaget_networks- Obtiene las configuraciones de red/VLANget_wlans- Obtiene las configuraciones de red inalámbricaget_port_profiles- Obtiene los perfiles de puerto del switchget_firewall_rules- Obtiene las reglas de firewall heredadasget_firewall_policies- Obtiene las políticas de firewall basadas en zonas (UniFi Network 9+)get_routing_table- Obtiene la tabla de enrutamientoget_port_forwards- Obtiene las reglas de reenvío de puertoscreate_port_forward/delete_port_forward- Gestiona los reenvíos de puertos
Gestión de configuración (escrituras)
create_wlan/update_wlan/delete_wlan- Gestionar redes inalámbricascreate_firewall_policy/set_firewall_policy_enabled/delete_firewall_policy- Gestionar políticas de firewall basadas en zonasexport_camera_clip- Exportar un clip de grabación de cámara como MP4 (Protect)get_all_sites_health- Resumen de salud en todos los sitios
Las herramientas que eliminan datos o causan interrupciones están sujetas a confirmación o se marcan como destructivas mediante anotaciones de MCP.
Estadísticas y monitorización
get_network_health- Salud general de la redget_recent_events- Eventos recientesget_alarms- Alarmas activasarchive_all_alarms- Archivar todas las alarmasrun_speed_test- Iniciar prueba de velocidadget_speed_test_status- Obtener resultados de la prueba de velocidadget_dpi_stats- Estadísticas de DPIget_traffic_summary- Resumen de tráfico
Herramientas de información de IA
analyze_network_issues- Análisis exhaustivo de problemasget_optimization_recommendations- Recomendaciones de configuraciónget_client_experience_report- Métricas de calidad del clienteget_device_health_summary- Resumen de salud de dispositivosget_traffic_analysis- Análisis de patrones de tráficoget_all_sites_health- Resumen de salud en todos los sitios
Orquestación multi-sitio
get_global_inventory- Inventario unificado de dispositivos en todos los controladoresget_global_health- Informe de salud agregado de todos los controladoresget_global_client_summary- Conteos de clientes, principales consumidores de tráfico y clientes bloqueados en todos los controladorestroubleshoot_client- Diagnóstico detallado de clientes
UniFi Protect
list_cameras- Listar todas las cámaras con su estado de conexiónget_camera_details- Obtener información detallada de la cámaraget_camera_snapshot- Obtener instantánea en vivo (JPEG en base64)get_protect_system_info- Obtener información del sistema NVRget_camera_health_summary- Resumen de salud de cámaras con incidenciasget_liveviews- Obtener los diseños de vista en vivo configuradosget_protect_accessories- Listar luces, sensores, timbres y visores
Eventos de UniFi Protect (requieren nombre de usuario/contraseña)
get_motion_events- Obtener eventos de movimiento recientesget_smart_detections- Obtener eventos de detección inteligente (persona, vehículo, animal, paquete)get_protect_event_summary- Resumen de todos los eventos por tipoget_recent_protect_activity- Descripción general rápida de la actividad reciente
Conversaciones de ejemplo
Después de conectar el servidor MCP, puedes preguntar a Claude:
Gestión de red
"Lista todos mis dispositivos UniFi"
"¿Cuál es la salud actual de la red?"
"Analiza mi red para detectar problemas"
"¿Qué recomendaciones de optimización tienes?"
"Muéstrame las métricas de experiencia del cliente"
"Diagnostica al cliente con MAC aa:bb:cc:dd:ee:ff"
"¿Qué clientes están usando más ancho de banda?"
"¿Hay algún dispositivo que necesite actualizaciones de firmware?"
"Muéstrame los eventos de red recientes"
"Ejecuta una prueba de velocidad"
UniFi Protect
"Lista todas mis cámaras"
"Muéstrame el resumen de salud de las cámaras"
"Obtén una instantánea de la cámara de la puerta principal"
"¿Cuál es el estado de mi NVR?"
"¿Hay alguna cámara desconectada?"
"Muéstrame los accesorios de Protect"
Eventos de Protect (requiere credenciales)
"Muéstrame los eventos de movimiento recientes"
"¿Qué detecciones inteligentes ocurrieron en las últimas 24 horas?"
"¿Hubo detecciones de personas hoy?"
"Dame un resumen de eventos de la última semana"
"Muestra la actividad reciente de la cámara de la puerta principal"
Multi-dispositivo
"Lista mis dispositivos UniFi configurados"
"Muestra las cámaras de mi NVR"
"Obtén la salud de la red desde la puerta de enlace principal"
Desarrollo
Ejecutar pruebas
uv run pytestFormato de código
uv run ruff check .
uv run ruff format .Docker
docker build -t unifi-mcp .
docker run -i --rm --env-file .env unifi-mcpSolicitar nuevas funcionalidades
Nuevas habilidades: Abre un issue con el prefijo
[Skill]— describe el problema, el flujo de trabajo y el resultado esperadoModificar habilidades: Abre un issue con el prefijo
[Skill: skill-name]— qué falta o qué no funcionaNuevas herramientas: Abre un issue con el prefijo
[Tool]— incluye el endpoint de la API de UniFi y el formato esperado
Consulta SKILLS.md para obtener directrices detalladas de contribución.
Consulta CHANGELOG.md para ver el historial de versiones y CONTRIBUTING.md para contribuir.
Notas de seguridad
Las credenciales se pasan mediante variables de entorno — nunca hagas commit de
.envLa verificación SSL está deshabilitada de forma predeterminada para certificados autofirmados
El servidor solo expone operaciones de lectura y comandos de gestión seguros
Las operaciones destructivas (eliminar sitio, restablecimiento de fábrica) no están expuestas
Las claves de API deben mantenerse seguras y rotarse periódicamente
Licencia
MIT License
Contribuciones
¡Las contribuciones son bienvenidas! Por favor, abre un issue o envía una pull request.
Available Tools
111 toolsanalyze_network_issuesARead-only
Analyze a site and return a structured report of potential issues.
Read-only operation: it aggregates device health, client connection problems, interference, firmware status, and recent alarms into an AI-friendly summary of what may be wrong. Use get_alarms for the raw active-alarm list, get_device_health_summary for device-only status, or get_optimization_recommendations when you want improvement suggestions rather than a fault report.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
apply_client_qos_policyADestructive
Apply a validated QoS preview when a supported adapter exists. Requires confirmation.
Mutating operation: loads the plan referenced by plan_token and attempts to activate it. In the current release no validated adapter exists, so no controller mutation is performed (mutation_attempted=false); the call records the attempt. Returns success=false unless confirm=true. Use plan_client_qos_policy first to obtain a plan_token.
Args: plan_token: Token returned by plan_client_qos_policy identifying the plan. confirm: Must be True to attempt application; without it the call is a no-op. Defaults to False.
Inputs: plan_token (required), confirm.
archive_all_alarmsAIdempotent
Acknowledge and archive every active alarm on a site.
Non-destructive state change: it marks open alarms as archived so they no longer show in get_alarms; no device configuration is modified. Use get_alarms first to review what will be cleared; prefer analyze_network_issues when you want findings without clearing alarm state.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
assign_client_groupAIdempotent
Assign or unassign one local client group. Requires confirm=true.
Mutating operation: sets the client's single local group membership (local_only) to the given group, or clears it when group is null. Does not mutate the controller. Returns success=false unless confirm=true. Use set_client_tags for tags, or list_clients_by_organization to find clients in a group.
Args: identity: Client MAC, IP, hostname, or alias to resolve to a known client. group: Group name to assign, or null/None to unassign the current group. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default. confirm: Must be True to change membership; without it the call is a no-op. Defaults to False.
Inputs: group (required), identity (required), site, device, +1 more.
block_clientAIdempotent
Block a client from accessing the network by MAC address.
Mutating operation: the block is applied immediately and persists in the controller's firewall/blocklist. Use unblock_client to restore access, or kick_client to drop the connection without a persistent block.
Args: mac: Client MAC address to target. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
capture_observations_nowAIdempotent
Capture a bounded batch of aggregate UniFi health observations immediately.
Mutating operation: collects current health observations and persists them into the observation store right away, then refreshes cached metrics. Returns the number of inserted observations and any scope limitations. Use before query_observation_trends to ensure recent data, or rely on scheduled capture otherwise.
Inputs: no named parameters.
create_client_groupADestructive
Create a controller-independent local client group. Requires confirm=true.
Mutating operation: persists a new empty local group (local_only) scoped to the controller/site; it does not create anything on the UniFi controller. Returns success=false unless confirm=true. Use assign_client_group to add members, or list_client_groups to see existing groups.
Args: name: Unique group name to create. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default. confirm: Must be True to create the group; without it the call is a no-op. Defaults to False.
Inputs: name (required), site, device, confirm.
create_firewall_policyA
Create a zone-based firewall policy (UniFi Network 9+).
Mutating operation: applied immediately and persisted on the UniFi console. Action is ALLOW, BLOCK, or REJECT across the src_zone_id to dst_zone_id pair. Lower index evaluates earlier. A controller-generated "(Return)" companion rule is typically added. Requires zone ids from get_firewall_policies; review there first.
Args: name: Policy name (used for display and zone inference). action: Packet decision — "ALLOW", "BLOCK", or "REJECT". src_zone_id: Source zone id (from get_firewall_policies). dst_zone_id: Destination zone id (from get_firewall_policies). protocol: Protocol selector — "all", "tcp", "udp", "tcp_udp", "icmp", "igmp", or "icmpv6". description: Optional human-readable description. client_macs: Restrict the source to these client MAC addresses. index: Rule order index; lower values evaluate earlier. Omit for auto-order. enabled: Create the policy enabled. Defaults to True. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: name (required), action (required), dst_zone_id (required), src_zone_id (required), +7 more.
create_firewall_ruleADestructive
Create a legacy firewall rule (UniFi Network <9 or traditional API).
Mutating operation: applied immediately and persisted on the controller. For zone-based policies (Network 9+), prefer create_firewall_policy. Review existing rules with get_firewall_rules first.
Args: name: Unique rule name action: Action — "accept", "drop", or "reject" protocol: Protocol — "tcp", "udp", "icmp", "all", or IANA number dst_port: Destination port or range (e.g., "80", "80-443") src_zone: Source zone ID (from get_firewall_policies) dst_zone: Destination zone ID src_port: Source port or range logging: Enable logging for matches enabled: Whether rule is active on creation. Defaults to True. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific console; omit for default.
Returns: Created firewall rule configuration
Inputs: name (required), action (required), protocol (required), site, +7 more.
create_interval_scheduleADestructive
Create an allowlisted recurring job. Requires confirm=true.
Mutating operation: persists a new interval schedule that runs job_name with the given arguments every interval_seconds. Returns success=false unless confirm=true. The job must be on the allowlist. Use set_schedule_enabled to pause it, or delete_schedule to remove it.
Args: name: Unique schedule identifier. job_name: Allowlisted job to run on the interval. interval_seconds: Recurrence period between runs, in seconds. arguments: Optional keyword arguments passed to the job on each run. confirm: Must be True to create the schedule; without it the call is a no-op. Defaults to False.
Inputs: name (required), job_name (required), interval_seconds (required), confirm, +1 more.
create_networkADestructive
Create a new network/VLAN segment on the gateway (corporate by default).
Mutating operation: applied immediately and persisted on the UniFi console. Provide subnet in CIDR form and an optional VLAN id to tag the segment; enable DHCP by supplying both dhcp_start and dhcp_stop. Requires confirm=true because routing/VLAN/DHCP changes can disrupt connectivity. Inspect with get_networks; reverse with delete_network.
Args: name: Network name (e.g. "IoT"). subnet: Subnet in CIDR form (e.g. "192.168.50.1/24"); omit for unrouted. vlan: VLAN id (1-4094) for a tagged segment; omit for untagged. purpose: Segment type — "corporate", "guest", or "wan". Defaults to "corporate". domain_name: DNS domain name advertised to clients (e.g. "example.local"). dhcp_start: DHCP pool start IP; supply with dhcp_stop to enable DHCP. dhcp_stop: DHCP pool end IP; supply with dhcp_start to enable DHCP. dhcp_lease_time: DHCP lease duration in seconds (default 86400). site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default. confirm: Safety gate: must be True to create. Defaults to False.
Inputs: name (required), site, vlan, device, +7 more.
create_port_forwardADestructive
Create a port-forwarding rule that opens an external WAN port and maps it to an internal host/port.
Mutating operation: applied immediately and persisted on the UniFi console. Review existing rules with get_port_forwards first; remove with delete_port_forward. Prefer create_firewall_policy for zone-based/stateful filtering.
Args: name: Unique rule identifier used to find/delete the rule later. dst_port: Internal destination port (1-65535) on the target host. fwd_ip: LAN IP of the internal host receiving forwarded traffic. fwd_port: External listening port (1-65535) on the WAN. proto: IP protocol to forward — "tcp", "udp", or "both". enabled: Whether active on creation. Defaults to True. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: name (required), fwd_ip (required), dst_port (required), fwd_port (required), +4 more.
create_webhook_destinationADestructive
Create a filtered outbound webhook. Requires confirm=true.
Mutating operation: persists a new outbound webhook destination posting to url, optionally signing with a secret from secret_env_name and limited to categories. Returns success=false unless confirm=true. Use set_webhook_destination_enabled to pause it, or delete_webhook_destination to remove it.
Args: name: Unique destination identifier. url: Endpoint that receives webhook payloads. secret_env_name: Optional name of an env var holding the signing secret. categories: Optional list of event categories to send; empty sends all. confirm: Must be True to create the destination; without it the call is a no-op. Defaults to False.
Inputs: url (required), name (required), confirm, categories, +1 more.
create_wlanADestructive
Create a wireless network (SSID) with WPA2/WPA3 transition security by default.
Mutating operation: applied immediately and persisted on the UniFi console. Passphrase must be 8-63 characters. WPA2/WPA3 transition is enabled unless wpa3_transition is False, keeping WPA2 for legacy clients. Attach to a VLAN via network_conf_id, or mark is_guest for an isolated guest SSID. Inspect with get_wlans.
Args: name: SSID broadcast name. passphrase: WiFi password, 8-63 characters. network_conf_id: Network id to attach the SSID to; omit for the default LAN. wpa3_transition: Use WPA2/WPA3 transition mode. Defaults to True. hide_ssid: Broadcast the SSID hidden when True. Defaults to False. is_guest: Mark the SSID as an isolated guest network. Defaults to False. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: name (required), passphrase (required), site, device, +4 more.
delete_client_groupADestructive
Delete a local group and its memberships. Requires confirm=true.
Mutating operation: removes the local group (local_only) and detaches its members; it does not touch the UniFi controller. Returns success=false unless confirm=true. Recreate with create_client_group if needed.
Args: name: Name of the local group to delete. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default. confirm: Must be True to delete the group; without it the call is a no-op. Defaults to False.
Inputs: name (required), site, device, confirm.
delete_firewall_policyADestructive
Delete a zone-based firewall policy.
Mutating operation: removed immediately and persisted on the UniFi console. Requires confirm=true because removing a policy changes traffic flow. Predefined controller policies are refused. Target by id from get_firewall_policies.
Args: policy_id: Policy id to delete (from get_firewall_policies). confirm: Safety gate: must be True to delete. Defaults to False. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: policy_id (required), site, device, confirm.
delete_firewall_ruleADestructive
Delete a legacy firewall rule. Requires confirm=True.
Mutating operation: permanently removes the rule from the controller.
Args: rule_id: Firewall rule ID (from get_firewall_rules) confirm: Must be True to actually delete site: Site to operate on. Defaults to "default". device: Optional console name to target a specific console; omit for default.
Returns: Deletion status
Inputs: rule_id (required), site, device, confirm.
delete_networkADestructive
Delete a network/VLAN by name or ID.
Mutating operation: removed immediately and persisted on the UniFi console. Requires confirm=true because deleting a network can drop clients and routes that depend on it. List networks with get_networks first to confirm the target.
Args: name: Network name or record id to delete. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default. confirm: Safety gate: must be True to delete. Defaults to False.
Inputs: name (required), site, device, confirm.
delete_port_forwardADestructive
Delete a port forwarding rule.
Mutating operation: removed immediately and persisted on the UniFi console. Requires confirm=true because removing a forward closes external access. Target by rule id from get_port_forwards.
Args: rule_id: Port forward rule id to delete (from get_port_forwards). confirm: Safety gate: must be True to delete. Defaults to False. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: rule_id (required), site, device, confirm.
delete_scheduleADestructive
Delete a non-running schedule. Requires confirm=true.
Mutating operation: removes the identified schedule from the store. Returns success=false unless confirm=true. Use create_interval_schedule to add one, or set_schedule_enabled to pause instead of delete.
Args: schedule_id: Identifier of the schedule to delete. confirm: Must be True to delete the schedule; without it the call is a no-op. Defaults to False.
Inputs: schedule_id (required), confirm.
delete_webhook_destinationADestructive
Delete a webhook destination and queued deliveries. Requires confirm=true.
Mutating operation: removes the identified webhook destination and its queued deliveries from the store. Returns success=false unless confirm=true. Use create_webhook_destination to add one.
Args: destination_id: Identifier of the webhook destination to delete. confirm: Must be True to delete the destination; without it the call is a no-op. Defaults to False.
Inputs: destination_id (required), confirm.
delete_wlanADestructive
Delete a wireless network (SSID).
Mutating operation: removed immediately and persisted on the UniFi console. Requires confirm=true because deleting an SSID disconnects its clients. Resolve the target by ID or name and review get_wlans first.
Args: wlan: WLAN id or SSID name to delete. confirm: Safety gate: must be True to delete. Defaults to False. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: wlan (required), site, device, confirm.
export_camera_clipADestructive
Export a UniFi Protect recording clip as an MP4 file written to local disk.
Mutating, file-writing operation: it resolves the camera (by id or name), fetches the recording for the requested time range, and writes an MP4 file into the server's confined export directory (the path is validated against that directory, so output_path must not escape it). Requires Protect username/password credentials configured for the console. The write is a no-op until confirm is set to true, at which point it returns the written file path and size in bytes. Use get_camera_snapshot for a single still image instead of a time-ranged clip.
Args: camera: Protect camera identifier or name to export footage from. start_ts: Clip start time as a Unix epoch timestamp (seconds). end_ts: Clip end time as a Unix epoch timestamp (seconds); must be after start_ts. output_path: Destination filename (or path relative to the export directory); it is confined to the server's export directory. device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device. confirm: Safety confirmation required for this file-writing operation; the export returns a failure message until set to true.
Inputs: camera (required), end_ts (required), start_ts (required), output_path (required), +2 more.
export_network_reportADestructive
Export an HTML or CSV report rendered from the portable snapshot model.
Mutating operation: writes a local report file immediately, persisted in the export directory. The call is rejected without writing unless confirm=true. Format must be "html" or "csv" and filename must end with the matching extension; plugins may register additional formats. Prefer export_portable_snapshot for the raw machine-readable model.
Args: filename: Output report file name inside the confined export directory; must end with the chosen format extension (e.g. .html, .csv). format: Report renderer to use — "html" or "csv" (plugins may register additional formats). confirm: Safety confirmation. Must be True to actually write; otherwise returns a rejection message.
Inputs: format (required), filename (required), confirm.
export_portable_snapshotADestructive
Export a deterministic secret-free JSON snapshot to a local confined file.
Mutating operation: writes a local file immediately, persisted in the export directory. Returns the filename, size, schema version, and a content SHA-256 checksum for later verification with verify_snapshot. The call is rejected without writing unless confirm=true. Use export_network_report for human-readable HTML/CSV instead of the raw JSON model.
Args: filename: Target file name written inside the confined export directory (no path traversal). confirm: Safety confirmation. Must be True to actually write; otherwise returns a rejection message.
Inputs: filename (required), confirm.
forget_clientADestructive
Remove a client from the controller's known-clients list.
Destructive operation: deletes the client's stored identity and history; the client can still reappear on reconnect. Use kick_client to drop a session without deletion, or block_client to deny access persistently.
Args: mac: Client MAC address to target. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
get_alarmsARead-only
Return the currently active alarms (faults and warnings) for a site.
Read-only operation: it lists unacknowledged/active alarms with severity and message so you can see what needs attention. Use get_recent_events for the broad event feed including non-alarm activity; clear them with archive_all_alarms once handled, or use analyze_network_issues for a consolidated interpretation of alarms and health.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_all_sites_healthARead-only
Return a health overview for every site managed by one UniFi console.
Read-only operation: it walks each site on the targeted console and returns a compact health snapshot per site (status, score, and key counts). Unlike get_global_health, this stays within a single console; unlike get_site_health, it covers all sites at once rather than one. Use get_global_health when you need cross-console aggregation; prefer get_site_health when you want full per-subsystem detail for a single named site.
Args: device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: device.
get_camera_detailsARead-only
Get the full configuration and runtime record for one Protect camera.
Read-only operation: it returns the camera's model, firmware, resolution, recording mode, privacy/IR state, connection state, and live statistics. The camera is resolved by ID first and then by name, so either form is accepted. Use list_cameras first to find the camera_id; use get_camera_snapshot to capture an image, or get_camera_health_summary for a connectivity-only view.
Args: camera_id: Protect camera identifier or name to look up. device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: camera_id (required), device.
get_camera_health_summaryARead-only
Summarize the connectivity and health of all cameras on one Protect console.
Read-only operation: it partitions cameras into connected and disconnected sets, returns an overall status of "healthy" or "degraded", lists each disconnected camera as a critical issue, and offers remediation recommendations. Use this for a fleet-wide connectivity check; use list_cameras for the full per-camera detail or get_camera_details for one camera's complete record.
Args: device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: device.
get_camera_snapshotARead-only
Capture a still image from a connected Protect camera as a base64 JPEG.
Read-only operation: it requests a live frame from the camera and returns it as a base64-encoded JPEG plus camera name and id. If width and/or height are provided the image is resized to those pixel dimensions; if omitted the camera's native resolution is returned. A camera that is not in the CONNECTED state returns a success=false result rather than an image. Use get_camera_details to confirm the camera is online before calling.
Args: camera_id: Protect camera identifier or name to capture from. device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device. width: Optional target pixel width for the snapshot; native width if unset. height: Optional target pixel height for the snapshot; native height if unset.
Inputs: camera_id (required), width, device, height.
get_client_detailsARead-only
Get the full device record for one client by MAC address.
Read-only operation: returns the client's identity, connection state, IP, signal/AP association, and history. Deeper than list_clients/list_all_clients, which return summarized rows only.
Args: mac: Client MAC address to target. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
get_client_experience_reportARead-only
Generate a client experience report with connection-quality metrics for a site.
Read-only operation: it summarizes signal-strength distribution, roaming stats, failed connections, and problematic clients across the site. Use troubleshoot_client for a deep dive on one specific client, or get_device_health_summary for the infrastructure view rather than client-side.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_client_organizationARead-only
Get durable local tags and group membership for one known client.
Read-only operation: resolves the client by identity, then returns its persisted local organization record (tags and group membership). This data is local to the server (local_only) and does not mutate the controller. Use set_client_tags or assign_client_group to change it.
Args: identity: Client MAC, IP, hostname, or alias to resolve to a known client. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: identity (required), site, device.
get_client_qos_capabilitiesARead-only
Describe validated controller QoS mutation capabilities.
Read-only operation: reports whether a validated controller QoS adapter is available for the targeted device. Previews created by plan_client_qos_policy are always local; apply_client_qos_policy performs no controller mutation in the current release. Use this before planning a policy to set expectations.
Args: device: Optional device name to target a specific console; omit for default.
Inputs: device.
get_client_trafficARead-only
Get traffic statistics (rx/tx, throughput) for one client by MAC address.
Read-only operation: returns the client's cumulative and recent traffic counters. Use get_client_details for identity/connection state, or get_traffic_summary for site-wide traffic rather than a single client.
Args: mac: Client MAC address to target. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
get_device_detailsARead-only
Get detailed configuration and runtime record for one UniFi device.
Read-only operation: returns the device's ports, radios, uplink, system stats, temperatures, and traffic counters. The device is resolved by MAC first, then by name. Use list_devices to find the MAC; use get_device_stats for a metrics-only view without the full config dump.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
get_device_health_summaryARead-only
Summarize device health across all APs, switches, and routers at a site.
Read-only operation: it reports uptime, load, memory, temperature, firmware versions, and devices needing attention. Use get_site_health or get_network_health for overall/site status, analyze_network_issues for issues folded into a report, or get_client_experience_report for the client perspective.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_device_portsARead-only
List the switch/gateway ports on a device with link and VLAN details.
Read-only operation: returns each port's index, name, media (GE/SFP), link state, speed, native network (VLAN) ID, PoE mode, forward setting, and the last connected peer MAC/IP where known. Use this to find the port_idx and current values before calling set_device_port.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
get_device_statsARead-only
Get performance and traffic statistics for one UniFi device.
Read-only operation: returns CPU/memory load, temperatures, fan level, client counts (user/guest), traffic totals, and AP radio stats where applicable. Use get_device_details for the full config record instead of metrics, or list_devices for a lightweight summary.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
get_dpi_statsARead-only
Return Deep Packet Inspection application-breakdown statistics for a site.
Read-only operation: it ranks traffic by detected application/category so you can see what protocols and apps dominate usage. Use get_traffic_summary for a lighter volume-only overview, get_traffic_analysis for time-windowed trends and top talkers, or get_client_traffic for a single client's DPI view.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_event_polling_statusARead-only
List event source capabilities and background polling state.
Read-only operation: returns each known event source with its capabilities and whether background polling is enabled. Use this to discover source names for poll_events_now, or list_runtime_events to read stored events.
Inputs: no named parameters.
get_firewall_policiesARead-only
Get zone-based firewall policies (UniFi Network 9+).
Read-only operation: returns each policy's name, action, protocol, index order, and source/destination zone ids. Policies are evaluated in index order; predefined "(Return)" companions appear alongside custom rules. Use create_firewall_policy to add one, or set_firewall_policy_enabled / delete_firewall_policy to manage it.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_firewall_rulesARead-only
Get legacy firewall rule configurations for a site.
Read-only operation: returns each rule's name, action, protocol, port, ruleset, and firewall-group bindings. Modern controllers use zone-based policies instead — see get_firewall_policies. Use create_firewall_policy for zone-based filtering.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_global_client_summaryARead-only
Summarize connected clients across every configured network console.
Read-only operation: it aggregates active clients from each network-enabled device and computes totals (wireless/wired/blocked), the top 10 talkers by usage, and a per-device client count. Use this for fleet-wide client visibility; use get_global_inventory for the device roster, get_global_health for subsystem health, or list_clients on a single console for the full per-client detail.
Returns: Dict with total_clients, wireless/wired/blocked counts, top_talkers, per_device counts, and an errors list when a console fails.
Inputs: no named parameters.
get_global_healthARead-only
Aggregate site health across every configured network console into one report.
Read-only operation: it collects per-subsystem site health (WAN/LAN/WLAN status, health score, and device/user counts) from each network-enabled device and folds them into a unified view with an overall "healthy" or "degraded" verdict. Use this for a single fleet-wide health check; use get_global_inventory for the device roster, get_global_client_summary for client counts, or get_site_health on a single console for full subsystem detail.
Returns: Dict with overall_status, device_count, a per-device subsystems breakdown, and an errors list when a console fails.
Inputs: no named parameters.
get_global_inventoryARead-only
Aggregate the full device inventory across every configured network console.
Read-only operation: it calls list_devices on each network-enabled device and merges the results into one list, tagging every entry with its source device name, plus any per-console errors. Use this to see every AP, switch, gateway, and router across all sites in one view; use list_unifi_devices for the console roster itself, or get_global_health / get_global_client_summary for aggregated health and client counts rather than the raw device records.
Returns: Dict with total_devices, the merged devices list (each tagged _source_device), and an errors list when a console fails.
Inputs: no named parameters.
get_liveviewsARead-only
List all configured UniFi Protect liveviews (camera view layouts).
Read-only operation: it returns each liveview's name, id, and the cameras and layout it includes on the targeted console. Use this to discover view groupings for dashboards or to confirm which cameras belong to a named liveview; it does not return footage or snapshots.
Args: device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: device.
get_motion_eventsARead-only
Return recent camera motion events, resolved to camera names and timestamps.
Read-only operation: it queries Protect motion events over the lookback window, maps each event to its camera name and a human-readable timestamp, and returns the count and per-event list. Requires Protect username/password credentials configured for the console. Use get_smart_detections instead when you need AI classification (person/vehicle/animal/package) rather than raw motion; use get_protect_event_summary for aggregate counts.
Args: hours: Lookback window in hours from now (default 24). limit: Maximum number of events to return (default 50). camera_id: Optional Protect camera identifier or name to filter events to one camera; omit for all cameras. device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: hours, limit, device, camera_id.
get_network_healthARead-only
Return a single overall health summary for one site's network.
Read-only operation: it aggregates WAN/LAN/WLAN status, a composite health score, and device/user tallies into one condensed report. Use get_site_health when you need full per-subsystem detail for that site, get_all_sites_health for a multi-site sweep on one console, or get_global_health for cross-console aggregation.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_networksARead-only
Get all network/VLAN configurations for a site.
Read-only operation: returns each network's name, purpose, VLAN id, subnet CIDR, and DHCP settings. Use create_network / update_network / delete_network to change them, or get_wlans for wireless networks.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_observation_retention_statusARead-only
Get aggregate observation count and retained time range.
Read-only operation. Returns how many observations are stored and the earliest-to-latest retained time span. Use to gauge whether query_observation_trends can cover a desired window.
Inputs: no named parameters.
get_optimization_recommendationsARead-only
Analyze a site's configuration and return optimization recommendations.
Read-only operation: it checks channel selection, TX power, VLAN efficiency, port configurations, and bandwidth utilization to suggest improvements. Use analyze_network_issues when you want a fault/issue report instead of proactive tuning advice, or get_device_health_summary for device status only.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_plugin_statusARead-only
List redacted trusted-plugin loading outcomes.
Read-only operation. Returns whether trusted code and sandboxing are active plus each plugin's load outcome. Requires admin scope when called over HTTP. Use to audit which plugins loaded successfully after startup.
Inputs: no named parameters.
get_port_forwardsARead-only
Get all port forwarding rules for a site.
Read-only operation: returns each rule mapping an external port+protocol to an internal IP+port on the gateway. Use this to audit forwards and to find a rule id before delete_port_forward, or create_port_forward to add one.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_port_profilesARead-only
Get switch port profile configurations for a site.
Read-only operation: returns each port profile's name and the settings applied to member switch ports (PoE, VLAN, forwarding). Use set_device_port to apply changes to a specific physical port.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_protect_accessoriesARead-only
Inventory all UniFi Protect accessories: lights, sensors, chimes, and viewers.
Read-only operation: it queries each accessory type on the targeted console and returns the raw records grouped by type along with a per-type count summary. Use this to audit Protect peripherals alongside cameras; it does not return camera devices (see list_cameras) nor event history.
Args: device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: device.
get_protect_event_summaryARead-only
Summarize all Protect events (motion, smart detections, doorbell) over a window.
Read-only operation: it aggregates event counts by type and camera activity for the lookback window on the targeted console. Requires Protect username/password credentials configured for the console. Use this for a single high-level tally; use get_motion_events or get_smart_detections for the underlying event records, or get_recent_protect_activity for the latest raw events.
Args: hours: Lookback window in hours from now (default 24). device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: hours, device.
get_protect_system_infoARead-only
Return UniFi Protect system information for one console, including device counts.
Read-only operation: it reports the Protect system version, NVR/storage status, and counts of cameras and accessories managed by the targeted console. Use this for a high-level overlay of a Protect deployment; use list_cameras or get_protect_accessories for the individual device inventory, or get_camera_health_summary for camera connectivity.
Args: device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: device.
get_recent_eventsARead-only
Return recent network events (connections, roams, admin actions) for a site.
Read-only operation: it surfaces the newest logged events with type, timestamp, and subject so you can trace what changed on the network. Use get_alarms when you only care about active fault/warning alarms rather than the full event stream; use get_optimization_recommendations or analyze_network_issues for interpreted, actionable findings.
Args: limit: Maximum number of events to return (default 50). site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, limit, device.
get_recent_protect_activityARead-only
Return the most recent Protect events across all cameras as a quick overview.
Read-only operation: it fetches the latest events (up to limit) for the targeted console with camera names and timestamps resolved. Requires Protect username/password credentials configured for the console. Use this for a fast "what just happened" check; use get_protect_event_summary for aggregate counts or get_motion_events/get_smart_detections for filtered, time-windowed history.
Args: limit: Maximum number of recent events to return (default 20). device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: limit, device.
get_routing_tableARead-only
Return the live Layer-3 routing table for a site's gateway.
Read-only operation: it lists each route with destination, next-hop, interface, and source/metric so you can verify static and learned routes. Use get_networks to inspect configured VLAN/subnet definitions rather than active forwarding paths.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_server_healthARead-only
Return redaction-safe UniFi MCP runtime health and service counts.
Read-only operation. Reports counts of registered tools, configured data sources, and plugin status without exposing any secrets. Use to confirm the server and its sources are healthy before issuing deeper queries.
Inputs: no named parameters. Returns: Redaction-safe UniFi MCP server health response.
get_site_healthARead-only
Get comprehensive health status for a site.
Read-only operation: returns per-subsystem health (WAN/LAN/WLAN status, score, and device/user counts) for the named site. Use get_network_health for a lighter summary, or get_global_health across consoles.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_site_settingsARead-only
Get the configuration settings for a site.
Read-only operation: returns the site's settings record (network, wireless, and advanced options) as stored on the controller. Use get_sysinfo for controller identity rather than tunable settings.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_smart_detectionsARead-only
Return AI smart-detection events (person, vehicle, animal, package) with types.
Read-only operation: it queries Protect smart-detection events over the lookback window, maps each to its camera name and timestamp, and includes the smartDetectTypes and confidence score. Requires Protect username/password credentials configured for the console. Use detection_type to narrow to one class (e.g. "person"); use get_motion_events for raw motion without classification, or get_protect_event_summary for aggregate counts.
Args: hours: Lookback window in hours from now (default 24). limit: Maximum number of events to return (default 50). detection_type: Optional class filter - one of "person", "vehicle", "animal", "package"; omit for all smart-detection types. device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: hours, limit, device, detection_type.
get_snapshot_capabilitiesARead-only
Describe portable snapshot and report capabilities plus native backup limits.
Read-only operation. Returns supported report formats (html, csv), whether native controller backup/restore are available, and the configured source list. Use to learn what export_portable_snapshot and export_network_report can produce before calling them.
Inputs: no named parameters.
get_speed_test_statusARead-only
Return the latest WAN speed-test result and run state for a site.
Read-only operation: it reports download/upload/latency from the most recent test and whether a test is in progress. Use run_speed_test to initiate a new measurement; this does not start one.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_sysinfoARead-only
Get system information for the site controller.
Read-only operation: returns controller identity, firmware version, and hardware/model details for the named site. Use get_site_settings for tunable settings instead of controller metadata.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
get_traffic_analysisARead-only
Analyze site traffic patterns over a configurable time window.
Read-only operation: it reports top talkers, application breakdown (DPI), bandwidth trends, and unusual activity for the lookback period. Use get_traffic_summary for a quick volume-only snapshot, get_dpi_stats for the app breakdown without the time series, or get_client_traffic for one client.
Args: hours: Lookback window in hours from now (default 24). site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, hours, device.
get_traffic_summaryARead-only
Return a condensed traffic-volume summary for a site.
Read-only operation: it reports overall throughput and totals without the per-app or time-series detail. Use get_dpi_stats for application-level breakdown, get_traffic_analysis for windowed trends and top talkers, or get_client_traffic for a specific client.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
get_wlansARead-only
Get all wireless network (SSID) configurations for a site.
Read-only operation: returns each WLAN's name, id, enabled state, guest flag, and security settings. Use create_wlan / update_wlan / delete_wlan to change them, or get_networks for wired networks.
Args: site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: site, device.
kick_clientAIdempotent
Force-disconnect a client; it may reconnect normally.
Mutating operation: drops the active session without a persistent block, so the client can re-associate. Use block_client/unblock_client for a lasting block, or forget_client to remove the client record entirely.
Args: mac: Client MAC address to target. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
list_all_clientsARead-only
List every known client (connected and offline) on a site.
Read-only operation: includes clients not currently connected, so it is the superset of list_clients. Use get_client_details for deep per-client detail or list_clients when you only need active connections.
Args: site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: site, device.
list_camerasARead-only
List every UniFi Protect camera with its online state and identity.
Read-only operation: it returns a summary per camera (name, model, state, and connection status) for the targeted Protect console. Use this to discover the camera_id values needed by get_camera_details, get_camera_snapshot, get_camera_health_summary, and the event tools. Use get_camera_health_summary when you only need aggregate connected/disconnected counts rather than the full per-camera list.
Args: device: Optional Protect console name to target a specific UniFi Protect device; omit to use the first Protect-enabled device.
Inputs: device.
list_client_groupsARead-only
List local client groups and deterministic member counts.
Read-only operation: returns the local groups (local_only) for the controller/site with a deterministic member count per group. Use list_clients_by_organization to enumerate the actual member identities.
Args: site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: site, device.
list_clientsARead-only
List all currently connected (online) clients on a site.
Read-only operation: returns only clients with an active connection at query time. For the historical/known roster including offline clients use list_all_clients; for deep per-client detail use get_client_details.
Args: site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: site, device.
list_clients_by_organizationARead-only
List stable client identities for exactly one local tag or group.
Read-only operation: returns the persisted client keys (MACs) that match a single tag or group filter (local_only). Exactly one of tag or group must be supplied; supplying neither or both is an error. Use list_client_groups to discover group names.
Args: tag: Optional local tag to filter clients by; mutually exclusive with group. group: Optional local group name to filter clients by; mutually exclusive with tag. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: tag, site, group, device.
list_devicesARead-only
List all UniFi network devices (APs, switches, routers) on a site.
Read-only operation: returns a per-device summary for the targeted site, including name, MAC, model, type, IP, online state, uptime, and firmware version. Use this to discover the MAC values needed by get_device_details, restart_device, and the other device tools.
Distinction: use list_unifi_devices to see the server's configured consoles (controller roster); use get_global_inventory for an aggregated inventory across all consoles. This tool lists devices within one site on one console.
Args: site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: site, device.
list_job_runsARead-only
List redacted background job run outcomes.
Read-only operation: returns up to limit recent schedule/job run records
(status, timestamps) with secret values redacted. Use run_schedule_now or
list_schedules to discover runnable schedules.
Args: limit: Maximum number of job runs to return. Defaults to 100.
Inputs: limit.
list_observation_scopesARead-only
List the aggregate observation scopes currently retained.
Read-only operation. Returns the distinct scope dimensions (source, controller, site) present in the observation store. Use to discover valid filter values for query_observation_trends.
Inputs: no named parameters.
list_runtime_eventsARead-only
List normalized events retained by the optional runtime store.
Read-only operation: returns up to limit normalized events persisted by the
runtime store. Requires UNIFI_RUNTIME_ENABLED=true; otherwise unavailable. Use
get_event_polling_status to see which sources feed events.
Args: limit: Maximum number of events to return. Defaults to 100.
Inputs: limit.
list_schedulesARead-only
List allowlisted interval schedules.
Read-only operation: returns the persisted interval schedules (name, job, interval, enabled) and whether background automation is enabled. Use create_interval_schedule to add one, or run_schedule_now to trigger it.
Inputs: no named parameters.
list_sitesARead-only
List all UniFi sites accessible to the current user.
Read-only operation: returns each site's id and name from the targeted console(s). Use get_site_health / get_site_settings for per-site detail once you have a site name.
Args: device: Optional console name to target a specific UniFi device; omit for the default device.
Inputs: device.
list_unifi_devicesARead-only
List every UniFi device (console) configured for this server.
Read-only operation: it returns each configured device's name, controller
URL, site, and the services it exposes (network, protect), plus convenience
lists of network-only and protect-only device names. This is the authoritative
source for the device name accepted by every other tool's optional device
parameter. Use get_global_inventory / get_global_health when you instead want
aggregated data across those consoles rather than the console roster itself.
Returns: Dict with total_devices, a per-device list, and network_devices / protect_devices name lists.
Inputs: no named parameters.
list_webhook_deliveriesARead-only
List redacted webhook delivery and dead-letter state.
Read-only operation: returns up to limit delivery records (status, attempts,
dead-letter state) with secret values redacted. Use test_webhook_destination to
trigger a send, or list_webhook_destinations to see configured endpoints.
Args: limit: Maximum number of delivery records to return. Defaults to 100.
Inputs: limit.
list_webhook_destinationsARead-only
List webhook destinations without secret values.
Read-only operation: returns configured outbound webhook destinations with secret material omitted. Use create_webhook_destination to add one, or list_webhook_deliveries to see send history.
Inputs: no named parameters.
locate_deviceAIdempotent
Enable or disable LED blinking to physically locate a device.
Mutating operation: toggles the locator LED on the device and is persisted on the console. Set enabled=True to start blinking, False to stop. This changes only the LED state and has no effect on connectivity or config.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). enabled: True to start LED blinking, False to stop. Defaults to True. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device, enabled.
plan_client_qos_policyA
Persist a deterministic QoS target preview without controller mutation.
Mutating (local) operation: resolves selector_type/selector_value to concrete client keys and stores a durable QoS plan (plan_token) on the server with the requested download/upload limits. It does NOT change the controller. Pair the returned plan_token with apply_client_qos_policy to attempt activation. Requires UNIFI_RUNTIME_ENABLED=true; use get_client_qos_capabilities to check adapters.
Args: selector_type: Scope of the policy - "client", "tag", or "group". selector_value: Client identity (MAC/IP/hostname) when selector_type is "client", otherwise the tag or group name to expand to clients. download_kbps: Maximum download bandwidth in kilobits per second. upload_kbps: Maximum upload bandwidth in kilobits per second. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: upload_kbps (required), download_kbps (required), selector_type (required), selector_value (required), +2 more.
poll_events_nowAIdempotent
Poll supported event sources now and durably deduplicate results.
Mutating (local) operation: triggers an immediate poll of matching event sources, inserts new normalized events into the runtime store, and deduplicates against what is already persisted. Requires UNIFI_RUNTIME_ENABLED=true. Use get_event_polling_status to discover source names; use list_runtime_events to read stored results.
Args: source: Optional source name to poll a single source; omit for all sources. device_name: Optional console/device name to filter sources; omit for all.
Inputs: source, device_name.
provision_deviceADestructive
Force re-provision a device with its current configuration.
Mutating operation: re-pushes the existing config to the device and is persisted on the console, without changing firmware or power-cycling like upgrade_device or restart_device. Use after config edits to force the device to re-adopt current settings.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
query_observation_trendsARead-only
Query bounded UTC trend buckets for an observation kind and metric.
Read-only operation. Returns evenly spaced time buckets between start and end with explicit gaps for missing intervals, so callers can distinguish absence from zero. Bucket size defaults to 300 seconds. Use capture_observations_now first if recent data is missing.
Args: kind: Observation category to query (e.g. "health", "client", "device"). metric: Metric name within the kind (e.g. "latency_ms", "cpu_pct"). start: Inclusive UTC start timestamp (ISO-8601). end: Inclusive UTC end timestamp (ISO-8601). bucket_seconds: Width of each trend bucket in seconds. Defaults to 300. source: Optional source filter (e.g. controller type); omit for all sources. controller: Optional controller identifier filter; omit for all controllers. site: Optional site name filter (e.g. "default"); omit for all sites.
Inputs: end (required), kind (required), start (required), metric (required), +4 more.
reserve_client_ipAIdempotent
Create a DHCP reservation pinning an IP to a client.
Mutating operation: reserves the client's current IP (when ip is omitted) or the given IPv4 address, so the client keeps it across leases. Requires the client to be known; use list_clients to find the current IP if needed.
Args: client: Client MAC address or name to reserve an IP for. ip: Optional IPv4 address to reserve; omit to keep the client's current IP. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: client (required), ip, site, device.
restart_deviceADestructive
Restart (reboot) a UniFi device by MAC address.
Mutating operation: sends a reboot command that is persisted on the console; the device goes offline briefly and reconnects. Unlike provision_device (re-push config without reboot) and upgrade_device (firmware update), this power-cycles the device. No other config change is needed.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
run_schedule_nowADestructive
Run one allowlisted schedule immediately. Requires confirm=true.
Mutating operation: executes the identified schedule's job once, outside its normal interval, and records the run. Returns success=false unless confirm=true. Use list_job_runs to inspect the outcome; use set_schedule_enabled to disable auto-runs.
Args: schedule_id: Identifier of the schedule to run immediately. confirm: Must be True to run the schedule; without it the call is a no-op. Defaults to False.
Inputs: schedule_id (required), confirm.
run_speed_testAIdempotent
Start an on-demand WAN speed test from the site gateway.
Mutating/long-running operation: it triggers a test against the speed-test endpoint and returns a handle or immediate result; poll get_speed_test_status for completion. Use get_speed_test_status to read the latest result without starting a new test.
Args: site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: site, device.
set_client_tagsAIdempotent
Replace local client tags by stable identity. Requires confirm=true.
Mutating operation: overwrites the client's persisted local tags with the supplied list and is stored on the server (local_only), not the controller. Returns success=false unless confirm=true. Use get_client_organization to read current tags first; use assign_client_group for group membership.
Args: identity: Client MAC, IP, hostname, or alias to resolve to a known client. tags: Full replacement tag list; an empty list clears all tags. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default. confirm: Must be True to apply the change; without it the call is a no-op. Defaults to False.
Inputs: tags (required), identity (required), site, device, +1 more.
set_device_portADestructive
Configure a single switch port: native VLAN, PoE mode, name, or enable state.
Mutating operation: applied immediately and persisted on the console, changing untagged VLAN traffic, PoE delivery, or link state on that port. Only the fields you provide change. Requires confirm=true because a port change can disrupt connectivity for the attached device or downstream network. Use get_device_ports first to find the port_idx and current values.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). port_idx: Port number to configure (1-based; e.g. 1-24 or SFP 25/26). name: Optional custom port name (e.g. "Cameras"). native_network: Optional network or VLAN name (or its ID) to set as the port's native/untagged VLAN. poe_mode: Optional PoE mode - "auto", "on", "off", or "passv24". forward: Optional VLAN forwarding - "all" (every VLAN) or "customize". enabled: Optional port enable state; True connects, False disables. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default. confirm: Must be True to apply the port change. Defaults to False.
Inputs: mac (required), port_idx (required), name, site, +6 more.
set_firewall_policy_enabledAIdempotent
Enable or disable a zone-based firewall policy.
Mutating operation: applied immediately and persisted on the UniFi console. Targets the policy by id from get_firewall_policies. Predefined controller policies can be toggled but not deleted. Inspect state with get_firewall_policies.
Args: policy_id: Policy id to toggle (from get_firewall_policies). enabled: True to enable, False to disable. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: enabled (required), policy_id (required), site, device.
set_schedule_enabledAIdempotent
Enable or pause a schedule. Requires confirm=true.
Mutating operation: flips the enabled flag on the identified schedule and persists it. Returns success=false unless confirm=true. Use create_interval_schedule to add, or delete_schedule to remove.
Args: schedule_id: Identifier of the schedule to modify. enabled: True to enable (run on interval) or False to pause it. confirm: Must be True to change the schedule; without it the call is a no-op. Defaults to False.
Inputs: enabled (required), schedule_id (required), confirm.
set_webhook_destination_enabledAIdempotent
Enable or pause a webhook destination. Requires confirm=true.
Mutating operation: flips the enabled flag on the identified webhook destination and persists it. Returns success=false unless confirm=true. Use create_webhook_destination to add, or delete_webhook_destination to remove.
Args: destination_id: Identifier of the webhook destination to modify. enabled: True to enable delivery or False to pause it. confirm: Must be True to change the destination; without it the call is a no-op. Defaults to False.
Inputs: enabled (required), destination_id (required), confirm.
test_webhook_destinationADestructive
Send a synthetic payload to a webhook destination. Requires confirm=true.
Mutating (external) operation: dispatches a synthetic test payload to the identified destination and records the delivery outcome. Returns success=false unless confirm=true. Use list_webhook_deliveries to inspect the result.
Args: destination_id: Identifier of the webhook destination to test. confirm: Must be True to send the test payload; without it the call is a no-op. Defaults to False.
Inputs: destination_id (required), confirm.
troubleshoot_clientARead-only
Run a deep-dive troubleshooting analysis for one specific client.
Read-only operation: it examines connection history, signal quality, AP associations, roaming events, and potential issues for the named client. Use get_client_experience_report for a site-wide client-quality overview, or get_client_details for the raw record of one client without the analysis.
Args: mac: MAC address of the client to troubleshoot. site: Site to query. Defaults to "default". device: Optional console/device name to target a specific UniFi console; omit to use the default.
Inputs: mac (required), site, device.
unblock_clientAIdempotent
Remove a prior block so a client can reconnect to the network.
Mutating operation: clears the persistent block set by block_client. Use block_client to re-block, or kick_client for a non-persistent disconnect.
Args: mac: Client MAC address to target. site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
update_cameraADestructive
Update a camera's configuration.
Mutating operation: changes are applied immediately and persisted on the Protect console. Requires username/password configured for the device.
Args: camera: Camera ID or name (resolved by name if not an ID) name: New camera name is_recording_enabled: Enable/disable recording recording_mode: Recording mode — "always", "motion", "smart_detect", "never" device: Optional Protect console name to target a specific UniFi Protect device; omit for first configured Protect device.
Returns: Updated camera configuration
Inputs: camera (required), name, device, recording_mode, +1 more.
update_firewall_ruleADestructive
Update a legacy firewall rule. Only provided fields are changed.
Mutating operation: applied immediately and persisted on the controller. Use get_firewall_rules to find the rule ID first.
Args: rule_id: Firewall rule ID (from get_firewall_rules) name: New rule name action: Action — "accept", "drop", or "reject" protocol: Protocol — "tcp", "udp", "icmp", "all", or IANA number dst_port: Destination port or range src_zone: Source zone ID dst_zone: Destination zone ID src_port: Source port or range logging: Enable/disable logging enabled: Enable/disable the rule site: Site to operate on. Defaults to "default". device: Optional console name to target a specific console; omit for default.
Returns: Updated firewall rule configuration
Inputs: rule_id (required), name, site, action, +8 more.
update_networkADestructive
Update a network/VLAN; only the fields you provide change.
Mutating operation: applied immediately and persisted on the UniFi console. A single field change preserves the network's other settings. Pass both empty dhcp_start and dhcp_stop to disable DHCP. Requires confirm=true because VLAN, routing, or enable-state changes can disconnect clients. Inspect with get_networks.
Args: name: Network name or record id to update. name_new: Rename the network to this value. subnet: New subnet in CIDR form (e.g. "192.168.50.1/24"). vlan: New VLAN id (1-4094); pass -1 to clear VLAN tagging. domain_name: New DNS domain name for clients. dhcp_start: New DHCP pool start IP; pair with dhcp_stop to enable DHCP. dhcp_stop: New DHCP pool end IP; pair with dhcp_start to enable DHCP. dhcp_lease_time: New DHCP lease duration in seconds. enabled: Enable or disable the network. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default. confirm: Safety gate: must be True to apply. Defaults to False.
Inputs: name (required), site, vlan, device, +8 more.
update_site_settingsADestructive
Update site settings.
Mutating operation: changes are applied immediately and persisted. Settings are key-value pairs matching the UniFi site setting schema. Use get_site_settings first to see available settings and their current values.
Args: settings: Dictionary of settings to update (e.g., {"auto_backup_enabled": true}) site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: settings (required), site, device.
update_wlanADestructive
Update a wireless network (SSID); only the fields you provide change.
Mutating operation: applied immediately and persisted on the UniFi console. Any single field updates the matching SSID (resolved by ID or name). Requoting passphrase sets the WiFi password; pmf_mode is disabled|optional|required. Inspect with get_wlans.
Args: wlan: WLAN id or SSID name to update. enabled: Enable or disable the SSID. hide_ssid: Hide the SSID from beacon broadcasts. passphrase: New WiFi password (minimum 8 characters). wpa3_support: Enable WPA3 support on the SSID. wpa3_transition: WPA2/WPA3 transition mode (keeps WPA2 for legacy clients). pmf_mode: Protected Management Frames mode — "disabled", "optional", or "required". bss_transition: Enable 802.11k/v band and AP steering. fast_roaming_enabled: Enable 802.11r fast roaming. site: Site to operate on. Defaults to "default". device: Optional console name to target a specific UniFi device; omit for default.
Inputs: wlan (required), site, device, enabled, +7 more.
upgrade_deviceADestructive
Upgrade a device's firmware to the latest available version.
Mutating operation: initiates a firmware upgrade that is persisted once applied; the device reboots during the update. Unlike restart_device (plain reboot) and provision_device (config re-push), this changes the running firmware. Only proceeds when an upgrade is available on the console.
Args: mac: Device MAC address (case-insensitive; aa:bb:cc:dd:ee:ff or aabbccddeeff). site: Site to operate on. Defaults to "default". device: Optional device name to target a specific console; omit for default.
Inputs: mac (required), site, device.
verify_snapshotARead-only
Verify the schema and checksum of a confined snapshot export.
Read-only operation. Reads the named snapshot from the export directory and validates its schema, redaction status, and content SHA-256. Returns validity plus schema version and checksum for integrity checks. Use after export_portable_snapshot to confirm the file is intact and secret-free.
Args: filename: Name of the snapshot file (within the confined export directory) to validate.
Inputs: filename (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 111 tools
The descriptions are unusually thorough and cross-reference near-neighbors well, but 111 tools creates many clusters where an agent could easily pick the wrong one. Health summaries, traffic views, Protect event tools, and analysis reports all overlap enough that careful reading is required to avoid misselection.
Names overwhelmingly follow a clear verb_noun pattern such as list_*, get_*, create_*, update_*, delete_*, and set_*. Minor inconsistencies exist: reads mix list_ and get_ arbitrarily, global aggregation uses get_global_* alongside get_all_sites_health, and trigger operations use capture_, poll_, run_, and test_ inconsistently.
With 111 tools, this is a severe count mismatch even for a server covering UniFi Network, Protect, and runtime administration. The tool count far exceeds the 25+ threshold for 'too many' and will overwhelm agent context and increase selection errors.
The surface is remarkably broad, covering CRUD for networks, WLANs, firewall rules/policies, client management, schedules, webhooks, and Protect cameras, plus global aggregation and analysis. Notable gaps include no update for firewall policies or port-forwarding rules and no device adoption/forget lifecycle, but most gaps can be worked around.
Maintenance
Related MCP Connectors
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Gives your AI assistant persistent memory and intelligence about your work patterns.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Connect AI assistants to explicitly paired computers, servers, and VMs for permitted remote actions.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to manage and monitor UniFi Network Controllers through natural language. Provides 25 read-only tools for discovering devices and clients, viewing security configurations, analyzing network statistics, and exporting configuration data.41MIT
- FlicenseNot gradedqualityDmaintenanceProvides AI assistants with access to UniFi Network and Protect infrastructure for managing devices, monitoring clients, analyzing network health, viewing camera snapshots, and getting optimization recommendations across multiple UniFi controllers.2-
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to manage and monitor UniFi network infrastructure through natural language, providing 46 management tools across device, client, WiFi, network, firewall, port forwarding, monitoring, and site management.1MIT
- AlicenseAqualityBmaintenanceEnables querying UniFi network devices and data using natural language through MCP clients like Claude Desktop.4494 npm1MIT