Matomo MCP. Deep web analytics insights on demand.
Matomo provides deep web analytics tracking by connecting your Matomo instance directly to your AI agent. Instead of clicking through complicated dashboards, you ask natural language questions—like 'What was our bounce rate last month?' or 'Did the pricing page conversion increase?' Your AI client retrieves processed reports, tracks specific actions, and summarizes site performance instantly.
Give Claude and any AI agent real-world access
Retrieve key numbers like total visits, actions taken, and bounce counts in one request.
Log page views, custom events, or e-commerce purchases when a visitor performs an action on your site.
Pull complete, processed data sets that include metadata and detailed metrics for deep analysis.
Discover every possible API report and function your Matomo instance supports without needing to consult documentation.
Streamline tracking by sending several page views or events in a single batch request.
Ask an AI about this
Waiting for input…
What AI agents can do with Matomo Alternative: 7 Tools for Analytics
Use these tools to get metrics, track actions, process full reports, or discover metadata from your Matomo instance directly through your AI agent.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Matomo MCPGet Image Graph
Generates a static PNG graph showing data for a specific site and time period.
Get Processed Report
Retrieves a full, human-readable report set containing both metadata and processed...
Get Report Metadata
Lists every available API function and its associated metadata for your entire...
Track Bulk
Sends multiple tracking requests (like page views or events) to optimize data...
Track Action
Records a single page view, event, or e-commerce action on your site using the...
Get Visits Summary
Retrieves core summary metrics like total visits, unique visitors, and bounce counts.
Get Wp Processed Report
Gets a processed report specifically through the WordPress REST API endpoint.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
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 each 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 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
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 CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The time spent clicking through dashboards is wasted time.
Right now, when you need to check how a new campaign performed, you open the dashboard, click 'Date Range,' select two dates, find the conversion rate tab, then manually export that data. If you want to compare it to last month, you repeat the whole process—multiple tabs, multiple clicks, copy-pasting numbers into a spreadsheet just to start analyzing.
With this MCP, you simply ask your agent for the comparison. It handles the API calls and returns the clean, comparative metrics right in the chat window. You get immediate answers without ever touching a dashboard GUI.
Matomo gives you full visibility using `get_report_metadata`.
Before this MCP, if your company added a new tracking feature or metric to Matomo, you had no way of knowing it was available unless someone manually told you. You were limited by the reports that were easy to find and export.
Now, you can ask your agent to discover all available API functions using `get_report_metadata`. It shows you every single capability your instance supports. You know exactly what data is out there.
What Matomo MCP does for your AI
Your web analytics data moves beyond static graphs and manual exports. By connecting your Matomo instance through Vinkius's catalog, you give your agent direct access to every piece of visitor information. You can ask your AI client for a comprehensive summary of total visits or specific details about how users interacted with a form.
It’s like having an expert data analyst sitting next to you who never needs coffee breaks. Instead of spending hours digging through complex dashboards, you simply ask the question—whether it's tracking a single event, getting metadata on available reports, or generating a full, human-readable summary for a specific time frame.
Your agent handles the API calls and returns actionable data directly into your workflow.
019e5d33-bfcf-7090-bdc4-303c424ac164 How to set up Matomo MCP
The bottom line is that you talk to it like talking to a person; your AI client handles all the complex database querying and report processing for you.
Subscribe to this MCP and provide your Matomo Instance URL along with an authentication token.
Select your preferred AI client, such as Cursor or Claude, and connect the agent via Vinkius.
Ask your agent a question using natural language, like 'What were our top referrers last week?' The agent executes the necessary tool calls to pull the data.
Who uses Matomo MCP
This MCP is built for anyone whose job involves understanding user behavior. It's perfect for data analysts who waste time manually exporting reports, marketing managers tracking campaign performance, or developers verifying complex tracking setups.
Pulls specific metrics and summaries instantly to build dashboards without running manual exports.
Tracks campaign performance, event conversions, and user flow in real time after launching a new ad campaign.
Verifies that tracking implementation is working correctly by running direct checks on event triggers or page views.
Benefits of connecting Matomo MCP
Stop digging through tabs. Instead of exporting massive files to manually check conversion rates, you can ask your agent for a detailed processed report and get the answer immediately.
Optimize tracking with track_bulk. If you need to simulate or log many events quickly, sending them in a batch request is faster than calling single-action tools repeatedly.
Know exactly what data is available. Use get_report_metadata to explore all possible reports your Matomo instance supports before writing a single query.
Get the high-level view without the clicks. The get_visits_summary tool gives you core metrics like bounce rates and total visits right away, perfect for quick status checks.
Validate tracking instantly. Developers can use track_action to verify if a specific page view or custom event is firing correctly before deployment.
Matomo MCP use cases
Investigating poor conversion rates
The Marketing Manager notices the checkout funnel stalled last month. They ask their agent, 'What was the bounce rate on the payment page?' The agent uses get_visits_summary and provides an immediate comparison to previous periods, pointing directly to a sudden spike in exits.
Pre-launch tracking setup
The Developer needs to ensure their new pricing widget tracks correctly. They use the agent's ability to call track_action repeatedly with test URLs and events, confirming that every trigger fires exactly as expected before going live.
Quarterly performance review
The Data Analyst needs a comprehensive overview of Q3. They prompt the agent to 'Generate the processed report for site 1 for the last quarter.' The agent uses get_processed_report and returns a clean, summarized data set ready for presentation.
Understanding technical limitations
The Developer isn't sure what metrics are available. They ask the agent to list all report metadata. The agent uses get_report_metadata and provides a checklist of every possible API function they can build upon.
Matomo MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Treating it like a simple database query
Trying to pull complex metrics by just asking for 'visits from Google.' This fails because the platform needs structured inputs and specific tools.
Don't try to write raw queries. Instead, ask your agent to use get_report_metadata first, then tell it to retrieve a summary using get_visits_summary. The MCP handles the complexity.
Manual dashboard comparison
Logging into Matomo's web interface multiple times just to compare bounce rates between two specific sites or time periods.
Just ask your agent for a processed report comparing those metrics. The MCP uses get_processed_report to pull and structure the data comparison in one go.
Ignoring bulk operations
If you have ten internal links you need to test, calling track_action ten separate times sequentially.
Use the track_bulk tool. It's designed for efficiency; it sends all your tracking requests simultaneously, saving time and ensuring optimal data ingestion.
When to use Matomo MCP
You should use this MCP if your primary job involves understanding why people visit your site—analyzing user behavior, correlating campaign spending to specific actions, or needing historical performance reports. This is the tool for deep-dive analytics and tracking validation.
Don't use it if you just need a simple list of names or basic contact information; that's a different data type entirely. Furthermore, don't use it if your primary goal is merely to view a visual graph when an image link will suffice—while get_image_graph exists, the value here is in the structured, actionable metrics provided by get_visits_summary and full reports.
Frequently asked questions about Matomo MCP
How do I use Matomo MCP to get the total number of visits? +
Use the get_visits_summary tool. This single call retrieves core metrics, giving you immediate access to total visits, unique visitors, and bounce counts without complex querying.
Can Matomo MCP track an event that happened on a specific page? +
Yes, use the track_action tool. You provide the required site ID and details about the event (like a page view or e-commerce action), logging it immediately for later analysis.
What is the best way to check my full historical performance? +
The get_processed_report tool is designed for this. It returns a complete, human-readable data set that includes both metrics and metadata, giving you maximum depth.
Does Matomo MCP support tracking multiple actions at once? +
Yes, the track_bulk tool is built for efficiency. It lets you send numerous tracking requests simultaneously, which is much faster than running individual calls.
How do I check what kind of reports Matomo supports? +
You use get_report_metadata. This function lists all available API functions and their metadata, so you always know the full scope of your analytics data.