Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "umami-compass": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "UMAMI_API_KEY": "${UMAMI_API_KEY}",
        "UMAMI_ACCESS_TOKEN": "${UMAMI_ACCESS_TOKEN}",
        "UMAMI_PASSWORD": "${UMAMI_PASSWORD}",
        "UMAMI_TOOLSETS": "core,insights",
        "UMAMI_MAX_RESPONSE_BYTES": "10485760"
      }
    }
  }
}

claude mcp add umami-compass -e "UMAMI_API_KEY=${UMAMI_API_KEY}" -e "UMAMI_ACCESS_TOKEN=${UMAMI_ACCESS_TOKEN}" -e "UMAMI_PASSWORD=${UMAMI_PASSWORD}" -e "UMAMI_TOOLSETS=core,insights" -e "UMAMI_MAX_RESPONSE_BYTES=10485760" -- npx -y [email protected]

[mcp_servers.umami-compass]
command = "npx"
args = ["-y", "[email protected]"]
env = { "UMAMI_API_KEY" = "${UMAMI_API_KEY}", "UMAMI_ACCESS_TOKEN" = "${UMAMI_ACCESS_TOKEN}", "UMAMI_PASSWORD" = "${UMAMI_PASSWORD}", "UMAMI_TOOLSETS" = "core,insights", "UMAMI_MAX_RESPONSE_BYTES" = "10485760" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "umami-compass": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "[email protected]"
      ],
      "enabled": true,
      "environment": {
        "UMAMI_API_KEY": "{env:UMAMI_API_KEY}",
        "UMAMI_ACCESS_TOKEN": "{env:UMAMI_ACCESS_TOKEN}",
        "UMAMI_PASSWORD": "{env:UMAMI_PASSWORD}",
        "UMAMI_TOOLSETS": "core,insights",
        "UMAMI_MAX_RESPONSE_BYTES": "10485760"
      }
    }
  }
}

{
  "mcpServers": {
    "umami-compass": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "UMAMI_API_KEY": "${UMAMI_API_KEY}",
        "UMAMI_ACCESS_TOKEN": "${UMAMI_ACCESS_TOKEN}",
        "UMAMI_PASSWORD": "${UMAMI_PASSWORD}",
        "UMAMI_TOOLSETS": "core,insights",
        "UMAMI_MAX_RESPONSE_BYTES": "10485760"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=umami-compass&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInVtYW1pLWNvbXBhc3NAMC41LjEiXSwiZW52Ijp7IlVNQU1JX0FQSV9LRVkiOiIke1VNQU1JX0FQSV9LRVl9IiwiVU1BTUlfQUNDRVNTX1RPS0VOIjoiJHtVTUFNSV9BQ0NFU1NfVE9LRU59IiwiVU1BTUlfUEFTU1dPUkQiOiIke1VNQU1JX1BBU1NXT1JEfSIsIlVNQU1JX1RPT0xTRVRTIjoiY29yZSxpbnNpZ2h0cyIsIlVNQU1JX01BWF9SRVNQT05TRV9CWVRFUyI6IjEwNDg1NzYwIn19"
}

{
  "servers": {
    "umami-compass": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "UMAMI_API_KEY": "${UMAMI_API_KEY}",
        "UMAMI_ACCESS_TOKEN": "${UMAMI_ACCESS_TOKEN}",
        "UMAMI_PASSWORD": "${UMAMI_PASSWORD}",
        "UMAMI_TOOLSETS": "core,insights",
        "UMAMI_MAX_RESPONSE_BYTES": "10485760"
      }
    }
  }
}

{
  "mcpServers": {
    "umami-compass": {
      "command": "npx",
      "args": [
        "-y",
        "[email protected]"
      ],
      "env": {
        "UMAMI_API_KEY": "${UMAMI_API_KEY}",
        "UMAMI_ACCESS_TOKEN": "${UMAMI_ACCESS_TOKEN}",
        "UMAMI_PASSWORD": "${UMAMI_PASSWORD}",
        "UMAMI_TOOLSETS": "core,insights",
        "UMAMI_MAX_RESPONSE_BYTES": "10485760"
      }
    }
  }
}

extensions:
  "umami-compass":
    enabled: true
    name: "umami-compass"
    type: stdio
    cmd: "npx"
    args:
      - "-y"
      - "[email protected]"
    envs:
      "UMAMI_API_KEY": "${UMAMI_API_KEY}"
      "UMAMI_ACCESS_TOKEN": "${UMAMI_ACCESS_TOKEN}"
      "UMAMI_PASSWORD": "${UMAMI_PASSWORD}"
      "UMAMI_TOOLSETS": "core,insights"
      "UMAMI_MAX_RESPONSE_BYTES": "10485760"
    timeout: 300

Placeholders to fill from your own secret store: ${UMAMI_API_KEY}, ${UMAMI_ACCESS_TOKEN}, ${UMAMI_PASSWORD}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies67 · weight 15

pass
deps.known_vulnsno known advisory in 98 resolved packages
fail
deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
pass
deps.resolvable[email protected] resolved: 98 packages

Tool list unknown · checked 2026-10-20 09:31 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance90

livenessn/a

freshness65

hygiene100

+repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-91d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm97 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-19

advisory	severity	package	fixed in
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server	high	`@modelcontextprotocol/[email protected]`MCP SDK, direct	fixed in `1.31.0`

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`umami-compass`	npm	0.5.1	npx	`UMAMI_API_KEY`, `UMAMI_ACCESS_TOKEN`, `UMAMI_PASSWORD`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.webcredo/umami-compass",
  "title": "Umami Compass",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.5.1",
  "packages": [
    {
      "version": "0.5.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "umami-compass",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "UMAMI_API_KEY",
          "isSecret": true,
          "description": "Umami Cloud or client API key"
        },
        {
          "name": "UMAMI_ACCESS_TOKEN",
          "isSecret": true,
          "description": "Existing self-hosted Bearer token"
        },
        {
          "name": "UMAMI_USERNAME",
          "description": "Self-hosted Umami username"
        },
        {
          "name": "UMAMI_PASSWORD",
          "isSecret": true,
          "description": "Self-hosted Umami password"
        },
        {
          "name": "UMAMI_URL",
          "description": "Self-hosted Umami instance origin",
          "placeholder": "https://analytics.example.com"
        },
        {
          "name": "UMAMI_API_URL",
          "description": "Optional exact Umami API root for a reverse proxy",
          "placeholder": "https://analytics.example.com/custom/api"
        },
        {
          "name": "UMAMI_WEBSITE_IDS",
          "description": "Optional comma-separated website UUID allowlist"
        },
        {
          "name": "UMAMI_TEAM_IDS",
          "description": "Optional comma-separated team UUID allowlist"
        },
        {
          "name": "UMAMI_TOOLSETS",
          "default": "core,insights",
          "description": "Comma-separated toolsets or all",
          "placeholder": "core,insights,events,sessions,performance,reports,revenue,replay,heatmaps"
        },
        {
          "name": "UMAMI_MAX_RESPONSE_BYTES",
          "default": "10485760",
          "description": "Maximum decoded upstream JSON response size in bytes"
        }
      ]
    }
  ],
  "repository": {
    "id": "1298894734",
    "url": "https://github.com/webcredo/umami-compass",
    "source": "github"
  },
  "websiteUrl": "https://github.com/webcredo/umami-compass",
  "description": "Secure Umami Analytics MCP server for Cloud and self-hosted deployments"
}