How to Use the Kissmetrics MCP in Vercel AI SDK

Q: How do I connect the Kissmetrics MCP Server to Vercel AI SDK?

Use createMCPClient with the HTTP transport URL. Pass mcpClient.tools() directly into generateText or streamText.

Q: How do I find my Kissmetrics event names using Vercel AI SDK?

Call the listeventtypes tool. Your agent will return an array of all defined events in your account so you avoid typos when tracking.

Stream live behavioral data directly into your React components with the Kissmetrics MCP Server for Vercel AI SDK.

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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Render Live Metrics via Vercel AI SDK

The `query_metric_data` tool pulls specific metric IDs directly into your frontend using the Vercel AI SDK. You don't have to wait for a backend cron job to finish processing. Your AI client fetches the numbers and pushes them into your Next.js dashboard as they arrive. Combine this with `query_people_count` to show active user segments in real-time. The edge-compatible transport means these network requests happen fast, letting your users see their audience size change without a loading spinner blocking the view.

Track User Behavior On The Fly

The `record_event` tool logs actions exactly when they happen in your application. Your agent captures the person's identity and the event name, then pushes that payload to Kissmetrics. This bypasses the need to write custom tracking wrappers in your React codebase. You also get the `set_person_properties` tool to update user profiles on the spot. When someone fills out a form or hits a milestone, the Vercel AI SDK triggers the MCP tool to tag their account immediately.

Resolve Cross-Device Identities

The `alias_identities` tool fixes the broken funnel problem by linking anonymous browser sessions to authenticated emails. Your AI client spots a login event and fires this tool to merge the histories. That keeps your attribution models accurate. Finding what to track is handled by `list_event_types` and `list_property_names`. These tools map out your existing account schema so the SDK knows exactly which fields are available before attempting an update.

Setup guide

Set up Kissmetrics MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Kissmetrics tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Kissmetrics transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Use `createMCPClient` with the HTTP transport URL. Pass `mcpClient.tools()` directly into `generateText` or `streamText`.

Yes. The SDK streams the tool execution results straight to the client. Your users see the data from `query_metric_data` appear instantly.

It works perfectly. The MCP protocol uses standard HTTP transport, which runs natively in edge environments without heavy Node dependencies.

Call the `list_event_types` tool. Your agent will return an array of all defined events in your account so you avoid typos when tracking.

The server processes raw email addresses and browser IDs when you call `alias_identities`. Vinkius runs this connection in a V8 Isolate Sandbox that destroys itself after the request, leaving zero persistent logs of your customer PII.

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