4,000+ servers built on vurb.ts
Vinkius

Umami (Privacy Analytics) MCP Server for Pydantic AIGive Pydantic AI instant access to 53 tools to Add Team User, Admin List Teams, Admin List Users, and more

MCP Inspector GDPR Free for Subscribers

Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect Umami (Privacy Analytics) through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.

Ask AI about this MCP Server for Pydantic AI

The Umami (Privacy Analytics) MCP Server for Pydantic AI is a standout in the Marketing Automation category — giving your AI agent 53 tools to work with, ready to go from day one.

Built for AI Agents by Vinkius

Vinkius delivers Streamable HTTP and SSE to any MCP client

ClaudeClaude
ChatGPTChatGPT
CursorCursor
GeminiGemini
WindsurfWindsurf
VS CodeVS Code
JetBrainsJetBrains
VercelVercel
+ other MCP clients
python
import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

    agent = Agent(
        model="openai:gpt-4o",
        mcp_servers=[server],
        system_prompt=(
            "You are an assistant with access to Umami (Privacy Analytics) "
            "(53 tools)."
        ),
    )

    result = await agent.run(
        "What tools are available in Umami (Privacy Analytics)?"
    )
    print(result.data)

asyncio.run(main())
Umami (Privacy Analytics)
Fully ManagedVinkius Servers
60%Token savings
High SecurityEnterprise-grade
IAMAccess control
EU AI ActCompliant
DLPData protection
V8 IsolateSandboxed
Ed25519Audit chain
<40msKill switch
Stream every event to Splunk, Datadog, or your own webhook in real-time

* 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.

Pydantic AI validates every Umami (Privacy Analytics) tool response against typed schemas, catching data inconsistencies at build time. Connect 53 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.

What you can do

  • Event Tracking — Send custom events and page views directly to your Umami instance using the send_event tool.
  • Website Management — List and manage all websites associated with your account or the entire instance using get_me_websites or admin_list_websites.
  • User & Team Administration — Perform administrative tasks like creating, updating, or deleting users and managing teams with tools like create_user and admin_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 login tool to authenticate and retrieve tokens.

The Umami (Privacy Analytics) MCP Server exposes 53 tools through the Vinkius. Connect it to Pydantic AI 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 Pydantic AI

When Pydantic AI 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

Add team user on Umami (Privacy Analytics)

Add user to team

admin

Admin list teams on Umami (Privacy Analytics)

Returns all teams (Admin only)

admin

Admin list users on Umami (Privacy Analytics)

Returns all users (Admin only)

admin

Admin list websites on Umami (Privacy Analytics)

Returns all websites (Admin only)

create

Create attribution report on Umami (Privacy Analytics)

Marketing attribution report

create

Create funnel report on Umami (Privacy Analytics)

Conversion funnel report

create

Create link on Umami (Privacy Analytics)

Creates a link

create

Create pixel on Umami (Privacy Analytics)

Creates a pixel

create

Create report on Umami (Privacy Analytics)

Creates a report

create

Create retention report on Umami (Privacy Analytics)

User retention report

create

Create revenue report on Umami (Privacy Analytics)

Revenue report

create

Create team on Umami (Privacy Analytics)

Creates a team

create

Create user on Umami (Privacy Analytics)

Creates a user (Admin only)

create

Create website on Umami (Privacy Analytics)

Creates a website

delete

Delete user on Umami (Privacy Analytics)

Deletes a user (Admin only)

delete

Delete website on Umami (Privacy Analytics)

Deletes a website

get

Get me on Umami (Privacy Analytics)

Get information about the current session

get

Get me teams on Umami (Privacy Analytics)

Get all teams for the current user

get

Get me websites on Umami (Privacy Analytics)

Get all websites for the current user

get

Get realtime stats on Umami (Privacy Analytics)

Realtime stats within the last 30 minutes

get

Get session on Umami (Privacy Analytics)

Individual session details

get

Get session activity on Umami (Privacy Analytics)

Activity for a session

get

Get team users on Umami (Privacy Analytics)

Get team members

get

Get team websites on Umami (Privacy Analytics)

Get team websites

get

Get user on Umami (Privacy Analytics)

Gets a user by ID (Admin only)

get

Get user teams on Umami (Privacy Analytics)

Gets all teams belonging to a user (Admin only)

get

Get user websites on Umami (Privacy Analytics)

Gets all websites belonging to a user (Admin only)

get

Get website on Umami (Privacy Analytics)

Gets a website by ID

get

Get website active on Umami (Privacy Analytics)

