How to Use the Kissmetrics MCP in Windsurf

Q: How do I configure Kissmetrics with Windsurf?

Open your mcpconfig.json file in /.codeium/windsurf/ and add the server details. You can also use the Settings -> Cascade -> MCP Servers UI to connect it. Hit refresh in the panel and Cascade will discover the tools immediately.

Q: Can Windsurf write custom Kissmetrics tracking code?

Yes. Cascade reads your existing schema via listeventtypes and writes the exact implementation for your app. It checks the live data to prevent duplicate event names.

Q: Why use the Kissmetrics MCP server inside Windsurf instead of the dashboard?

You avoid context switching. Cascade pulls querymetricdata straight into your editor while you write code. It lets you verify that your new tracking implementation actually works before you commit.

Give Cascade direct access to your Kissmetrics event data right inside Windsurf via this MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kissmetrics MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map user journeys with the Kissmetrics MCP Server

The `alias_identities` tool lets Cascade link anonymous browser sessions to authenticated user emails automatically. You just tell Windsurf to reconcile the latest login events, and the agent handles the API calls. It figures out the mapping logic without you writing a custom script. Once the identities match up, Cascade can trigger `record_event` to log the successful merge. Your agent builds the entire sequence in the background. You get clean funnel data without leaving the editor.

Audit tracking schemas autonomously

Calling `list_event_types` gives your AI client an instant readout of every behavior you currently track. Cascade reads this schema, spots missing telemetry in your codebase, and proposes the exact tracking calls you need. It knows what events already exist before writing new code. The agent follows up by checking `list_property_names` to ensure the new calls use standardized payload keys. Instead of guessing if a property is named `user_id` or `userId`, Windsurf pulls the source truth. Your event taxonomy stays perfectly aligned.

Pull live funnel metrics into your workspace

Executing `query_metric_data` pulls historical conversion numbers directly into your Windsurf terminal. Cascade takes a metric ID, formats the query parameters, and returns the raw data. You ask for the monthly churn rate, and the agent fetches it. If you need a specific segment, the agent runs `query_people_count` to find exactly how many users match the criteria. Windsurf then formats those numbers into a markdown table or injects them into your weekly report document. The context shift drops to zero.

Setup guide

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

mcp_config.json

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

Open your `mcp_config.json` file in `~/.codeium/windsurf/` and add the server details. You can also use the Settings -> Cascade -> MCP Servers UI to connect it. Hit refresh in the panel and Cascade will discover the tools immediately.

Yes. Cascade reads your existing schema via `list_event_types` and writes the exact implementation for your app. It checks the live data to prevent duplicate event names.

You avoid context switching. Cascade pulls `query_metric_data` straight into your editor while you write code. It lets you verify that your new tracking implementation actually works before you commit.

Cascade operates autonomously but shows you its planned steps. It will map out the `record_event` payloads and execute them based on your prompts. You set the goal, and the agent handles the API sequence.

This server handles raw user emails, browser IDs, and behavioral property payloads. Windsurf processes this identity data locally in memory to execute your commands. The agent discards the PII as soon as the session ends.

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