# Matomo MCP for AI Agents AI Agent Connect

> Matomo lets you query your website analytics directly through your AI agent. You can pull traffic summaries, track custom events, and grab processed reports without leaving your workspace. It turns your analytics data into a conversational experience for better decision making.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_FsRrwfavS2xRx1njKwXMHoEJtqrlaHQYlA74EPOZ/ai-agent-connect
- **Tags:** web-analytics, visitor-tracking, conversion-optimization, data-visualization, privacy-focused

## Description

Imagine you're trying to figure out why a specific landing page isn't converting. Usually, you'd have to open a new tab, log into a dashboard, filter by date, and hunt for the right metric. With this Connector, you just ask your agent. It pulls the data from your Matomo instance and gives you the answer immediately. You can check how many people visited a page, see what actions they took, or even grab a full report on a specific site ID. If you're managing multiple properties, it handles those too. It's a huge shift from manual data pulling to instant insights. You can find this in the Vinkius catalog to get your analytics connected to your favorite tools. It makes the data useful instead of just sitting in a dashboard. You no longer have to be a dashboard expert to get the numbers you need for your next meeting.

## Tools

### track_bulk
Send multiple tracking requests in a single batch. This optimizes data ingestion for high-volume tracking needs.

### track_action
Track a page view, event, or ecommerce action in Matomo. Use this to log specific user interactions like button clicks.

### get_visits_summary
Retrieve metrics like total visits, actions, and bounce counts. It's the fastest way to get a high-level site overview.

### get_wp_processed_report
Get a processed report specifically via the WordPress REST API. This is the best way to pull data for WordPress sites.

### get_image_graph
Generate static PNG graph data for a specific site and period. Use this to get a visual look at your traffic trends.

### get_processed_report
Return a full data set including metadata and processed metrics. This provides a human-readable report for any site.

### get_report_metadata
List all available API functions and their metadata. This helps you see every report option for your specific instance.

## Prompt Examples

**Prompt:** 
```
How many people visited site 1 in the last week?
```

**Response:** 
```
I've pulled the summary for Site 1. Here are the numbers for the last 7 days:

| Metric | Value |
| :--- | :--- |
| **Total Visits** | 12,450 |
| **Actions** | 38,200 |
| **Bounce Rate** | 28.5% |

Would you like me to break these down by device or source?
```

**Prompt:** 
```
Track a click on the 'Sign Up' button for site 2.
```

**Response:** 
```
Done. I've recorded the 'Sign Up' button click for Site 2. I can also track other interactions like 'Pricing Page' views or 'Checkout' starts if you need.
```

**Prompt:** 
```
Show me the report for site 5 for today.
```

**Response:** 
```
Here is the processed report for Site 5 for today:

* **Total Visits:** 450
* **Total Actions:** 1,200
* **Top Referrers:**
  * Google
  * Direct Entry
  * Twitter

Let me know if you want to see the breakdown for any specific source.
```

## Capabilities

### Record page views
Send page view data to your analytics instance automatically.

### Batch track events
Send multiple tracking requests at once to handle high-volume data.

### Fetch visit summaries
Get a quick overview of total visits, actions, and bounce rates.

### Generate full reports
Pull human-readable data sets for specific sites and time periods.

### Retrieve graph data
Get static PNG images of your traffic graphs for visual context.

### Query WordPress stats
Access processed reports specifically via the WordPress REST API.

### Explore report types
See all available API reports and functions for your specific site.

## Use Cases

### Verifying a new promo link
A marketing lead wants to know if a new promo link was clicked. They ask the agent to record the action using `track_action`.

### Debugging a tracking pixel
A developer needs to know if a specific event is firing on a new page. They ask the agent to verify the output.

### Automating weekly site audits
An analyst needs a weekly report for 5 different sites. They ask the agent to pull `get_processed_report` for all of them.

### Visualizing traffic spikes
A product manager wants to see a graph of traffic spikes. They ask the agent to fetch the data from `get_image_graph`.

## Benefits

- Handle high-volume data ingestion efficiently by batching requests with `track_bulk`.
- Pull WordPress-specific reports easily with `get_wp_processed_report`.
- Get full site audits quickly to see what's working for your users.
- Skip the dashboard navigation by asking for specific metrics in plain text.
- Visualize trends directly in your chat for quick visual checks.
- Log custom user behaviors instantly for better conversion tracking.

## How It Works

The bottom line is you get instant answers to complex analytics questions without opening a dashboard.

1. Subscribe to the Matomo MCP in your preferred AI client.
2. Provide your Matomo Instance URL and your Auth Token.
3. Ask your agent questions about your website traffic or specific events.

## Frequently Asked Questions

**Can Matomo MCP track my website's conversion rates?**
Yes. You can ask your agent to pull specific reports or summaries that include your conversion metrics. It pulls the data directly from your instance so you get the most current numbers.

**How do I connect Matomo to my AI agent?**
Once you subscribe to the Connector, you just need to provide your Matomo Instance URL and your Auth Token. Your agent will then be able to talk to your data directly.

**Can I use Matomo MCP to see my WordPress stats?**
Yes. This Connector includes a specific way to pull processed reports via the WordPress REST API, making it easy to get your CMS data in a readable format.

**Does Matomo MCP support bulk tracking for high traffic?**
It does. You can send multiple tracking requests in a single batch. This is the best way to handle high-volume data without hitting performance limits.

**Can I get visual graphs of my traffic?**
Yes. Your agent can fetch static PNG graph data from your instance. This lets you see visual trends right in your chat window.

**Is Matomo MCP good for tracking custom user events?**
It's perfect for that. You can tell your agent to log specific actions like button clicks, form submissions, or custom events as they happen on your site.

**How do I get a summary of visits for a specific site?**
Use the `get_visits_summary` tool. Provide the `idSite`, the `period` (day, week, month, etc.), and the `date`. The agent will return metrics like total visits, actions, and bounce counts.

**Can I track custom events like button clicks via the AI?**
Yes! Use the `track_action` tool. You can specify parameters like `e_c` (Event Category), `e_a` (Event Action), and `e_n` (Event Name) to record interactions directly into Matomo.

**Is it possible to see which reports are available for my Matomo instance?**
Absolutely. Run the `get_report_metadata` tool for your `idSite`. It will list all available API functions, their descriptions, and the metrics they provide.