Matomo MCP. Query Visitor Behavior and Site Performance Instantly
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Matomo connects your open-source web analytics data to any AI agent. It lets you query website traffic, user behavior, goal completions, and content performance using natural language.
Instead of clicking through dashboard tabs, simply ask your agent for a visit summary or list the top referring sites.
What your AI agents can do
Get goals
Retrieves the full list of conversion goals configured in your Matomo instance.
Get live last visits
Fetches a real-time view of the most recent visitor activity on your site.
Get site details
Retrieves general metadata and configuration details for a specific website within Matomo.
Get aggregated metrics covering total visits, actions taken, and bounce rates across the entire website.
View the latest details and actions of visitors in real-time as they interact with your site.
Determine which pages receive the most visits, along with the websites or social networks driving that traffic.
Pull a complete behavioral profile and history for any specific visitor ID you provide.
List all configured conversion goals within Matomo to verify tracking setup and current status.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Matomo MCP Server: 10 Tools for Web Analytics Tracking
Analyze goals, track visits, measure user behavior, and audit site performance using ten specialized tools in the Matomo MCP Server.
019d75d0get goals
Retrieves the full list of conversion goals configured in your Matomo instance.
019d75d0get live last visits
Fetches a real-time view of the most recent visitor activity on your site.
019d75d0get site details
Retrieves general metadata and configuration details for a specific website within Matomo.
019d75d0get top pages
Gets a list of the most visited pages on your site over the defined period.
019d75d0get top referrers
Identifies and lists the top types of websites that are sending traffic to your domain.
019d75d0get top socials
Retrieves a list of the most successful social media networks driving visits to your site.
019d75d0get top websites
Pulls data on the top referring websites, showing where external traffic originates.
019d75d0get visitor profile
Generates a detailed behavioral profile and history for an identified visitor ID.
019d75d0get visits summary
Provides a high-level summary of overall site visits, actions, and bounce rates.
019d75d0list sites
Queries Matomo to list all distinct websites configured under your account.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Matomo, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You connect your Matomo analytics instance right into your AI agent, so you never gotta open another tab just to check traffic. You talk to your agent and it pulls all the raw data—visits, actions, user behavior—straight from your live site metrics. This server lets you stop clicking through dashboards and start asking questions.
You can first run list_sites to query Matomo and get a list of every distinct website configured under your account. Then, you'll use get_site_details to pull general metadata and configuration details for any specific site within that setup.
Overall Traffic Health
You start by getting the big picture with get_visits_summary, which gives you a high-level summary of total visits, core actions taken across the site, and what your bounce rates look like. When you need to know what’s happening right now, use get_live_last_visits to fetch a real-time view of visitor activity; it shows you the latest details and actions from people interacting with your site as they go.
You can also check all your tracking setup by running get_goals, which retrieves the full list of conversion goals configured in Matomo, letting you verify status and current setup.*
Content & Source Performance
You wanna know what content's actually hitting? Use get_top_pages to get a solid list of the most visited pages on your site over any defined time period. To figure out where that traffic is coming from, you can run several reports: get_top_websites pulls data listing top referring websites, showing exactly where external traffic originates; meanwhile, get_top_referrers identifies and lists the top types of websites sending traffic to your domain.
For social media sources, use get_top_socials; it retrieves a list detailing the most successful social networks driving visits to your site.
Deep User Auditing
If you gotta audit one user, get_visitor_profile generates a detailed behavioral profile and history for any specific visitor ID you give it. It's a complete look at that person’s journey through the site. For general insights into who's visiting, you can use get_top_referrers to see broad source types, or if you want to know where traffic comes from by specific domain, run get_top_websites.
These tools let your agent give you a complete picture of both macro trends and micro behavior.
How Matomo MCP Works
- 1 Subscribe to the server, then provide your Matomo URL, Token Auth, and Site ID.
- 2 Your AI agent sends a natural language query (e.g., 'What are the top 5 pages?').
- 3 The MCP Server runs the necessary tool call (
get_top_pages) and returns structured data to your agent for immediate use.
The bottom line is, you get clean, actionable web analytics data delivered directly into your conversation flow.
Who Is Matomo MCP For?
This is built for the SEO specialist who's tired of jumping between Google Search Console and Matomo dashboards. It’s also for product managers needing quick validation on user funnels, or data analysts who need to test hypotheses instantly without writing SQL queries.
Uses the server to check get_top_referrers and get_top_socials quickly. They want to know exactly where traffic is coming from so they can build better backlinks.
Asks for a get_visits_summary followed by a detailed check using get_visitor_profile. They need to see if users are hitting key conversion pages or dropping off somewhere unexpected.
Uses the server to list all sites (list_sites) and then run targeted queries like get_goals to verify that tracking for new campaigns is active.
What Changes When You Connect
- Stop manually cross-referencing data. You get an immediate
get_visits_summaryin your chat, telling you the total visits and actions without opening a single dashboard tab. - Deeply understand user paths using
get_visitor_profile. Instead of guessing why people leave, you can see their precise journey and history on your site. - Pinpoint content gaps by running
get_top_pagesand comparing that data against the conversion goals listed byget_goals. This shows you what's popular versus what converts. - Figure out where your traffic is really coming from. Use
get_top_referrersto see if a major increase in visits is actually due to organic search or a specific partner site. - Track live activity without delay. The
get_live_last_visitstool lets you monitor what's happening on the site right now, which is crucial for checking campaign launches.
Real-World Use Cases
Figuring out a sudden drop in traffic
The marketing manager notices fewer visits than last week. They ask their agent, 'What changed?' The agent runs get_visits_summary and then checks get_top_referrers. It reveals that the primary source of traffic (a key partner site) stopped sending referrals two days ago.
Optimizing a landing page
A product owner suspects users are leaving before seeing the pricing. They ask for a get_visitor_profile for several IDs who landed on that page. The agent shows them that these visitors consistently click away from the 'Features' section, identifying where the content needs fixing.
Verifying campaign setup
The data analyst just launched a new lead magnet and wants to know if it’s working. They run get_goals first, confirming the goal is active. Then they ask for a summary, seeing an uptick in visits that matches their launch timeline.
Reviewing site structure
A new team member needs to know what content exists. They use list_sites first to see all configured domains, then run get_top_pages to give them a quick overview of the most important assets.
The Tradeoffs
Treating it like a simple search
Asking the agent: 'Tell me everything about my site.' This is too vague and forces multiple, unspecific calls.
→
Be specific. Instead of general queries, combine tools: 'Give me the get_visits_summary for today, but also tell me what the get_top_socials are showing.'
Over-relying on one tool
Only using get_top_pages. This tells you what pages people see, but not why they left or what the overall success rate is.
→
Always pair content review with goal tracking. Use get_top_pages to find a page, then ask about its conversion potential using get_goals.
Assuming real-time data
Expecting perfect, second-by-second updates for historical reports.
→
Understand the scope. Use get_live_last_visits for true real-time checks; otherwise, rely on the aggregated data from tools like get_top_websites.
When It Fits, When It Doesn't
Use this server if your goal is analyzing historical or current web performance metrics (e.g., 'Why did traffic drop?' or 'What's our best content?'). It’s perfect for validating marketing hypotheses against real user data.
Don't use it if you need to manage the site itself, change tracking codes, or access raw database records outside of Matomo's API. For that, you need a developer console or direct database query tool. If you just want general business intelligence and not web traffic metrics, look at CRM-type data connectors instead.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Matomo. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Manually checking site performance is a time sink.
Today, figuring out basic site health means opening Matomo. Then you click to the 'Summary' tab for total visits. Next, you might switch tabs to check conversion goals and then open another report to see which pages are performing best. You copy data from one dashboard into a spreadsheet, just to look at it all together.
With this server, that whole process collapses into a single chat prompt. Your agent runs `get_visits_summary` alongside `get_top_pages`, giving you the metrics and context immediately. It’s faster than opening three browser tabs.
Matomo MCP Server gives you precise user data.
The manual steps that vanish include cross-referencing top pages against conversion goals, or comparing the list of all sites (`list_sites`) across different campaigns. You never have to jump between reports just to get a full picture.
It gives you an immediate view into user intent: Are people seeing what we want them to see? The agent runs `get_top_referrers` and tells you the source of that traffic, connecting performance directly to promotion.
Common Questions About Matomo MCP
How do I check my conversion goals using get_goals? +
You simply ask your agent to run get_goals. It returns a list of all the conversion points you have set up in Matomo, letting you verify if tracking is active for new campaigns.
Can I find out which pages are most popular with get_top_pages? +
Yes. Running get_top_pages pulls the list of your best-performing content, allowing you to see exactly what parts of your site draw the most attention from users.
What does get_visitor_profile do for a specific user ID? +
It builds a full behavioral history. You input a visitor ID, and the server returns everything that person has done on your site—every page view and action they took.
Is get_live_last_visits reliable for current traffic? +
It is designed for real-time monitoring. It fetches details about recent visitors, which is much more immediate than historical summary data from get_visits_summary.
How do I list all the websites connected to my Matomo account? Use list_sites. +
You ask the agent to use list_sites. It queries your entire instance and gives you a clean list of every distinct website ID configured in Matomo.
How do I use get_visits_summary to analyze traffic for a specific date range? +
You pass start and end dates as parameters. This lets your agent pull metrics for any time frame, not just today's data. Use this when you need to compare performance across months or quarters.
What happens if my Matomo Token Auth expires while using any tool? +
The connection fails immediately. You must update your token in the Vinkius Marketplace settings first. The server won't run queries until the credentials are validated and refreshed.
What does get_top_referrers show, and what types of sources are included? +
It lists your top referral categories. These include search engines, direct traffic, social media networks, and specific websites. It gives you a clear breakdown of where visitors came from.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
ANEEL Dados Abertos
Access the Brazilian National Electric Energy Agency (ANEEL) Open Data Portal to query electricity sector datasets, resources, and records.
LunarCrush (Social Intelligence for Crypto Assets)
Access real-time social intelligence for crypto assets — track Galaxy Scores, AltRank, and market sentiment directly from your AI agent.
Math Evaluation Engine
Stop LLMs from hallucinating math. Evaluate complex mathematical expressions and handle exact float rounding deterministically.
You might also like
DocuSign
Send documents for signature, manage envelopes, track signing status, and automate contract workflows with AI.
Dynamics 365 Finance & Operations
Equip your AI agent to manage enterprise resources, track sales orders, and monitor financial journals via the D365 F&O API.
Blockscout
Explore Ethereum-based blockchains directly from your AI agent. Query addresses, tokens, transactions, and smart contracts via Blockscout's open-source API.