UniFi MCP Server v1.0.0
Full UniFi network management via Model Context Protocol — 19 tools with self-healing authentication and automated TOTP.
Highlights
- Single-step auth — POST username + password + TOTP in one request, automated via seed
- Self-healing sessions — auto-refreshes expired cookies, no manual re-auth
- AES-256-GCM token encryption — session tokens encrypted at rest
- Bandwidth auditing — per-port egress limits, traffic rules, client history
- Port profile management — create, update, delete, assign profiles to switch ports
- Firewall policies — read firewall rules and traffic routes
- Device management — list devices, ports, clients with full detail
Tools
| Category | Tools |
|---|---|
| Auth | auth-status |
| Devices | device-list, device-detail, device-ports |
| Clients | client-list, client-detail, client-history |
| Networks | network-list, network-detail |
| Port Profiles | port-profiles, port-profile-detail, port-profile-create, port-profile-update, port-profile-delete, port-set-profile |
| Firewall | firewall-policies, traffic-routes |
| Bandwidth | bandwidth-audit |
| API | unifi-api (escape hatch) |
Automation Scripts
scripts/webhook-push.ts— monthly bandwidth audit → Make.com webhookscripts/initial-auth.ts— interactive first-time authenticationscripts/create-scheduled-task.ps1— Windows Task Scheduler setup
Built by Element Zero