How to Use the Umami Cloud MCP in Claude Code

Q: How do I run Umami Cloud with Claude Code?

You use the claude mcp add command to register it. Once registered, you can call the tools directly from your shell script using standard API invocation patterns.

Q: What metrics does Umami Cloud provide for Claude Code?

The server exposes two main functions: users for active user counts, and websites for deep details including URLs, OS, browsers, and device types. This covers everything you need to automate reporting.

Q: What kind of website data can I get with Umami Cloud and Claude Code?

The websites tool lets you automate checks on device types, operating systems, specific URLs hit, and browser usage. This is ideal for validating multi-platform site health.

Run Umami Cloud metrics in CI/CD pipelines with Claude Code: Headless analytics for automation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Umami Cloud MCP to Claude Code

Create your Vinkius account to connect Umami Cloud to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Umami Cloud with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

MCP Server for Automated User Checks

You can run a simple script that executes the `users` tool. This lets your pipeline verify if active user counts meet minimum thresholds before deployment. It's perfect for cron jobs; just pipe the result into a status check to fail the build if metrics drop off.

Getting Website Metrics with Claude Code

The `websites` tool provides detailed data like browser, OS, and device type. You can use this in a headless script to generate reports or checksums for compliance checks. Running these metrics pulls information on URLs accessed, making it useful for validating content coverage across deployments.

Umami Cloud MCP Server Reliability

Connecting Umami Cloud via HTTP allows you to treat web analytics as just another service endpoint. You run the tool like any other API call in a shell script. Since it's privacy-focused, this means your CI/CD environment isn't dealing with sensitive data structures that require intense masking.

Setup guide

Set up Umami Cloud MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see umami-cloud-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Umami Cloud transactions." It will automatically discover and invoke the available Umami Cloud tools.

Terminal

claude mcp add --transport http umami-cloud-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Umami Cloud MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "umami-cloud-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Umami Cloud. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Umami Cloud now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Umami Cloud MCP in Claude Code

You use the `claude mcp add` command to register it. Once registered, you can call the tools directly from your shell script using standard API invocation patterns.

The server exposes two main functions: `users` for active user counts, and `websites` for deep details including URLs, OS, browsers, and device types. This covers everything you need to automate reporting.

Yes. Because Umami Cloud is a privacy-focused alternative, it handles web metrics without the usual data complexity or exposure found in other large analytics platforms.

The `websites` tool lets you automate checks on device types, operating systems, specific URLs hit, and browser usage. This is ideal for validating multi-platform site health.

The server handles web metrics by focusing on anonymity, giving you the raw data (URLs, browsers, os, devices) necessary for your checks without unnecessary PII exposure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript