How to Use the Umami Cloud MCP in Cursor

Q: Is this suitable for a team project?

Yes. Since you define the server in .cursor/mcp.json, the entire team benefits from the same access point. The agent mode ensures consistency when pulling live data into codebases.

Inject live Umami Cloud web metrics directly into your code with Cursor.

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 Cursor

Create your Vinkius account to connect Umami Cloud to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate user counts using the MCP Server.

Need to validate a function that calculates active users? The AI can call the `users` tool and inject the live count directly into your Python or JavaScript code. You get working context, not mock stubs. The resulting code snippet uses the real API response from Umami Cloud's MCP Server. This means you're testing against actual data, which is a huge time saver when building services around analytics.

Pull device metrics with Umami Cloud.

Building a client-side feature that needs to account for OS differences? The `websites` tool delivers detailed context: browser, OS, and device type. You can write code that dynamically handles these variables. The AI will generate the necessary API calls using the live data from Umami Cloud. This means your code is immediately ready for integration because it's built around real-world traffic metrics.

Integrate analytics via Cursor’s MCP Server.

To use this server, you add the definition to `.cursor/mcp.json` in your project root or globally. Once set up, enabling Agent mode lets the AI see the tool definitions. The agent then uses these tools to gather data and write code that incorporates that live context. It's a tight loop: coding, calling tools, getting real data, writing more code.

Setup guide

Set up Umami Cloud MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Umami Cloud MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Umami Cloud transactions." If the MCP tools are loaded correctly, Cursor will call the Umami Cloud tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "umami-cloud-mcp": {
      "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 Cursor

Cursor’s Agent mode detects the available MCP Server and uses it when you prompt for code that requires external data. It calls tools like `websites` and injects the resulting JSON into your editor, letting you continue coding immediately.

Umami Cloud is a privacy-focused analytics provider. The server gives you metrics on active users via `users`, and detailed technical breakdowns (URL, OS, browser) through the `websites` tool.

This MCP Server interacts with web analytics data. Specifically, it handles information about website traffic, including active user counts, and detailed metrics like URLs, browsers, operating systems (OS), and devices.

Yes. Since you define the server in `.cursor/mcp.json`, the entire team benefits from the same access point. The agent mode ensures consistency when pulling live data into codebases.

No, that's the whole point. When using this MCP Server with Cursor, the AI generates working code that relies on real API responses from Umami Cloud, eliminating the need for stubs or dummy data.

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