How to Use the Matomo Alternative MCP in Windsurf

Q: How does Matomo Alternative handle bulk tracking runs in Windsurf?

The server exposes the trackbulk tool. Cascade calls this to batch multiple tracking requests during your local Windsurf test runs.

Q: Can Cascade generate visual charts from my analytics using this MCP?

Yes, it uses the getimagegraph tool to fetch static PNG graphs of your traffic. Cascade then saves these images directly into your Windsurf project's assets directory.

Get raw analytics data and track visitor actions directly inside Windsurf using Cascade's multi-step planning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Matomo Alternative MCP to Windsurf

Create your Vinkius account to connect Matomo Alternative 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 Matomo Alternative with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-generate analytics dashboards in Windsurf

Cascade can read your workspace files, plan a dashboard layout, and fetch real-time metrics using `get_visits_summary`. Without asking for permission at every step, the agent builds your files directly using those returned `nb_visits` and `bounce_count` values. You get raw traffic metrics written straight to your local code. If you need visual proof for a client, Cascade calls `get_image_graph` to pull a PNG chart from your Matomo Alternative instance.

Multi-step tracking validation via Windsurf MCP Server

Testing tracking code in Windsurf is usually a chore. With this server, Cascade can write your tracking script, trigger `track_action` to simulate a page view, and immediately check if the event registered. For high-traffic setups, Cascade switches to `track_bulk` to test batch event ingestion. You get a working tracking implementation without manual browser testing or raw terminal curl commands.

Deep analytics inspection without leaving Cascade

Stop leaving your Windsurf editor to check web traffic. This MCP server lets Cascade use `get_processed_report` to pull detailed visitor metrics and parse them directly inside your open file context. If you run a WordPress setup, Cascade calls `get_wp_processed_report` to query your site directly. The agent reads the report metadata with `get_report_metadata` to find exactly which metrics are available for your custom queries.

Setup guide

Set up Matomo Alternative 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 Matomo Alternative 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 Matomo Alternative payment history." If connected, Cascade will call the Matomo Alternative tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "matomo-alternative-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 Matomo. 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 Matomo Alternative 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 Matomo Alternative MCP in Windsurf

Cascade connects directly to this server to run multi-tool sequences using `get_visits_summary` and `track_action`. It can pull metrics, generate visual charts, and write analytics components in your workspace without needing manual step-by-step prompts.

Yes, you can test your tracking setup directly in the Windsurf IDE. Cascade uses `track_action` to send test page views and verifies the response in real time.

The server exposes the `track_bulk` tool. Cascade calls this to batch multiple tracking requests during your local Windsurf test runs.

Yes, it uses the `get_image_graph` tool to fetch static PNG graphs of your traffic. Cascade then saves these images directly into your Windsurf project's assets directory.

All visitor IPs, page views, and custom event payloads pass directly from Windsurf to your self-hosted analytics endpoint. Vinkius runs the server in an isolated sandbox, meaning your raw database credentials and visitor metrics are never stored or logged on our infrastructure.

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