Active users in the last 5 minutes

get

Get website daterange on Umami (Privacy Analytics)

Available data date range

get

Get website event data on Umami (Privacy Analytics)

Event data grouped by event

get

Get website event data events on Umami (Privacy Analytics)

Event data names and counts

get

Get website event data fields on Umami (Privacy Analytics)

Property and value counts

get

Get website events on Umami (Privacy Analytics)

Website event details

get

Get website events stats on Umami (Privacy Analytics)

Aggregated event statistics

get

Get website metrics on Umami (Privacy Analytics)

Metrics for a given time range (type: path, browser, os, etc.)

get

Get website metrics expanded on Umami (Privacy Analytics)

Expanded metrics including bounces and total time

get

Get website pageviews on Umami (Privacy Analytics)

Pageviews and sessions series data

get

Get website sessions on Umami (Privacy Analytics)

Website session details

get

Get website sessions stats on Umami (Privacy Analytics)

Summarized session statistics

get

Get website stats on Umami (Privacy Analytics)

Summarized website statistics (pageviews, visitors, etc.)

join

Join team on Umami (Privacy Analytics)

Join a team via access code

list

List links on Umami (Privacy Analytics)

Returns all user links

list

List pixels on Umami (Privacy Analytics)

Returns all user pixels

list

List reports on Umami (Privacy Analytics)

Get all reports by website ID

list

List teams on Umami (Privacy Analytics)

Returns all teams

list

List websites on Umami (Privacy Analytics)

Returns all user websites

action

Login on Umami (Privacy Analytics)

Login to self-hosted Umami to get a token

reset

Reset website on Umami (Privacy Analytics)

Removes all data related to the website

send

Send event on Umami (Privacy Analytics)

Send an event to Umami

update

Update user on Umami (Privacy Analytics)

Updates a user (Admin only)

update

Update website on Umami (Privacy Analytics)

Updates a website

verify

Verify token on Umami (Privacy Analytics)

Verify if the current token is still valid

Connect Umami (Privacy Analytics) to Pydantic AI via MCP

Follow these steps to wire Umami (Privacy Analytics) into Pydantic AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.

01

Install Pydantic AI

Run pip install pydantic-ai
02

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token
03

Run the agent

Save to agent.py and run: python agent.py
04

Explore tools

The agent discovers 53 tools from Umami (Privacy Analytics) with type-safe schemas

Why Use Pydantic AI with the Umami (Privacy Analytics) MCP Server

Pydantic AI provides unique advantages when paired with Umami (Privacy Analytics) through the Model Context Protocol.

01

Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application

02

Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Umami (Privacy Analytics) integration code

03

Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors

04

Dependency injection system cleanly separates your Umami (Privacy Analytics) connection logic from agent behavior for testable, maintainable code

Umami (Privacy Analytics) + Pydantic AI Use Cases

Practical scenarios where Pydantic AI combined with the Umami (Privacy Analytics) MCP Server delivers measurable value.

01

Type-safe data pipelines: query Umami (Privacy Analytics) with guaranteed response schemas, feeding validated data into downstream processing

02

API orchestration: chain multiple Umami (Privacy Analytics) tool calls with Pydantic validation at each step to ensure data integrity end-to-end

03

Production monitoring: build validated alert agents that query Umami (Privacy Analytics) and output structured, schema-compliant notifications

04

Testing and QA: use Pydantic AI's dependency injection to mock Umami (Privacy Analytics) responses and write comprehensive agent tests

Example Prompts for Umami (Privacy Analytics) in Pydantic AI

Ready-to-use prompts you can give your Pydantic AI agent to start working with Umami (Privacy Analytics) immediately.

01

"List all websites I have access to in Umami."

02

"Send a 'newsletter_signup' event for website 8f2...1a on page /thanks."

03

"Show me all users on this Umami instance."

Troubleshooting Umami (Privacy Analytics) MCP Server with Pydantic AI

Common issues when connecting Umami (Privacy Analytics) to Pydantic AI through Vinkius, and how to resolve them.

01

MCPServerHTTP not found

Update: pip install --upgrade pydantic-ai

Umami (Privacy Analytics) + Pydantic AI FAQ

Common questions about integrating Umami (Privacy Analytics) MCP Server with Pydantic AI.

01

How does Pydantic AI discover MCP tools?

Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
02

Does Pydantic AI validate MCP tool responses?

Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
03

Can I switch LLM providers without changing MCP code?

Absolutely. Pydantic AI abstracts the model layer. your Umami (Privacy Analytics) MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.

Explore More MCP Servers

View all →