How to Use the Pirsch Analytics MCP in OpenAI Agents SDK

Q: Can Pirsch Analytics track events in an OpenAI Agents SDK loop?

Yes. You can trigger sendevent or sendeventbatch whenever your agent finishes a task. It keeps your data current.

Track privacy-first metrics directly in your OpenAI Agents SDK production workflows without the bloat.

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 OpenAI Agents SDK

Create your Vinkius account to connect Pirsch Analytics to OpenAI Agents SDK — 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Full-stack hit and event tracking

Pipe your traffic data straight from your agent logic to your dashboard. Use `send_hit` or `send_hit_batch` to capture every page view with zero cookies. Your agent handles the telemetry while you focus on the business logic. It’s a clean way to keep your analytics pipeline running inside your agent's execution loop.

Query metrics with your OpenAI Agents SDK

Ask your agent for an overview of how your site is performing. Tools like `get_statistics_overview` and `get_statistics_goals` return real-time data directly to your context window. You'll get the numbers you need without leaving your terminal. The agent maps the API output to your internal reporting structures instantly.

Automated domain management

Provision new tracking environments without manual dashboard work. The `create_domain` tool lets your agent register new sites on the fly. Keep your infrastructure as code by letting the agent list and verify domains via `list_domains`. It connects your deployment process to your tracking setup in one move.

Setup guide

Set up Pirsch Analytics MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Pirsch Analytics tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Pirsch Analytics tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Pirsch Analytics tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Pirsch Analytics Agent",
            instructions="You have access to Pirsch Analytics tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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.