{
  "slug": "io-github-pete-builds-unifi",
  "name": "io.github.pete-builds/unifi",
  "title": "UniFi Gateway",
  "description": "Safe-by-default UniFi MCP: Network + Protect + Access, multi-site, dry-run, audit log.",
  "version": "0.27.0",
  "publishedAt": "2026-10-21T03:25:46.707326Z",
  "updatedAt": "2026-10-21T03:25:46.707326Z",
  "repoUrl": "https://github.com/pete-builds/mcp-unifi",
  "websiteUrl": "https://pete-builds.github.io/mcp-unifi/",
  "namespace": {
    "type": "github",
    "owner": "pete-builds"
  },
  "kind": "local",
  "packages": [
    {
      "registryType": "oci",
      "identifier": "ghcr.io/pete-builds/mcp-unifi:0.27.0",
      "version": null,
      "transport": "streamable-http",
      "runtimeHint": "docker"
    }
  ],
  "remotes": [],
  "envVars": [
    {
      "name": "STUB_MODE",
      "isSecret": false,
      "isRequired": false,
      "description": "When true, the server returns realistic mock data and requires no UniFi hardware. Defaults to true so the image is functional out of the box."
    },
    {
      "name": "UNIFI_HOST",
      "isSecret": false,
      "isRequired": false,
      "description": "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."
    },
    {
      "name": "UNIFI_API_KEY",
      "isSecret": true,
      "isRequired": false,
      "description": "Local API key generated under Settings -> Control Plane -> Integrations on the gateway. Required when STUB_MODE=false and MCP_UNIFI_CONTROLLERS_FILE is unset."
    },
    {
      "name": "UNIFI_SITE",
      "isSecret": false,
      "isRequired": false,
      "description": "UniFi controller site name. Defaults to 'default'."
    },
    {
      "name": "UNIFI_VERIFY_SSL",
      "isSecret": false,
      "isRequired": false,
      "description": "Whether to verify the gateway's TLS certificate. Defaults to false because most home gateways use a self-signed cert."
    },
    {
      "name": "MCP_UNIFI_CONTROLLERS_FILE",
      "isSecret": false,
      "isRequired": false,
      "description": "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."
    },
    {
      "name": "MCP_UNIFI_MODULES_ENABLED",
      "isSecret": false,
      "isRequired": false,
      "description": "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."
    },
    {
      "name": "UNIFI_ACCESS_HOST",
      "isSecret": false,
      "isRequired": false,
      "description": "UniFi Access hub IP or hostname. Required when the access module is enabled and STUB_MODE=false. Often the same host as UNIFI_HOST."
    },
    {
      "name": "UNIFI_ACCESS_API_KEY",
      "isSecret": true,
      "isRequired": false,
      "description": "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."
    },
    {
      "name": "UNIFI_ACCESS_PORT",
      "isSecret": false,
      "isRequired": false,
      "description": "HTTPS port for the Access hub. Defaults to 12445 (the direct Access app port)."
    },
    {
      "name": "MCP_UNIFI_AUDIT_SINK",
      "isSecret": false,
      "isRequired": false,
      "description": "Audit log sink. One of 'file' (default), 'stdout', or 'syslog'. Every tool call is recorded to a JSONL stream with secrets scrubbed."
    },
    {
      "name": "MCP_UNIFI_AUDIT_PATH",
      "isSecret": false,
      "isRequired": false,
      "description": "Path for the audit log file when MCP_UNIFI_AUDIT_SINK=file. Defaults to audit.jsonl in the process CWD."
    }
  ],
  "category": "monitoring",
  "subcategory": "observability",
  "company": "",
  "categoryAuto": true,
  "checks": [
    {
      "id": "source-linked",
      "label": "Source repository linked",
      "result": "pass",
      "detail": "https://github.com/pete-builds/mcp-unifi"
    },
    {
      "id": "version-pinned",
      "label": "Version pinned",
      "result": "pass",
      "detail": "Every package has an explicit version"
    },
    {
      "id": "secrets-requested",
      "label": "Secrets requested",
      "result": "info",
      "detail": "Asks for 2 secrets: UNIFI_API_KEY, UNIFI_ACCESS_API_KEY"
    },
    {
      "id": "known-registry",
      "label": "Known package registry",
      "result": "pass",
      "detail": "All packages come from npm, PyPI, OCI, NuGet or MCPB"
    },
    {
      "id": "namespace",
      "label": "Namespace ownership",
      "result": "info",
      "detail": "Name verified via GitHub account pete-builds"
    },
    {
      "id": "meta-text",
      "label": "Registry text aimed at the AI",
      "result": "pass",
      "detail": "Description and settings contain no hidden characters or instructions to the AI"
    },
    {
      "id": "code-flags",
      "label": "Code red flags",
      "result": "info",
      "detail": "oci packages are not read yet"
    }
  ],
  "scannedAt": "2026-10-29",
  "level": "Scanned",
  "install": [
    {
      "label": "Claude Desktop (oci)",
      "kind": "claude_desktop_json",
      "text": "{\n  \"mcpServers\": {\n    \"unifi\": {\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\",\n        \"-i\",\n        \"--rm\",\n        \"ghcr.io/pete-builds/mcp-unifi:0.27.0\"\n      ]\n    }\n  }\n}"
    }
  ],
  "curated": true,
  "stars": 27,
  "archived": false,
  "pushedAt": "2026-10-27T19:29:35Z",
  "health": {
    "score": 59,
    "parts": {
      "popularity": 0.17171628643042014,
      "activity": 1,
      "issues": null,
      "security": 1
    },
    "fail": 0,
    "warn": 0,
    "raw": {
      "stars": 29,
      "forks": 7,
      "downloads": null,
      "hn": {
        "n": 0,
        "pts": 0,
        "t": []
      },
      "issuesOpen": 0,
      "issuesClosed": 4,
      "prsMerged": 176,
      "commits90": 175,
      "release": "2026-10-21T03:26:41Z",
      "pushed": "2026-10-27T19:29:35Z",
      "growth": null,
      "growthDays": null,
      "archived": false
    },
    "at": "2026-10-31T07:42:38.200Z"
  }
}