How to Use the Umami Cloud MCP in Windsurf

Q: What data types does Umami Cloud provide for Windsurf?

The server tracks active user counts via users. For deeper dives, the websites tool gives you specific metrics like URLs, browser versions, OS details, and device type.

Get deep website insights automatically with Windsurf: Metrics when you need them.

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 Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Windsurf and the Umami Cloud MCP Server

The `users` tool tells you exactly how many people are actively using your site. Cascade uses this number to contextualize other data points, giving you a real-time pulse on traffic volume. Knowing the active user count helps you figure out if recent changes drove an increase or dip in engagement.

Analyzing Site Traffic with Windsurf

You can run `websites` to pull granular metrics for any specific URL. This data shows which operating systems and devices are driving traffic, helping you pinpoint platform-specific issues. It also records browser types and device details, letting you compare performance across Chrome versus Safari or iOS against Android.

Umami Cloud MCP Server for Quick Insights

Since it's a privacy-focused analytics alternative, Umami Cloud gives you web metrics without the usual data overhead. You get clean numbers on your user base and site performance. This approach means less setup and fewer compliance headaches when monitoring traffic patterns.

Setup guide

Set up Umami Cloud MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Umami Cloud payment history." If connected, Cascade will call the Umami Cloud tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.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 Windsurf

Just add the MCP Server endpoint in your settings. Once connected, Cascade automatically discovers both the `users` and `websites` tools. You can then set a goal, like 'check mobile usage,' and it handles the rest.

The server tracks active user counts via `users`. For deeper dives, the `websites` tool gives you specific metrics like URLs, browser versions, OS details, and device type.

While designed primarily for IDE usage, its context-aware nature makes it great for validating data integrity across deployments. Cascade can check if expected user counts are maintained after a build.

Yeah, it is. Umami Cloud was built as an alternative to services like Google Analytics because of privacy concerns. It handles web metrics in a way that respects user anonymity.

You'll get detailed records on device types, operating systems, specific URLs hit, and the browsers used. This granularity helps you build a complete picture of your audience.

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