How to Use the Pirsch Analytics MCP in Mastra AI

Q: Can Mastra AI automatically create new tracking domains in Pirsch Analytics?

Yes. The agent invokes createdomain to provision a new tracking space whenever you launch a new project. You use listdomains to verify the setup succeeded.

Automate your privacy-first analytics workflows and handle traffic spikes with Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Pirsch Analytics MCP to Mastra AI

Create your Vinkius account to connect Pirsch Analytics to Mastra AI — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Pirsch Analytics with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Trigger automated reporting runs with Mastra AI workflows

The `get_statistics_overview` tool retrieves high-level domain performance metrics to feed your automated reporting workflows. Mastra manages multi-step pipelines that fetch these stats, analyze performance drops, and notify your team if numbers dip. You chain this with `get_statistics_visitor` to isolate visitor trends over specific periods. If a step fails, the built-in retry engine handles network hiccups without crashing your entire analytics run.

Process high-volume event tracking with auto-retries

The `send_event_batch` tool handles bulk event logging by grouping multiple user actions into a single payload. Your workflow queues clicks, signups, and downloads, then dispatches them in structured batches to keep API usage clean. If a batch fails, the system triggers exponential backoff retries. This ensures you never lose critical conversion data during server outages or high-traffic events.

Monitor campaign performance via this MCP Server

The `get_statistics_utm_source` tool extracts campaign tracking parameters to evaluate marketing performance. Your agent reviews which UTM sources drive actual engagement, allowing your automated workflows to adjust ad spend dynamically. To verify landing page performance, the agent calls `get_statistics_page` to check bounce rates on specific URLs. This gives you direct, cookie-free feedback on where your traffic lands.

Setup guide

Set up Pirsch Analytics 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 Pirsch Analytics 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: "pirsch-analytics-mcp-client",
  servers: {
    "pirsch-analytics-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Pirsch Analytics 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 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.

Connect Pirsch Analytics 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 Pirsch Analytics MCP in Mastra AI

You instantiate the MCP client with the server URL and spread the returned tools into your agent configuration. Your agent immediately gains access to commands like `get_statistics_active` to monitor live traffic.

Yes. The agent invokes `create_domain` to provision a new tracking space whenever you launch a new project. You use `list_domains` to verify the setup succeeded.

Mastra uses its built-in workflow engine to queue requests. If tools like `get_statistics_events` hit rate limits, the framework automatically retries the call using exponential backoff.

No, you usually don't. You can bypass approval for read-only statistics and background tracking tools like `send_hit`, but you can require approval for domain creation if needed.

It processes metadata like page URLs, UTM sources, and event names without storing IP addresses or tracking cookies. All data remains in Vinkius's zero-trust sandboxed MCP environment, keeping your analytical footprint clean.

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