Umami (Privacy Analytics) MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 53 tools to Add Team User, Admin List Teams, Admin List Users, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Umami (Privacy Analytics) through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The Umami (Privacy Analytics) MCP Server for OpenAI Agents SDK is a standout in the Marketing Automation category — giving your AI agent 53 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="Umami (Privacy Analytics) Assistant",
instructions=(
"You help users interact with Umami (Privacy Analytics). "
"You have access to 53 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from Umami (Privacy Analytics)"
)
print(result.final_output)
asyncio.run(main())
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About Umami (Privacy Analytics) MCP Server
Connect your Umami instance to any AI agent to monitor your privacy-focused analytics and manage your infrastructure through natural language. Umami is the open-source, privacy-friendly alternative to Google Analytics, and this MCP server gives you full control over your data.
The OpenAI Agents SDK auto-discovers all 53 tools from Umami (Privacy Analytics) through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Umami (Privacy Analytics), another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Event Tracking — Send custom events and page views directly to your Umami instance using the
send_eventtool. - Website Management — List and manage all websites associated with your account or the entire instance using
get_me_websitesoradmin_list_websites. - User & Team Administration — Perform administrative tasks like creating, updating, or deleting users and managing teams with tools like
create_userandadmin_list_teams. - Session Insights — Retrieve information about your current session and authorized access levels using
get_me. - Self-Hosted Support — Seamlessly connect to your own infrastructure using the
logintool to authenticate and retrieve tokens.
The Umami (Privacy Analytics) MCP Server exposes 53 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 53 Umami (Privacy Analytics) tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to Umami (Privacy Analytics) through Vinkius, your AI agent gets direct access to every tool listed below — spanning web-analytics, privacy-focused, event-tracking, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add team user on Umami (Privacy Analytics)
Add user to team
Admin list teams on Umami (Privacy Analytics)
Returns all teams (Admin only)
Admin list users on Umami (Privacy Analytics)
Returns all users (Admin only)
Admin list websites on Umami (Privacy Analytics)
Returns all websites (Admin only)
Create attribution report on Umami (Privacy Analytics)
Marketing attribution report
Create funnel report on Umami (Privacy Analytics)
Conversion funnel report
Create link on Umami (Privacy Analytics)
Creates a link
Create pixel on Umami (Privacy Analytics)
Creates a pixel
Create report on Umami (Privacy Analytics)
Creates a report
Create retention report on Umami (Privacy Analytics)
User retention report
Create revenue report on Umami (Privacy Analytics)
Revenue report
Create team on Umami (Privacy Analytics)
Creates a team
Create user on Umami (Privacy Analytics)
Creates a user (Admin only)
Create website on Umami (Privacy Analytics)
Creates a website
Delete user on Umami (Privacy Analytics)
Deletes a user (Admin only)
Delete website on Umami (Privacy Analytics)
Deletes a website
Get me on Umami (Privacy Analytics)
Get information about the current session
Get me teams on Umami (Privacy Analytics)
Get all teams for the current user
Get me websites on Umami (Privacy Analytics)
Get all websites for the current user
Get realtime stats on Umami (Privacy Analytics)
Realtime stats within the last 30 minutes
Get session on Umami (Privacy Analytics)
Individual session details
Get session activity on Umami (Privacy Analytics)
Activity for a session
Get team users on Umami (Privacy Analytics)
Get team members
Get team websites on Umami (Privacy Analytics)
Get team websites
Get user on Umami (Privacy Analytics)
Gets a user by ID (Admin only)
Get user teams on Umami (Privacy Analytics)
Gets all teams belonging to a user (Admin only)
Get user websites on Umami (Privacy Analytics)
Gets all websites belonging to a user (Admin only)
Get website on Umami (Privacy Analytics)
Gets a website by ID
Get website active on Umami (Privacy Analytics)
Active users in the last 5 minutes
Get website daterange on Umami (Privacy Analytics)
Available data date range
Get website event data on Umami (Privacy Analytics)
Event data grouped by event
Get website event data events on Umami (Privacy Analytics)
Event data names and counts
Get website event data fields on Umami (Privacy Analytics)
Property and value counts
Get website events on Umami (Privacy Analytics)
Website event details
Get website events stats on Umami (Privacy Analytics)
Aggregated event statistics
Get website metrics on Umami (Privacy Analytics)
Metrics for a given time range (type: path, browser, os, etc.)
Get website metrics expanded on Umami (Privacy Analytics)
Expanded metrics including bounces and total time
Get website pageviews on Umami (Privacy Analytics)
Pageviews and sessions series data
Get website sessions on Umami (Privacy Analytics)
Website session details
Get website sessions stats on Umami (Privacy Analytics)
Summarized session statistics
Get website stats on Umami (Privacy Analytics)
Summarized website statistics (pageviews, visitors, etc.)
Join team on Umami (Privacy Analytics)
Join a team via access code
List links on Umami (Privacy Analytics)
Returns all user links
List pixels on Umami (Privacy Analytics)
Returns all user pixels
List reports on Umami (Privacy Analytics)
Get all reports by website ID
List teams on Umami (Privacy Analytics)
Returns all teams
List websites on Umami (Privacy Analytics)
Returns all user websites
Login on Umami (Privacy Analytics)
Login to self-hosted Umami to get a token
Reset website on Umami (Privacy Analytics)
Removes all data related to the website
Send event on Umami (Privacy Analytics)
Send an event to Umami
Update user on Umami (Privacy Analytics)
Updates a user (Admin only)
Update website on Umami (Privacy Analytics)
Updates a website
Verify token on Umami (Privacy Analytics)
Verify if the current token is still valid
Connect Umami (Privacy Analytics) to OpenAI Agents SDK via MCP
Follow these steps to wire Umami (Privacy Analytics) into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the Umami (Privacy Analytics) MCP Server
OpenAI Agents SDK provides unique advantages when paired with Umami (Privacy Analytics) through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Umami (Privacy Analytics) + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the Umami (Privacy Analytics) MCP Server delivers measurable value.
Automated workflows: build agents that query Umami (Privacy Analytics), process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries Umami (Privacy Analytics), another analyzes results, a third generates reports
Data enrichment pipelines: stream data through Umami (Privacy Analytics) tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query Umami (Privacy Analytics) to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for Umami (Privacy Analytics) in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Umami (Privacy Analytics) immediately.
"List all websites I have access to in Umami."
"Send a 'newsletter_signup' event for website 8f2...1a on page /thanks."
"Show me all users on this Umami instance."
Troubleshooting Umami (Privacy Analytics) MCP Server with OpenAI Agents SDK
Common issues when connecting Umami (Privacy Analytics) to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
Umami (Privacy Analytics) + OpenAI Agents SDK FAQ
Common questions about integrating Umami (Privacy Analytics) MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
Unbounce
10 toolsBuild high-converting landing pages with AI-powered optimization that tests headlines, copies, and layouts automatically.

Meshy (3D AI)
17 toolsTransform text and images into high-quality 3D models using Meshy's generative AI directly from your agent.

Microsoft App Store
8 toolsManage your Microsoft Store apps — track submissions, add-ons, and package flights via the Submission API.

UUID Generator API
2 toolsGenerate unique identifiers — audit UUIDs and versions via AI.
