# Matomo MCP for AI Agents AI Agent Connect > Matomo MCP lets you query your web analytics directly from your AI agent. Track visits, monitor real-time traffic, and analyze user behavior without leaving your chat interface. It connects your Matomo instance to tools like Claude or Cursor so you can ask questions about your site's performance in plain English. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_oYWxdQG5Apb39ZR5fQLt5E0cTSRcuy6MLVvC6uIb/ai-agent-connect - **Tags:** web-analytics, privacy-focused, user-behavior, real-time-monitoring, conversion-tracking ## Description You're tired of jumping between browser tabs to figure out why your traffic dropped or which pages are actually converting. This Connector changes that by bringing your Matomo data straight into your AI client. Instead of digging through complex dashboards, you can just ask your agent to summarize today's visits or tell you which social networks are driving the most traffic. It handles the heavy lifting of pulling metrics, so you can focus on making decisions. When you connect your instance through the Vinkius catalog, you get a direct line to your web analytics. You can dig into specific visitor profiles to see how people actually move through your site or check your goal tracking to see if your latest campaign is hitting the mark. It turns your analytics into a conversation, letting you spot trends and anomalies as they happen rather than waiting for a weekly report to land in your inbox. ## Tools ### get_site_details Get the specific configuration details for any site in your Matomo account. It helps you manage multiple properties easily. ### get_top_pages Find out which URLs are your heavy hitters. This helps you see what content is actually resonating with your audience. ### get_top_referrers See where your traffic is coming from by type. It tells you if you're getting more hits from search, social, or direct links. ### get_top_socials Identify which social networks are driving the most engagement. This is key for deciding where to spend your ad budget. ### get_top_websites Find the specific domains sending you the most traffic. Use this to identify your biggest referral partners. ### get_visitor_profile Pull up the full history of a single visitor. It lets you see the exact path a specific user took through your site. ### get_visits_summary Get a high-level overview of your traffic metrics. This is the quickest way to see how your site performed over a period. ### get_goals Review all the conversion goals you've set up. This lets you check if your primary KPIs are being met. ### get_live_last_visits See who is on your site right now. It gives you a real-time look at current visitor activity. ### list_sites See every website connected to your Matomo account. It helps you switch between different properties quickly. ## Prompt Examples **Prompt:** ``` How many people visited the site today and what was the bounce rate? ``` **Response:** ``` Here is the summary for today: * **Total Visits**: 1,432 * **Average Actions**: 4.2 * **Bounce Rate**: 42% Traffic is up about 10% compared to yesterday. ``` **Prompt:** ``` Which social media platforms are sending us the most traffic right now? ``` **Response:** ``` Your top referring social networks are: 1. **X (Twitter)**: 450 visits 2. **LinkedIn**: 320 visits 3. **Facebook**: 180 visits LinkedIn has seen the highest growth in the last hour. ``` **Prompt:** ``` Can you show me the profile for visitor ID 99283? ``` **Response:** ``` I've pulled the history for visitor 99283. * **First Visit**: Oct 24, 2023 * **Pages Viewed**: Home, Pricing, About Us, Contact * **Last Action**: Clicked 'Book a Demo' * **Total Actions**: 6 This user seems highly engaged with the pricing and demo flow. ``` ## Capabilities ### Get a summary of all visits Get a high-level overview of your traffic metrics in one request. ### Watch live visitor activity See who is on your site right now and what they are doing. ### Identify top pages Find out which URLs are getting the most traffic from your audience. ### See top referring websites Identify the specific domains sending you the most users. ### Look up detailed visitor history Pull up the full behavior history for a specific visitor ID. ### Check conversion goals List and monitor the goals configured in your Matomo instance. ## Use Cases ### Traffic Drop Diagnosis A marketing manager notices a dip in sales. They ask their agent to check get_top_referrers to see if a major partner link broke. ### Campaign Evaluation A growth lead wants to know if a social blast worked. They use get_top_socials to see if the traffic from that specific platform is actually landing. ### User Path Analysis A UX designer wants to know why people are dropping off. They use get_visitor_profile to see the exact steps a specific user took before leaving. ### Site Audit A web owner with 20 sites needs a quick status check. They use list_sites and get_visits_summary to see which properties are active today. ## Benefits - Stop tab switching by getting visit summaries directly in your chat. Use get_visits_summary to see your daily numbers instantly. - Spot traffic spikes immediately with get_live_last_visits. You can see what's happening on your site the second it happens. - Find your best content faster using get_top_pages. It tells you exactly which pages your audience loves most. - Identify your best referral sources with get_top_websites. You can see which partners are actually sending you high-quality traffic. - Analyze specific user journeys with get_visitor_profile. It takes the guesswork out of understanding how people use your site. - Monitor your KPIs with get_goals. You can quickly check if your conversion targets are being hit without digging through menus. ## How It Works The bottom line is you get instant answers to web analytics questions without ever opening a browser tab. 1. Subscribe to the Matomo MCP on Vinkius. 2. Enter your Matomo URL, Token Auth, and Site ID. 3. Start querying your web analytics from Claude, Cursor, or any MCP-compatible client. ## Frequently Asked Questions **Can I use the Matomo MCP to see my website traffic in real-time?** Yes, you can. The Connector includes a tool that lets your agent see live visitor details and actions as they happen. This means you can monitor your site's activity instantly without refreshing a dashboard. **Does the Matomo MCP work with my existing analytics account?** It does. You just need to connect your existing Matomo URL, Token Auth, and Site ID. It works directly with the data you already have in your instance. **Can I ask my AI agent to find my best-performing pages?** Yes, you can. You can ask questions about your most visited pages, top referrers, and social networks. Your agent will pull that data from Matomo and summarize it for you. **How do I see if my marketing goals are being met using Matomo?** You can ask your agent to list and monitor your conversion goals. It will pull the current status of your configured goals so you can see if your KPIs are hitting their targets. **Is the Matomo MCP good for tracking specific user behavior?** It is. You can ask your agent to pull a detailed profile for a specific visitor ID. This shows you their history and the specific actions they took on your site. **Can I manage multiple websites with this Matomo MCP?** Yes, you can. The Connector can list all sites in your Matomo account and get details for specific websites, making it easy to query different properties from one place. **How do I find my Matomo token_auth?** Log in to Matomo, go to Personal > Security, and find the 'Auth tokens' section to generate or copy your token. **Can I track multiple sites?** Yes, but this integration currently requires a specific Site ID. You can list all sites using the `list_sites` tool to find the correct ID. **Is my analytics data secure?** Absolutely. Your token_auth is encrypted at rest and injected securely at runtime.