How to Use the Keen MCP in Windsurf

Connect Windsurf to your Keen event streams and let Cascade chain analytics queries without asking for permission.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Keen MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Cascade runs Keen MCP Server queries

Your agent does not just pull raw logs. Tell Windsurf you need to understand user behavior, and Cascade immediately fires off `count_events` and `average_property` to get the actual numbers. It reads the context of your current file and decides which metrics matter. The real advantage is the autonomous chaining. Cascade might run `select_unique` to find specific user IDs, then instantly run `sum_property` on those exact results. It figures out the sequence, executes the tools, and hands you the final calculation without waiting for another prompt.

Push events straight from your editor

Testing tracking code usually means writing a script, running it, and then switching to a browser to see if the data arrived. Now you just ask Cascade to simulate traffic. It uses `record_event` to push JSON payloads directly into your project. Once the event fires, Cascade verifies its own work. It polls the collection using `count_unique` to prove the test data actually registered. You get instant confirmation that your instrumentation works before you ever commit the code.

Map your entire event schema

Before writing any dashboard code, Windsurf needs to know what data exists. Cascade runs `list_collections` and `get_project_details` to map out your available event streams. It understands the shape of your data without needing a manual explanation. If you already have complex queries built, the agent finds them. It uses `list_datasets` and `list_saved_queries` to pull in your cached reports. This means Cascade writes frontend code that actually matches your backend analytics structure.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "keen-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 Keen. 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 Keen 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 Keen MCP in Windsurf

Open Settings, go to Cascade, and find the MCP Servers UI. You can also edit `~/.codeium/windsurf/mcp_config.json` directly to add the server credentials.

Yes. Cascade will run a tool to find your property values, then instantly execute a second query on those results without asking you for the next step.

Your agent fires off a test payload using the record tool. Then it automatically polls the collection to confirm the data actually arrived in your project.

It does. You can grab it right from the marketplace tab for a one-click install, and Cascade auto-discovers all ten tools immediately.

The server only touches the specific event analytics data and custom properties you query. Windsurf routes these requests through your local machine, meaning raw event payloads never sit on an external proxy.

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