UniFi Gateway
MCP serverby pete-buildsSRC
Safe-by-default UniFi MCP: Network + Protect + Access, multi-site, dry-run, audit log.
SRC Publisher-stated: these are the publisher's own words, not an assessment.
Key facts
- Type
- MCP server · mcp-localSRC
- Publisher
- pete-builds · individualSRC
- Licence
- MITSRC
- Open source
- YesDER
- Hosting
- Local (runs on your machine)SRC
- Latest version
- 0.29.0SRC
- Languages
- pythonSRC
- First published
- SRC
- In this catalogue since
- DER
- Last verified
- Not verified by a researcher. Last seen in a source on 2026-11-21.
Capabilities and categories
Assigned by keyword rules from the description unless marked otherwise. The matched word is shown so you can judge the match.
| Capability | Evidence | Kind |
|---|---|---|
| Agent Governance | matched audit log | DER |
| Audit Trails | matched audit log | DER |
Filed underAgent InfrastructureAgent Security
Integrations DER
No third-party service is named in the description or package metadata.
Platform compatibility
No pairing has been tested by AgentSidekick. Each status says what kind of evidence exists, not whether it works for you.
Protocol-level29
Each platform listed officially documents support for MCP. This specific pairing has not been tested.
Platform discontinued1
| Platform | Basis |
|---|---|
| Roo CodeDiscontinued | Roo Code documented support for MCP but is discontinued. Project shut down and repository archived. |
Unknown17
| Platform | Basis |
|---|---|
| OpenClaw | Could not confirm whether OpenClaw supports MCP. |
| OpenHands | OpenHands documents MCP support, but it runs only on web, api, slack surfaces and this server runs locally as a process on your machine. Whether OpenHands can reach a local server is not established. |
| Aider | Could not confirm whether Aider supports MCP. |
| Bolt (bolt.new) | Bolt (bolt.new) documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Bolt (bolt.new) can reach a local server is not established. |
| Amazon Q DeveloperWinding down | Could not confirm whether Amazon Q Developer supports MCP. |
| Amazon Bedrock Agents (Agents Classic)Maintenance only | Could not confirm whether Amazon Bedrock Agents (Agents Classic) supports MCP. |
| GPTs (custom GPTs)Winding down | Could not confirm whether GPTs (custom GPTs) supports MCP. |
| Gemini (app) | Gemini (app) documents MCP support, but it runs only on web, mobile surfaces and this server runs locally as a process on your machine. Whether Gemini (app) can reach a local server is not established. |
| Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) | Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether Gemini Enterprise Agent Platform (formerly Vertex AI / Vertex AI Agent Builder) can reach a local server is not established. |
| GitHub Copilot ExtensionsDiscontinued | Could not confirm whether GitHub Copilot Extensions supports MCP. |
| Google AI Studio | Could not confirm whether Google AI Studio supports MCP. |
| JulesWinding down | Could not confirm whether Jules supports MCP. |
| Microsoft Copilot | Could not confirm whether Microsoft Copilot supports MCP. |
| Microsoft Copilot Studio | Microsoft Copilot Studio documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Microsoft Copilot Studio can reach a local server is not established. |
| Replit Agent | Replit Agent documents MCP support, but it runs only on web surfaces and this server runs locally as a process on your machine. Whether Replit Agent can reach a local server is not established. |
| Sourcegraph Cody | Could not confirm whether Sourcegraph Cody supports MCP. |
| v0 | v0 documents MCP support, but it runs only on web, api surfaces and this server runs locally as a process on your machine. Whether v0 can reach a local server is not established. |
Install
Read from registry metadata. Follow the publisher's instructions; we have not run this.
| Registry | Package | Transport | Runtime |
|---|---|---|---|
| oci | ghcr.io/pete-builds/mcp-unifi:0.29.0 | streamable-http | docker |
Environment variables SRC
| Name | Required | Secret | Publisher's description |
|---|---|---|---|
| STUB_MODE | No | No | When true, the server returns realistic mock data and requires no UniFi hardware. Defaults to true. Set to false to manage a real gateway, which then needs UNIFI_HOST plus UNIFI_API_KEY (or UNIFI_API_KEY_FILE), or MCP_UNIFI_CONTROLLERS_FILE. In either mode the HTTP transport will not start without MCP_UNIFI_AUTH_TOKENS. |
| MCP_UNIFI_AUTH_TOKENS | Yes | Secret | Bearer tokens that HTTP clients must present. Required: the streamable-http transport exits at startup with 'HTTP transport requires MCP_UNIFI_AUTH_TOKENS' when it is empty. Comma-separated; each entry is a bare token (named client-N automatically) or a 'name:token' pair. Generate one with `openssl rand -hex 32`. |
| MCP_UNIFI_READONLY | No | No | When true, every tool that changes state is hidden from tools/list and refused on tools/call; read tools are unaffected. Defense in depth on top of a read-only UniFi API key. Defaults to false. |
| UNIFI_HOST | No | No | IP address or hostname of the UniFi OS gateway (UCG-Fiber, UDM Pro, etc). Required when STUB_MODE=false and MCP_UNIFI_CONTROLLERS_FILE is unset. |
| UNIFI_API_KEY | No | Secret | Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and MCP_UNIFI_CONTROLLERS_FILE is unset, unless UNIFI_API_KEY_FILE is used instead. |
| UNIFI_API_KEY_FILE | No | No | Path to a file inside the container that holds the local API key, for a Docker or Kubernetes secret mount. Wins over UNIFI_API_KEY when both are set. A controller configured this way verifies the gateway's TLS certificate unless UNIFI_VERIFY_SSL is set to false. |
| UNIFI_PINNED_CERT | No | No | Path to a file inside the container that holds the gateway's own certificate in PEM, recorded with mcp-unifi-pin-cert. When set, that certificate is the only one the server accepts from the gateway, and a mismatch fails every request. Do not set UNIFI_VERIFY_SSL to false alongside it: the server refuses to start. |
| UNIFI_SITE | No | No | UniFi controller site name. Defaults to 'default'. |
| UNIFI_VERIFY_SSL | No | No | Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert. |
| MCP_UNIFI_CONTROLLERS_FILE | No | No | Path to a YAML file describing multiple named controllers for multi-site management. When set, the legacy UNIFI_HOST / UNIFI_API_KEY env vars are ignored. Each entry needs name, host, api_key, and optionally port, site, verify_ssl. |
| MCP_UNIFI_MODULES_ENABLED | No | No | Comma-separated list of modules to load. Known values: 'network', 'protect', 'access'. Defaults to 'network'. Set to 'network,protect,access' to enable Protect and Access tools alongside Network. Access currently ships read-only; door unlocks and credential issuance require session-token auth and are deferred. |
| UNIFI_ACCESS_HOST | No | No | UniFi Access hub IP or hostname. Required when the access module is enabled and STUB_MODE=false. Often the same host as UNIFI_HOST. |
| UNIFI_ACCESS_API_KEY | No | Secret | UniFi Access API key. Separate from the Network API key; generated on the Access controller's developer settings. Required when the access module is enabled and STUB_MODE=false. |
| UNIFI_ACCESS_PORT | No | No | HTTPS port for the Access hub. Defaults to 12445 (the direct Access app port). |
| MCP_UNIFI_AUDIT_SINK | No | No | Audit log sink. One of 'file' (default), 'stdout', or 'syslog'. Every tool call is recorded to a JSONL stream with secrets scrubbed. |
| MCP_UNIFI_AUDIT_PATH | No | No | Path for the audit log file when MCP_UNIFI_AUDIT_SINK=file. Defaults to audit.jsonl in the process CWD. |
Permissions and signals
Signals, not a safety verdict. They describe what the product's metadata references. Security review: not reviewed.
| Signal | Evidence | How observed | Observed |
|---|---|---|---|
| Asks for a secret | declares secret env var(s): MCP_UNIFI_AUTH_TOKENS, UNIFI_API_KEY, UNIFI_ACCESS_API_KEY | registry metadata | 2026-11-21 |
Known advisories for the published package SRC
An advisory existing does not mean the listed version is affected: compare the vulnerable range with the version you install. None found is not evidence of safety.
No advisories found
No published advisory matches a package this product declares. Products without a declared package cannot be matched at all. This is not evidence of safety.
Evaluation
Separate dimensions, each with its evidence. There is no overall score: the dimensions do not add up to one number honestly.
- Source authority
Publisher-submitted
Published to the official MCP Registry by the namespace owner. Field values are the publisher's own claims.
- Publisher verification
Namespace verified by registry
The MCP Registry verifies namespace ownership (GitHub login or DNS) before publishing. This confirms who published it, not what it does.
- Maintenance activity
Active
Last push 2026-11-20 (1 days before this page was built).
- Licence clarity
MIT
Licence identifier as reported by GitHub repository metadata.
- Installation clarity
Machine-readable
1 package(s) and 0 remote endpoint(s) declared in registry metadata.
- Documentation
Repository / website only
No dedicated documentation URL on record. AgentSidekick has not assessed documentation quality.
- Compatibility evidence
Protocol-level only
Compatibility is inferred from the standard it implements. No pairing has been tested.
- Security review
Not reviewed
AgentSidekick has not audited this product. 1 automated signal(s) are listed under Permissions & signals — they describe what it references, not whether it is safe.
Pricing
Not published in any source we track. The code is open source, which says nothing about the cost of any hosted service.
Repository activity
pete-builds/mcp-unifi. Read from the GitHub API on 2026-11-21.
Version history SRC
- 0.29.0
- 0.28.0
- 0.27.0
- 0.26.0
- 0.25.0
- 0.24.0
- 0.23.0
- 0.22.0
20 earlier versions
- 0.21.2
- 0.21.1
- 0.21.0
- 0.20.0
- 0.19.1
- 0.19.0
- 0.17.0
- 0.16.1
- 0.15.4
- 0.15.3
- 0.15.2
- 0.15.1
- 0.15.0
- 0.13.0
- 0.11.0
- 0.10.1
- 0.10.0
- 0.5.1
- 0.5.0
- 0.3.0
Change history
What changed between two ingests of the same source, and when the product was first seen. Registry releases are under Version history.
- First seen
Competitors and alternativesDER
Paired by shared capabilities and integrations. Similar on paper; not tested side by side.
Direct
Same type, overlapping capabilities.
MCP serverby callsign.imSRC
SharesAgent GovernanceAudit Trails
MCP serverby octorynSRC
SharesAgent GovernanceAudit Trails
MCP serverby tufantuncSRC
SharesAgent GovernanceAudit Trails
MCP serverby opencovenant.orgSRC
SharesAgent GovernanceAudit Trails
MCP serverby GodcreatebugsSRC
SharesAgent GovernanceAudit Trails
MCP serverby SaravananJaichandarSRC
SharesAgent GovernanceAudit Trails
Provenance
Which source set each field, what kind of claim it is, and when.
| Field | Source | Kind | Set on |
|---|---|---|---|
| Canonical URL | Official MCP Registry | SRC | 2026-11-21 |
| Publisher | Official MCP Registry | SRC | 2026-11-21 |
| Description | Official MCP Registry | SRC | 2026-11-21 |
| Hosting | Official MCP Registry | SRC | 2026-11-21 |
| Integration type | Official MCP Registry | SRC | 2026-11-21 |
| Languages | GitHub repository metadata | SRC | 2026-11-21 |
| Latest version | Official MCP Registry | SRC | 2026-11-21 |
| Licence | GitHub repository metadata | SRC | 2026-11-21 |
| Name | Official MCP Registry | SRC | 2026-11-21 |
| Open source | GitHub repository metadata | DER | 2026-11-21 |
| Type | Official MCP Registry | SRC | 2026-11-21 |
| Published | Official MCP Registry | SRC | 2026-11-21 |
| Repository | Official MCP Registry | SRC | 2026-11-21 |
| source_updated_at | Official MCP Registry | SRC | 2026-11-21 |
| Source URL | Official MCP Registry | SRC | 2026-11-21 |
| Website | Official MCP Registry | SRC | 2026-11-21 |
Sources
- Official MCP Registry: registry.modelcontextprotocol.io (external)checked
Not verified by a researcher. Last seen in a source on . Report incorrect information