# Umami (Privacy Analytics) MCP for AI Agents AI Agent Connect > Umami (Privacy Analytics) MCP lets you manage your analytics and infrastructure through your AI agent. Track custom events, handle website records, and manage your team or users without leaving your chat interface. It is the way to bridge your privacy-focused data with your primary workflow. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_3EkdTojDXQ7xX3QktNk5Jnb7UOnEl349crvP5TAa/ai-agent-connect - **Tags:** web-analytics, privacy-focused, event-tracking, data-visualization, website-traffic ## Description Umami (Privacy Analytics) gives you direct access to your Umami instance so you can handle analytics tasks using natural language. Instead of digging through a dashboard to find which websites are active or who has access to your teams, you just ask your agent. You can trigger test events to check if your tracking is working or pull real-time stats to see what is happening right now. It handles the heavy lifting of user management, like creating new accounts or updating team permissions, which usually requires a lot of clicking. If you are running a self-hosted setup, the connection is straightforward since you can authenticate directly. You will find it is a lot faster to manage your analytics infrastructure when you can just describe the changes you want to make. It fits right into the Vinkius catalog as a tool for anyone who values privacy but still needs robust data oversight. ## Tools ### create_funnel_report Make a conversion funnel report. This shows where users drop off in your flow. ### create_link Create a new custom link. Use this for tracking specific marketing campaigns. ### create_pixel Create a new tracking pixel. This helps you deploy new tracking across your site. ### create_report Create a custom report. Use this to build specific views of your data. ### create_retention_report Make a user retention report. This shows how often users come back. ### create_revenue_report Make a revenue report. Use this to track your sales data. ### create_team Create a new team. This helps you group users for specific projects. ### create_user Create a new user account. This is for adding new team members to the instance. ### create_website Create a new website entry. Use this to start tracking a new project. ### delete_user Remove a user from the instance. Use this to offboard people from your data. ### delete_website Remove a website from your account. This clears out old or decommissioned projects. ### get_me_teams See the teams for your current user. It is a quick way to check your own memberships. ### get_me Get info about your current session. Use this to check your login status. ### get_me_websites List all websites for your user. This helps you see what you own personally. ### get_session Get details on a specific session. This lets you look into individual user visits. ### get_team_users See who is in a specific team. This helps you manage your team rosters. ### get_team_websites See which websites a team owns. This clarifies ownership across your projects. ### get_user_teams See every team a user belongs to. This is for admin-level auditing of user access. ### get_user Get details for a specific user. Use this to check a user's profile or status. ### get_user_websites See every website a user owns. This is for admin-level auditing of site ownership. ### get_website_active See active users in the last 5 minutes. This gives you a pulse on live traffic. ### get_website_daterange See the available date range for a site. Use this to know how far back your data goes. ### get_website_event_data_events See the names and counts of events. This helps you understand what events are being tracked. ### get_website_event_data_fields See counts for property and values. This helps you audit the quality of your event data. ### get_website_event_data Get event data grouped by event type. This is great for deep-diving into user actions. ### get_website_events See the details of website events. This shows you exactly what happened on your site. ### get_website_metrics_expanded Get metrics including bounces and total time. This gives you a fuller picture of user behavior. ### get_website_metrics Get metrics for a specific time range. Use this to compare performance over time. ### get_website_pageviews Get pageview and session series data. This shows you your most popular pages. ### get_website_sessions_stats Get a summary of session stats. This helps you understand your overall traffic volume. ### get_website_sessions Get details for website sessions. This lets you look into individual user visits. ### get_website_stats Get a summary of pageviews and visitors. This is your quick glance at site health. ### get_website Get the details for a specific website. Use this to check a site's configuration. ### join_team Join a team using an access code. This is how you get into shared spaces. ### list_links See all your user links. Use this to manage your custom tracking links. ### send_event Send a custom event to Umami. Use this to track specific actions like signups or purchases. ### update_user Update an existing user's info. This is how you manage user profiles. ### update_website Update a website's details. Use this to change names or settings for a project. ### verify_token Check if your current token is still valid. This helps you debug your connection. ### add_team_user Add a specific user to a team. This makes it easy to organize your staff and permissions. ### admin_list_teams View every team in your instance. This is used for high-level admin oversight. ### admin_list_users See every user across the instance. Use this to audit your entire organization. ### list_teams See the teams you are a member of. Use this to check your own permissions. ### get_realtime_stats Get stats from the last 30 minutes. Use this to see immediate traffic trends. ### list_pixels See all your user pixels. This helps you manage your tracking snippets. ### list_reports Get all reports for a specific website. Use this to see what data is available. ### list_websites See all websites you own. This gives you a high-level view of your projects. ### login Log into your self-hosted instance. This retrieves the token needed for all other tools. ### reset_website Wipe all data for a specific website. Use this to start fresh on a project. ### admin_list_websites See every website on the instance. This is for full administrative oversight. ### create_attribution_report Make a marketing attribution report. Use this to see where your traffic comes from. ### get_session_activity See what a user did in a session. This helps you understand specific user paths. ### get_website_events_stats Get aggregated event statistics. Use this to see high-level totals for specific actions. ## Prompt Examples **Prompt:** ``` Which websites do I currently have active in my Umami account? ``` **Response:** ``` I found 3 active websites in your account: **'Personal Blog'** (ID: 8f2...1a), **'E-commerce Store'** (ID: 3d4...9b), and **'Documentation Portal'** (ID: 1a2...5c). ``` **Prompt:** ``` Send a 'newsletter_signup' event for website 8f2...1a on page /thanks. ``` **Response:** ``` The event **'newsletter_signup'** has been successfully sent to Umami for the specified website and URL. ``` **Prompt:** ``` Show me all users on this Umami instance. ``` **Response:** ``` I've pulled the user list for you. Here are the 3 users currently registered: * **admin** (Role: admin) * **editor_jane** (Role: user) * **viewer_bob** (Role: user) ``` ## Capabilities ### Trigger custom events Send specific actions like signups or purchases to your analytics dashboard. ### Manage website records Add, delete, or update your website listings in one go. ### Provision team members Add users to specific teams or join them using access codes. ### Pull real-time stats Get a snapshot of traffic and activity from the last 30 minutes. ### Audit user permissions View all users across your instance and see who belongs to which team. ### Generate marketing reports Create funnel, retention, or revenue reports on demand. ## Use Cases ### The Marketing Audit A growth lead wants to see which websites are currently active and who has access. They ask the agent to list all websites and then use get_user_websites to verify ownership. ### The Tracking Test A developer just finished a new signup flow. They ask the agent to use send_event to trigger a 'newsletter_signup' and then check get_website_events to confirm it arrived. ### The Onboarding Task An admin needs to set up a new team. They ask the agent to use create_team, then create_user, and finally add_team_user to get the new hire started. ### The Performance Review A product manager wants to know how users are moving through the app. They ask for a conversion funnel using create_funnel_report and a retention report via create_retention_report. ## Benefits - Manage your entire analytics backend without leaving your chat window using list_websites and get_website_stats. - Automate user and team management with create_user and add_team_user to save time on manual admin tasks. - Verify your tracking setup instantly by triggering test events with send_event and checking them with get_website_events. - Generate complex marketing data like revenue or retention reports using create_revenue_report and create_retention_report. - Monitor live traffic trends in real-time with get_realtime_stats and get_website_active to see what is happening now. - Audit your entire instance's security and access levels using admin_list_users and admin_list_websites. ## How It Works The bottom line is you get to manage your entire analytics backend through a chat interface. 1. Subscribe to the Connector and provide your Umami Instance URL and API Key. 2. Authenticate your connection using the login tool if you are on a self-hosted setup. 3. Ask your agent to pull stats, create reports, or manage your user list. ## Frequently Asked Questions **What is the Umami (Privacy Analytics) MCP?** It is a way to control your Umami analytics platform using an AI agent. You can perform tasks like creating users, checking stats, and generating reports through a simple chat interface. **Can I use the Umami (Privacy Analytics) MCP to manage my team?** Yes. You can use it to create new teams, add specific users to those teams, and audit who has access to your instance. **Can I see live traffic with the Umami (Privacy Analytics) MCP?** Yes, you can ask your agent to pull real-time stats from the last 30 minutes or check for active users in the last 5 minutes. **Is the Umami (Privacy Analytics) MCP for Google Analytics?** No, this Connector is specifically for Umami, which is a privacy-focused analytics platform. It will not connect to Google Analytics. **How do I connect my self-hosted Umami to the Umami (Privacy Analytics) MCP?** You can connect your self-hosted instance by providing your instance URL and API key, or by using the login tool to authenticate and retrieve a token. **Can I create marketing reports with the Umami (Privacy Analytics) MCP?** Yes. You can ask your agent to generate specific reports like funnel, retention, revenue, or marketing attribution reports on demand. **Can I use this with my self-hosted Umami instance?** Yes. You can provide your custom instance URL and use the `login` tool to authenticate, or provide a pre-generated API key/token. **How do I track a custom event from the AI?** Use the `send_event` tool. You'll need to provide the `website` ID and the `url`. You can also include optional metadata like `name` and `data` objects. **Can I manage other users if I am an admin?** Absolutely. If your credentials have admin rights, you can use `admin_list_users`, `create_user`, `update_user`, and `delete_user` to manage the instance population.