UniFi Site Manager and Network (unof… MCP Setup & Guide

{
  "id": "io.github.mguttmann/the-real-unifi-mcp",
  "type": "mcp-server",
  "version": "0.4.0",
  "displayName": "UniFi Site Manager and Network (unofficial)",
  "description": "Unofficial MCP server for the UniFi Site Manager and Network cloud APIs, with a write-confirm guard.",
  "repository": {
    "url": "https://github.com/mguttmann/the-real-unifi-mcp",
    "source": "github"
  },
  "homepage": "https://github.com/mguttmann/the-real-unifi-mcp#readme",
  "distribution": {
    "packages": [
      {
        "registryType": "npm",
        "identifier": "the-real-unifi-mcp",
        "version": "0.4.0",
        "runtimeHint": "npx",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "UNIFI_API_KEY",
            "description": "UniFi Site Manager API key with Network scope (unifi.ui.com, Settings > API). It controls your whole network: treat it like an admin password.",
            "isRequired": true,
            "isSecret": true
          },
          {
            "name": "UNIFI_CONFIRM_WRITES",
            "description": "Write confirmation: destructive tools return a preview and run only when called again with confirm \"YES\". Only false, 0, no or off turn it off."
          },
          {
            "name": "UNIFI_API_BASE",
            "description": "API base URL; this host receives the API key. https origin only (http only for loopback test stubs). Keep the default."
          },
          {
            "name": "UNIFI_TIMEOUT_MS",
            "description": "Per-request timeout in milliseconds, covering response headers and body."
          },
          {
            "name": "UNIFI_LOG_LEVEL",
            "description": "Log level on stderr: debug, info, warn or error."
          },
          {
            "name": "UNIFI_CONSOLE_ID",
            "description": "Pins the UniFi console instead of discovering it (needed when the account has several consoles)."
          },
          {
            "name": "UNIFI_NETWORK_SITE_ID",
            "description": "Pins the Network site instead of discovering it."
          },
          {
            "name": "UNIFI_SITE_MANAGER_SITE_ID",
            "description": "Pins the Site Manager site instead of discovering it."
          },
          {
            "name": "UNIFI_READ_ONLY",
            "description": "Read-only mode: every write tool returns an error and sends no request; reads still work. Off by default."
          },
          {
            "name": "UNIFI_REDACT_SECRETS",
            "description": "Masks passwords, WiFi passphrases, pre-shared keys and other secret fields in every tool result with (redacted); write tools refuse a body that contains that placeholder. Off by default."
          },
          {
            "name": "UNIFI_MAX_RESULT_BYTES",
            "description": "Cuts tool results longer than this many bytes and marks them as truncated. Unset or empty: 100000. 0, off or none: no cap."
          }
        ]
      },
      {
        "registryType": "mcpb",
        "identifier": "https://github.com/mguttmann/the-real-unifi-mcp/releases/download/v0.4.0/the-real-unifi-mcp-0.4.0.mcpb",
        "version": "0.4.0",
        "transport": "stdio"
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.mguttmann/the-real-unifi-mcp",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.mguttmann%2Fthe-real-unifi-mcp/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}