
Go Unifi Mcp
Connects to your UniFi Network Controller to manage sites, devices, clients, networks, port forwarding, DNS, and firewall rules through the Model Context Protocol. Built on the go-unifi library with API surface generated directly from the controller's definitions, so it keeps pace as UniFi evolves. Ships with two modes: lazy mode registers three meta-tools that dispatch to 242 operations on demand, keeping context usage under 200 tokens, while eager mode registers all tools upfront. Supports both v1 and v2 firewall rules plus IPv6. Automatically resolves opaque IDs to human-readable names in responses. Reach for this when you need programmatic access to UniFi infrastructure through an AI assistant or MCP client.
- GitHub stars
- 6
- tools
- 3
- transport
- STDIO
- last updated
- Jul 24, 2026
Tools
3 toolsPublic tool metadata for what this MCP can expose to an agent.
tool_indexSearch/filter the tool catalog by category or resource
Search/filter the tool catalog by category or resource
No parameter schema in public metadata yet.
executeExecute any tool by name with arguments
Execute any tool by name with arguments
No parameter schema in public metadata yet.
batchExecute multiple tools in parallel
Execute multiple tools in parallel
No parameter schema in public metadata yet.
Sponsors
Readme
go-unifi-mcp
A Model Context Protocol (MCP) server for UniFi Network Controller, written in Go.
Overview
go-unifi-mcp provides an MCP interface to UniFi Network Controller, enabling
AI assistants and other MCP clients to interact with your UniFi infrastructure.
Why this exists
I couldn’t find an MCP server that supported both v1 and v2 firewall rules and IPv6, so I built one. This wraps the go-unifi library (which I trust from my Terraform provider experience) and leans on its generated API surface. The server is generated from the controller’s own API definitions, which makes it much easier to keep tool coverage up to date as UniFi evolves.
UniFi controller versioning
This project generates tools against the same UniFi Controller version pinned by go-unifi. When go-unifi updates its supported controller version, we regenerate our field definitions and tool metadata to match. We support the same controller range; see their controller support range.
Installation
Binary (GitHub Releases)
Details
- Repository
- github.com/claytono/go-unifi-mcp
- Category
- Security & Pentesting
- Package
ghcr.io/claytono/go-unifi-mcp:v0.3.1- Transport
- STDIO
- Registry
- MCP registry, active