# Simple Analytics MCP

> Simple Analytics provides privacy-first web analytics that fetch aggregated site statistics without using cookies. Use this MCP to pull visitor counts, export raw data points for deep analysis, and manage multiple domains directly from your AI agent.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** web-analytics, privacy-focused, cookieless, real-time-stats, data-export, traffic-monitoring

## Description

This connector lets you run clean, simple web analytics right through your AI client. You get stats on pageviews and unique visitors while maintaining user privacy because it doesn't track individual users or use cookies. Instead, you can ask your agent to check campaign performance across several domains or pull raw data points for a BI tool without ever leaving your chat window. Need to monitor backend actions? You can send custom events directly from your server through the MCP, tracking conversions in real time. When you connect this Simple Analytics MCP via Vinkius, your AI client becomes an instant analytics dashboard, letting you manage and analyze your entire web footprint using natural language queries.

## Tools

### send_server_event
Submits a custom event or pageview directly from your backend server for tracking purposes.

### get_stats
Gets aggregated statistics, such as total visitors and pageviews, for any specific domain.

### add_website
Adds a new website tracking source to your account, which requires a paid plan.

### export_datapoints
Retrieves raw data points that are not summarized or sampled for deep, custom analysis.

### list_websites
Shows a complete list of every website domain associated with your account.

## Prompt Examples

**Prompt:** 
```
Get the visitor count for example.com for the last 30 days.
```

**Response:** 
```
I've retrieved the stats for example.com. In the last 30 days, you had 1,240 unique visitors and 3,100 total pageviews. Would you like to see a breakdown by day?
```

**Prompt:** 
```
List all the websites I have registered in Simple Analytics.
```

**Response:** 
```
You currently have 3 websites registered: 'example.com', 'blog.mysite.io', and 'app.dashboard.net'. Which one would you like to analyze?
```

**Prompt:** 
```
Add a new website 'newproject.com' and set its timezone to 'Europe/London'.
```

**Response:** 
```
Successfully added 'newproject.com' to your account with the Europe/London timezone. You can now start sending data to this hostname.
```

## Capabilities

### Get Site Performance Metrics
Fetch aggregated statistics like total pageviews or unique visitor counts for any domain within a defined date range.

### Export Raw Data Sets
Retrieve non-sampled, raw data points that you can use for custom reports or complex spreadsheet modeling.

### Manage Multiple Websites
List all domains connected to your account or add entirely new websites and tracking sources.

### Track Backend Activity
Send custom events, like successful form submissions or key backend actions, directly from your server for immediate tracking.

## Use Cases

### Checking Quarterly Campaign Success
A marketing manager needs to know the visitor counts for five different campaign landing pages across three years. Instead of logging into five different dashboards, they ask their agent to run `get_stats` on all domains and export the results with `export_datapoints`, getting one consolidated file instantly.

### Monitoring Critical Backend Funnels
A developer needs to ensure that every successful payment action is logged for auditing. They use their code environment to call `send_server_event` directly through the MCP, ensuring the data hits the analytics platform immediately.

### Onboarding a New Client Site
A web developer needs to start tracking a new client project. They first use `list_websites` to check existing domains, then run `add_website` to register the new domain and begin monitoring its traffic.

### Auditing Site Reach
A data analyst suspects certain parts of their site aren't being tracked. They use `list_websites` to verify all connected domains, then run a comprehensive query using `get_stats` across the entire network for specific periods.

## Benefits

- Stop jumping between dashboards. You can ask your agent to get stats for multiple sites, review the results, and then tell it to list all connected domains—all in one conversation.
- When you need deep analysis, use `export_datapoints` to pull raw data sets that are perfect for feeding into spreadsheets or BI tools without manual effort.
- It keeps your users private. This MCP provides analytics insights based on aggregate numbers, so you don't have to worry about tracking individual cookies or user IDs.
- Need to track actions beyond simple pageviews? You can use `send_server_event` to log specific backend actions, like successful checkout attempts, right from your code base.
- Setting up new campaigns is fast. Use `add_website` to instantly add a domain and start tracking traffic without needing manual setup in separate platforms.

## How It Works

The bottom line is that you get professional-grade web analytics insights without ever opening a dashboard or running manual reports.

1. First, subscribe to this MCP and provide your Simple Analytics API Key.
2. Next, tell your AI client exactly what data you need—for example, 'show me the visitor count for last month.'
3. Your agent executes the request using the connection, pulling the relevant statistics or raw data into a clean response.

## Frequently Asked Questions

**How does Simple Analytics MCP handle user privacy?**
It provides analytics without tracking users or using cookies. It focuses on aggregated statistics (like total visitors) rather than individual, personal browsing behavior.

**Can I get raw data from the Simple Analytics MCP?**
Yes. Use `export_datapoints` to retrieve non-sampled, raw data sets. This is perfect if you need deep analysis or custom reporting that requires the original numbers.

**What do I use for tracking events outside of pageviews?**
Use `send_server_event`. This tool lets you track specific actions, like a form submission or button click, directly from your server code into the analytics system.

**Does Simple Analytics MCP require me to manually add every site?**
You can manage this using `list_websites` to check what's connected. If a domain is missing, you must use `add_website` first before tracking will work.

**Can I query stats for multiple domains at once with Simple Analytics MCP?**
Yes, your agent can handle this complex request. You simply ask it to run `get_stats` across a list of domains and compare the results in one output.

**Can I see how many visitors my site had last week?**
Yes! Use the `get_stats` tool with your domain and set the `start` parameter to 'today-7d'. Your agent will return aggregated visitors and pageviews for that period.

**Is it possible to export raw data for custom analysis?**
Absolutely. The `export_datapoints` tool allows you to retrieve raw, non-sampled data points in JSON or CSV format, provided you have your User-Id configured.

**Can I track events that happen on my server, like a successful payment?**
Yes, use the `send_server_event` tool. You can specify the event name, hostname, and even include custom metadata to track backend conversions without any client-side scripts.