Safe-by-default UniFi MCP: Network + Protect, multi-site, dry-run, audit log.
{
"STUB_MODE": "true",
"UNIFI_HOST": "YOUR_VALUE_HERE",
"UNIFI_API_KEY": "YOUR_SECRET_VALUE",
"UNIFI_SITE": "default",
"UNIFI_VERIFY_SSL": "false",
"MCP_UNIFI_CONTROLLERS_FILE": "YOUR_VALUE_HERE",
"MCP_UNIFI_MODULES_ENABLED": "network",
"MCP_UNIFI_AUDIT_SINK": "file",
"MCP_UNIFI_AUDIT_PATH": "audit.jsonl"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-pete-builds-unifi": {
"url": "https://io-github-pete-builds-unifi.example.com"
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
UniFi Gateway is an MCP server for Safe-by-default UniFi MCP: Network + Protect, multi-site, dry-run, audit log.. It supports HTTP transport.
Use the client-specific config in Install and add it to your MCP-compatible client.
Choose the Claude Desktop tab in Install and copy the config into Claude Desktop's MCP server settings.
Choose the Claude Code tab in Install and copy the config into Claude Code's MCP server settings.
Choose the Codex tab in Install and copy the config into Codex's MCP server settings.
Choose the Cursor or VS Code tab in Install and copy the config into Cursor or VS Code's MCP server settings.
UniFi Gateway uses HTTP transport. Use the package or command config in Install.
UniFi Gateway inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
UniFi Gateway does not advertise a verified auth requirement. If discovery fails, it may still need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
ghcr.io/pete-builds/mcp-unifi:0.5.1streamable-http | oci | Not captured | Env: STUB_MODE Env: UNIFI_HOST Env: UNIFI_API_KEY secret Env: UNIFI_SITE Env: UNIFI_VERIFY_SSL Env: MCP_UNIFI_CONTROLLERS_FILE Env: MCP_UNIFI_MODULES_ENABLED Env: MCP_UNIFI_AUDIT_SINK Env: MCP_UNIFI_AUDIT_PATH |