v1.0.0 — Initial Release

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 webhook
• scripts/initial-auth.ts — interactive first-time authentication
• scripts/create-scheduled-task.ps1 — Windows Task Scheduler setup

Built by Element Zero