# Umami (Privacy Analytics) MCP > Umami (Privacy Analytics) connects your AI agent to an open-source analytics dashboard. It lets you track user events, manage websites, and oversee team access without relying on third-party tracking cookies. You get full control over your data—the perfect alternative for anyone prioritizing user privacy. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** web-analytics, privacy-focused, event-tracking, data-visualization, website-traffic ## Description Need reliable insights into how users interact with your site? This MCP connects your AI agent to Umami, a privacy-focused analytics system that tracks events and behavior locally. Instead of logging into complex dashboards, you simply ask your agent what you need—like total signups or bounce rate by device—and get the answer back in plain text. Whether you're tracking custom actions with `send_event`, needing to check which websites are active using `get_me_websites`, or managing user access via administrative tools, this MCP handles it all. This integration is available through Vinkius, making Umami accessible from any compatible AI client. It gives you direct command over your analytics data and infrastructure. ## Tools ### add_team_user Adds a specific user account to an existing team. ### admin_list_teams Retrieves a list of all teams, but only if the calling agent has admin privileges. ### admin_list_users Returns a complete list of every user on the instance (Admin required). ### admin_list_websites Gets an admin-level overview listing all websites managed by the account. ### create_attribution_report Generates a comprehensive report showing where conversions originated. ### create_funnel_report Builds and retrieves data detailing the steps users take toward conversion. ### create_link Generates a unique tracking link for marketing campaigns. ### create_pixel Creates a new pixel snippet to track specific user interactions. ### create_report Initializes the creation of a custom, ad-hoc report for analysis. ### create_retention_report Generates reports showing which users return to the site over time. ### create_revenue_report Pulls a report summarizing monetary value and revenue metrics. ### create_team Creates a new, dedicated team within the Umami instance. ### create_user Creates a brand new user account (Admin required). ### create_website Sets up and registers a new website within the Umami system. ### delete_user Permanently deletes an existing user account (Admin required). ### delete_website Removes a website and all associated data from the instance. ### get_me_teams Retrieves all teams that are currently assigned to the user running the agent. ### get_me Fetches basic information about the current connected session and authorized access levels. ### get_me_websites Lists all websites that are currently linked to the user's account. ### get_realtime_stats Retrieves aggregate statistics covering activity within the last 30 minutes. ### get_session_activity Shows a chronological list of actions performed during a specific session. ### get_session Pulls detailed information about one individual user session. ### get_team_users Lists all users who are members of a specific team (Admin required). ### get_team_websites Displays every website that belongs to an entire team. ### get_user_teams Retrieves all teams a specific user is part of (Admin required). ### get_user Fetches the profile details for any user by their unique ID (Admin required). ### get_user_websites Lists all websites associated with a specific user account (Admin required). ### get_website_active Counts and lists users who have been active on the site in the last 5 minutes. ### get_website_daterange Determines what date range of data is available for a specific website. ### get_website_event_data_events Provides a list and count of all unique event types that have been tracked on the site. ### get_website_event_data_fields Shows which properties and values were captured when events occurred. ### get_website_event_data Aggregates event data, grouping statistics by the specific event name. ### get_website_events_stats Calculates and returns overall statistical summaries for all recorded events. ### get_website_events Retrieves raw, detailed records of every event that occurred on the website. ### get_website_metrics_expanded Pulls comprehensive site metrics, including total time and bounce rates. ### get_website_metrics Gets key performance indicators for a set time range, broken down by path, browser, or OS. ### get_website_pageviews Retrieves historical data showing both pageviews and session counts over time. ### get_website_sessions_stats Provides a summary of key statistics, like total sessions and unique visitors. ### get_website_sessions Pulls detailed information for every recorded user session on the site. ### get_website_stats Returns a summary of overall website performance, including visitors and pageviews. ### get_website Retrieves the basic configuration details for a specific website by its ID. ### join_team Allows the user to join an existing team using a provided access code. ### list_links Returns all unique tracking links that have been created by the current user. ### list_pixels Shows every custom pixel snippet the user has set up for tracking. ### list_reports Lists all historical reports that have been generated for a given website ID. ### list_teams Returns a list of every team available on the instance. ### list_websites Retrieves all websites visible to the current user account. ### login Authenticates with a self-hosted Umami instance and retrieves an access token for API use. ### reset_website Wipes all data related to the website, returning it to its initial state (admin action). ### send_event Transmits a specific custom event and associated properties to Umami. ### update_user Modifies the profile details of an existing user account (Admin required). ### update_website Makes changes to the configuration or settings of a registered website. ### verify_token Checks whether the current API token is still valid and hasn't expired. ## Prompt Examples **Prompt:** ``` List all websites I have access to in Umami. ``` **Response:** ``` I've retrieved your websites. You have access to: '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:** ``` Fetching user list... I found 3 users: 'admin' (Role: admin), 'editor_jane' (Role: user), and 'viewer_bob' (Role: user). ``` ## Capabilities ### Track User Actions Send specific custom events or page views directly to the Umami instance. ### Manage Websites List, create, and delete websites associated with your account or the entire instance. ### Handle User Provisioning Create, update, or delete user accounts and manage team membership within Umami. ### Generate Reports Pull detailed reports on revenue, conversions, retention, and general site performance metrics. ### View Realtime Data Retrieve live statistics and activity logs for the current session or recent time frames. ## Use Cases ### Debugging a new signup flow A Growth Marketer needs to ensure the 'thank you' page is properly tracked. Instead of setting up dev tools, they ask their agent to run `send_event` with the specific event name and properties needed for testing. ### Onboarding a new client team A DevOps Engineer needs to give three people access but keep them separate. They use `create_team`, then run `add_team_user` multiple times, followed by `get_team_users` to confirm everyone is set up correctly. ### Calculating Q3 revenue performance A Data Analyst needs a quick financial overview. They ask their agent to generate a report using `create_revenue_report`, getting instant access to the necessary metrics without having to export data and use spreadsheet software. ### Investigating user drop-offs A Product Manager suspects users are failing at checkout. They ask their agent for a `create_funnel_report` to pinpoint exactly where the conversion rate drops off across the site's journey. ## Benefits - Stop manually sifting through dashboards. You can tell your agent to pull detailed reports—like generating a `create_funnel_report` or running a `create_revenue_report`—and get the summary instantly, right where you are working. - Improve data integrity by automating tasks like sending test events. Need to verify a new signup flow? Use `send_event` to trigger and track specific actions without touching any code. - Gain full administrative control over your user base. You can use tools like `create_user`, `delete_user`, or `add_team_user` directly through conversation, eliminating the need to navigate complex admin panels. - Conserve time by getting an immediate overview of your digital assets. Quickly check all linked sites using `get_me_websites` or list every team available via `list_teams` in a single query. - Get clear visibility into traffic flow and user behavior. You can ask the agent to provide historical data, retrieving session details with `get_website_sessions`, or checking real-time stats using `get_realtime_stats`. ## How It Works The bottom line is that you talk to your agent, and it handles the connection, authentication, and data retrieval from Umami for you. 1. Subscribe to this MCP, providing your Umami Instance URL and API credentials. 2. Authenticate by running a login command within your AI agent to get an active token. 3. Ask your agent specific questions like 'Show me the top 5 revenue reports' or 'List all teams,' and it executes the necessary tool calls. ## Frequently Asked Questions **How do I check my current user status with Umami (Privacy Analytics)?** You run `get_me` to retrieve information about the session. This confirms your current access level and details without needing manual login steps. **Can I use Umami (Privacy Analytics) MCP to track a new event?** Yes, you can use `send_event`. You just need to specify the desired custom event name and any associated properties for tracking purposes. **What if I forget my API key for Umami (Privacy Analytics)?** Don't worry. You should first use the `login` tool, which authenticates with your self-hosted instance and retrieves a fresh access token. **How do I see all available user roles in Umami (Privacy Analytics)?** You can list all users using `admin_list_users` to get the roster, or use `get_user_teams` if you only want to see teams for a specific user. **Which tool should I use to check what websites I manage in Umami (Privacy Analytics)?** Use `get_me_websites`. This function specifically lists all the websites that your current account has access to and manages.