How to Use the Pirsch Analytics MCP in Vercel AI SDK
Feed real-time privacy-first web traffic metrics directly into your React or Next.js UI using Vercel AI SDK.
Works with every AI agent you already use
…and any MCP-compatible client
Connect Pirsch Analytics MCP to Vercel AI SDK
Create your Vinkius account to connect Pirsch Analytics to Vercel AI SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.
Key Capabilities
Feed live traffic data directly to Vercel AI SDK
The `get_statistics_overview` tool pulls core domain performance metrics directly into your streaming UI. Your users watch visitor counts, bounce rates, and session durations update live on the page without dealing with stale loading states. This setup uses Edge-compatible execution to fetch fresh numbers fast. By pairing this with `get_statistics_active`, your interface displays immediate active user counts the second the agent receives the request.
Track user actions instantly from the edge
The `send_hit` tool records page views instantly without relying on heavy client-side tracking scripts. Your edge functions capture clean traffic data and push it straight to your analytics dashboard before the browser even finishes rendering. For bulk operations, you run `send_hit_batch` to package multiple page visits together. This keeps your database operations light and prevents your serverless functions from timing out during high-traffic spikes.
Analyze conversion funnels using this MCP Server
The `get_statistics_goals` tool inspects your custom conversion targets to verify which marketing paths actually work. Your agent queries conversion rates and goal completions to adjust your user acquisition tactics on the fly. You also pull referral channels using `get_statistics_referrer` to pinpoint where your traffic originates. This lets you map out the entire user path from first click to final conversion.
Set up Pirsch Analytics MCP in Vercel AI SDK
Prerequisites
- Node.js 18+ and a TypeScript project
-
ai+@modelcontextprotocol/sdkpackages - Active Vinkius subscription with a valid endpoint token
- 1
Install dependencies
Run
npm install ai @modelcontextprotocol/sdkplus your preferred model provider (e.g.@ai-sdk/openai). - 2
Create the Streamable HTTP transport
Use
StreamableHTTPClientTransportwith 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 Pirsch Analytics tools. Pass them directly togenerateText()orstreamText()— 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.
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 Pirsch Analytics transactions",
});
console.log(text);
await mcpClient.close(); Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Pirsch Analytics. 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.
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 Pirsch Analytics MCP in Vercel AI SDK
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
Start using the Pirsch Analytics MCP today
We host it, we monitor it, we maintain it. You just paste one token.