How to Use the Kissmetrics MCP in Mastra AI

Q: How do I install the Kissmetrics MCP Server in Mastra AI?

Install @mastra/mcp. Initialize the MCPClient with your Vinkius server URL and spread the results from mcpClient.listTools() into your agent's tools array.

Q: How do I require human approval for Kissmetrics updates in Mastra AI?

You can enable requireToolApproval on the agent. This pauses the workflow before calling setpersonproperties until an admin signs off.

Build resilient event-tracking workflows with the Kissmetrics MCP Server for Mastra AI.

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 Mastra AI

Create your Vinkius account to connect Kissmetrics to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Event Tracking Workflows

The `record_event` tool executes behavioral tracking inside your Mastra AI workflows. If a primary database write succeeds, your agent fires this tool to log the corresponding Kissmetrics event. You define the logic, and the agent handles the API execution. Updating user states happens through the `set_person_properties` tool. Mastra's built-in retry mechanisms ensure that if the MCP Server drops a connection, the workflow backs off and tries again. You never lose a critical customer tag.

Fix Attribution with Mastra AI

The `alias_identities` tool merges pre-login anonymous IDs with post-login emails. Mastra AI can trigger this step conditionally. If an account creation workflow completes, the agent immediately links the two identities to preserve the historical journey. The `list_event_types` and `list_property_names` tools prevent dirty data. Your agent checks these endpoints to confirm a property exists before trying to update it.

Run Conditional Reporting Loops

The `query_metric_data` tool pulls specific analytics into your internal reporting pipelines. You configure a Mastra workflow to fetch weekly performance numbers. The agent grabs the data and formats it for your team. Adding `query_people_count` lets you build alerts based on audience size. If a specific user segment drops below a threshold, the workflow branches and notifies your marketing team over Slack.

Setup guide

Set up Kissmetrics MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Kissmetrics tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "kissmetrics-mcp-client",
  servers: {
    "kissmetrics-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Kissmetrics Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Kissmetrics tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Kissmetrics transactions"
);
console.log(result.text);

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 Mastra AI

Install `@mastra/mcp`. Initialize the `MCPClient` with your Vinkius server URL and spread the results from `mcpClient.listTools()` into your agent's tools array.

It handles this automatically. Mastra applies exponential backoff if a `record_event` call hits a rate limit or times out.

You can enable `requireToolApproval` on the agent. This pauses the workflow before calling `set_person_properties` until an admin signs off.

The framework auto-detects between Streamable HTTP and SSE. It defaults to the most efficient connection for your specific Vinkius deployment.

This MCP Server touches behavioral logs and user emails via `record_event`. The integration operates on an ephemeral, zero-trust architecture where authentication tokens are injected per-session and wiped instantly upon execution.

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