# Matomo MCP > Matomo connects your website analytics directly into your AI agent. Instead of digging through dashboards and reports, you ask natural language questions—like 'What was our bounce rate today?' or 'Which pages are struggling?'—and get immediate, actionable data on site visits, user behavior, and goal completions. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** web-analytics, privacy-focused, user-behavior, real-time-monitoring, conversion-tracking ## Description This MCP lets you interrogate your website’s performance using only conversation. You can pull deep insights into where visitors come from, what they look at, and whether they complete key actions like signing up or buying something. Your agent reads the data streams—everything from real-time visitor movements to historical site traffic summaries—and reports back in plain English. It's like having a dedicated analytics expert available 24/7, ready to answer specific questions about your user base. All you need is an active Matomo instance and access through Vinkius; the rest of the data flow handles itself. You stop guessing at performance metrics and start acting on verified facts. ## Tools ### get_goals Retrieves a list of all conversion goals configured in your Matomo instance. ### get_live_last_visits Pulls the details of visitors who were active on your site just moments ago. ### get_site_details Fetches specific configuration and general information for a defined website within Matomo. ### get_top_pages Identifies the pages that have received the highest volume of traffic recently. ### get_top_referrers Lists and ranks the primary types of websites or sources sending traffic to you. ### get_top_socials Determines which social media platforms are generating the most website visits. ### get_top_websites Identifies the specific external websites that refer visitors to your site. ### get_visitor_profile Provides a full, detailed behavioral history and profile for a single visitor ID. ### get_visits_summary Generates an aggregated report covering key metrics like total visits and actions taken. ### list_sites Retrieves a complete list of all individual websites tracked within your Matomo account. ## Prompt Examples **Prompt:** ``` Show me a summary of visits for today. ``` **Response:** ``` Retrieving summary... Today you had 1,250 visits with an average of 3 actions per visit. ``` **Prompt:** ``` What are the top pages on my site this week? ``` **Response:** ``` Fetching top pages... The Home page and the Pricing page are your most visited content this week. ``` **Prompt:** ``` List all sites configured in Matomo. ``` **Response:** ``` Querying sites... I found 3 sites: 'E-commerce Shop', 'Blog', and 'Support Portal'. ``` ## Capabilities ### Summarize overall site traffic Get a quick, aggregated snapshot of key metrics like total visits, actions taken, and bounce rates over selected time periods. ### Track visitor activity in real-time View the latest movements on your site, seeing exactly which users are active right now and what pages they're viewing. ### Identify popular content areas Determine which specific web pages and types of referring websites are driving the most traffic to your domain. ### Analyze individual user journeys Pull a complete history and behavioral profile for any specific visitor ID, helping you understand their journey through your site. ### Monitor conversion targets List all the critical goals (like sign-ups or purchases) that you've set up in Matomo and check their current status. ## Use Cases ### Checking Campaign Performance A marketing manager asks, 'What were our top referring websites last month?' The agent uses get_top_websites and get_top_referrers to provide a ranked list, allowing the manager to immediately know which partners need follow-up. ### Troubleshooting Drop-Off Points A product owner notices sales dipping. They ask for 'a detailed profile for visitor ID 12345.' The agent uses get_visitor_profile to show the exact pages and actions that user took before leaving, revealing a broken link. ### Auditing Site Health A web analyst wants an immediate health check. They ask for 'a summary of visits.' The agent uses get_visits_summary to deliver the key metrics—actions per visit, bounce rate—in a single conversational response. ### Validating Conversion Funnels A stakeholder needs confirmation that the main lead capture is working. They ask for 'my configured conversion goals.' The agent uses get_goals to list them and confirm which are currently being tracked correctly. ## Benefits - Stop clicking through multiple dashboards. Instead of manually running reports to check your overall traffic, just ask for a visits summary, and the data is returned immediately. - Get granular insight into visitor paths. Using get_visitor_profile means you don't have to guess why someone dropped off; you see their entire journey in one place. - Quickly identify marketing wins or losses. Tools like get_top_referrers and get_top_socials let you pinpoint exactly which channels are worth the budget. - Stay ahead of current issues with real-time data. By using get_live_last_visits, your agent shows you who's on site right now, giving immediate operational awareness. - Understand your goals at a glance. You can list and monitor conversion goals via get_goals to confirm if the site is hitting its key targets. ## How It Works The bottom line is that your AI agent turns complex database reports into simple, spoken insights about your website’s health. 1. First, subscribe to this MCP and enter your unique Matomo URL, API token, and site ID. 2. Next, tell your AI agent what data you need—for example, 'Show me the top five referring social networks.' 3. The system queries Matomo's backend, retrieves the raw metrics, and formats the findings back to you as a conversational report. ## Frequently Asked Questions **How does Matomo help with real-time monitoring?** It provides immediate status updates via get_live_last_visits. This lets your agent show you which users are currently on the site and what they're doing, giving operational visibility instantly. **Can I find out where my traffic is coming from with Matomo?** Yes. You can use get_top_referrers to see general sources, or get_top_websites and get_top_socials for specific external sites that are driving the most volume. **What is the difference between get_visits_summary and list_sites?** get_visits_summary gives you a single, aggregated report of overall site health (like total visits). list_sites just provides an index of every separate website tracked in your account. **Do I need to worry about API tokens when setting up Matomo?** You must provide the correct Matomo URL, Token Auth, and Site ID during setup. These credentials allow your agent to securely access your private analytics data. **Can I analyze a specific user's history with Matomo?** Yes, you can use get_visitor_profile. This tool pulls the complete behavioral record for one visitor ID, letting you deep dive into their activity.