UniFi MCP Server
An open-source MCP server that gives AI agents one standard tool interface to UniFi networks, with safety controls designed for real infrastructure.
Problem
UniFi networks are managed through several APIs: the local Network controller, Protect, and UniFi's cloud services. An agent that helps operate them needs one typed tool interface. The operator needs assurance that the agent cannot change a production network by accident.
What I built
I wrote and maintain a Python MCP server that exposes UniFi Network, UniFi Protect, and the UniFi cloud APIs as MCP tools. It runs against one controller. An optional fleet mode puts many controllers behind one server.
Capabilities
- Clients, VLANs, WiFi, DHCP and DNS, devices and topology export, zone-based firewall, VPN, Protect cameras and events, and backups.
- 343 tools in local mode as of v0.6.1. Tool profiles load one group at a time to keep an agent's context small.
- Agent skills (SKILL.md files) tell an AI agent which tools exist and how to use them safely.
- Distributed as a PyPI package and multi-architecture container images, with Ansible and Helm deployment paths.
Safety controls
- Every mutating tool requires confirm=True, and dry_run=True previews the change.
- Read-only and dry-run server modes remove or neutralize mutations.
- Role-based access over read, write, and destructive risk tiers.
- Mutations go to a hash-chained audit log, with optional SIEM export.
Community
The project grows through outside participation: code contributions, bug reports, and feature requests. Contribution guidelines, issue templates, and a CI gate (lint, type checks, security scans, and an 80% test-coverage floor) keep that work reviewable.
ActiveApache-2.0 license
- GitHub stars
- 290
- Forks
- 55
- Latest release
- v0.6.1 14 Oct 2026
Snapshot from GitHub, checked 15 Oct 2026. Stars measure interest, not production use.
Inspect the evidence
- Source and README (UniFi MCP Server)
- Tool reference (API.md) (UniFi MCP Server)
- Changelog (UniFi MCP Server)
- Security policy (UniFi MCP Server)
- PyPI package (UniFi MCP Server)