# GoSquared MCP

> GoSquared MCP connects your AI agent directly to live web analytics data. Instantly check real-time visitor counts, track which pages people are viewing right now, or analyze historical performance from specific date ranges. Use this MCP to turn complex dashboards into simple answers for marketing campaigns and product strategy.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** web-analytics, real-time-traffic, visitor-tracking, marketing-insights, privacy-friendly

## Description

Need to know what’s happening on your site? This MCP lets you query your web analytics without logging into a dashboard. You can ask your AI client questions about visitor activity—for example, asking how many people are active right now or tracking which specific pages get the most views at any given time. If you want to look back, you can analyze historical trends for traffic sources, device types, and campaign effectiveness over months of data. It’s like having a dedicated web analyst available 24/7. Through Vinkius, your agent becomes an expert that processes raw analytics into simple, actionable answers right where you're working.

## Tools

### get_now_campaigns
Retrieves a list of active marketing campaigns currently driving web traffic to the site.

### get_now_overview
Provides an immediate, top-level count of all concurrent visitors on the website.

### get_now_pages
Lists every page that is actively being viewed by users at this moment.

### get_now_sources
Identifies and lists the active traffic sources, or referrers, sending visitors to the site right now.

### get_now_visitors
Generates a list of individual visitor IDs who are currently online on the platform.

### get_trends_browsers
Retrieves historical data detailing how traffic breaks down across different web browsers over time.

### get_trends_campaigns
Gathers performance metrics for marketing campaigns across specified date ranges.

### get_trends_devices
Provides historical analysis showing how traffic was distributed among various devices, like mobile or desktop.

### get_trends_overview
Generates an aggregate view of overall website metrics and activity over a specified time period.

### get_trends_pages
Retrieves historical data on page views, showing which pages were most popular in the past.

### get_trends_sources
Provides a detailed look at where website traffic originated over specific date ranges.

## Prompt Examples

**Prompt:** 
```
How many visitors are on the site right now?
```

**Response:** 
```
Checking real-time analytics... You currently have 142 active visitors on your site. 85 of them are actively engaging with the content.
```

**Prompt:** 
```
What were our top traffic sources yesterday?
```

**Response:** 
```
Retrieving trends... Yesterday, your top traffic sources were:
1. Google (Organic): 1,200 visits
2. Direct: 850 visits
3. Twitter / X: 420 visits
4. LinkedIn: 150 visits
```

**Prompt:** 
```
Tell me what percentage of visitors today are using mobile phones.
```

**Response:** 
```
Checking technology insights... So far today, 62% of your site traffic is originating from mobile devices, predominantly iOS.
```

## Capabilities

### Monitor Live Visitor Flow
Get immediate data on how many people are currently online and what pages they are interacting with.

### Analyze Past Performance Trends
Pull historical aggregate data to compare traffic sources, device breakdowns, or page views across different time periods.

### Track Campaign Impact
Determine how specific marketing campaigns are performing both in real-time and over extended date ranges.

### Identify Audience Behavior
Understand the technology used by your visitors, including detailed breakdowns of browsers and devices.

## Use Cases

### Investigating a Sudden Traffic Drop
A marketing manager notices site traffic dropped 30% yesterday. They ask the agent to run `get_trends_sources` for the last 48 hours, immediately pinpointing that organic search sources are down and directing their focus.

### Validating a New Feature Launch
A Product Owner needs proof of concept. They ask to analyze historical page view trends (`get_trends_pages`) specifically for the new feature's landing area over the past month, proving adoption rates.

### Checking Live Ad Performance
During a live event, an SEO specialist asks 'Are our paid ads working right now?' The agent uses `get_now_sources`, confirming that referral traffic from the ad platform is spiking.

### Preparing for Quarterly Reviews
A website owner needs a summary of site health. They ask for the historical overview (`get_trends_overview`) and device breakdown, providing executives with a single, data-rich report without manual clicking.

## Benefits

- Instantly assess campaign effectiveness. Use `get_now_campaigns` to see immediate impact, or `get_trends_campaigns` for long-term ROI tracking.
- Pinpoint user behavior with precision. Ask what pages are being viewed using `get_now_pages`, and then look back at the full picture with `get_trends_pages`.
- Know your audience's hardware. Understand if mobile or desktop users are driving traffic by checking historical device breakdowns via `get_trends_devices`.
- Identify immediate leaks in performance. Use `get_now_sources` to check for sudden drops in referred traffic, helping you correct issues fast.
- Simplify complex reports. Instead of pulling data from multiple sources, let your agent run a full historical overview using `get_trends_overview` and get one cohesive answer.

## How It Works

The bottom line is you ask a question in plain English, and your AI client uses this MCP to fetch the exact data point from your GoSquared account.

1. Subscribe to this MCP and provide your GoSquared Site Token and API Key in the Vinkius catalog.
2. Connect your preferred AI client (like Cursor or Claude) using the installed credentials.
3. Ask natural language questions, such as 'What were our top traffic sources last week?' The agent executes the necessary tool calls to deliver a direct answer.

## Frequently Asked Questions

**Can I use GoSquared MCP to see who visited my site right now?**
Yes, you can. Use `get_now_visitors` to retrieve a list of individual visitor IDs currently online, giving you a snapshot of the active audience.

**How do I check historical traffic sources with GoSquared MCP?**
You run the `get_trends_sources` tool. This pulls data showing where your traffic originated over specified date ranges, helping you analyze seasonal trends.

**Does GoSquared MCP only show current traffic?**
No. While tools like `get_now_overview` give real-time numbers, the MCP also includes all historical data functions, such as `get_trends_overview`, for long-term analysis.

**What is the best way to check campaign performance?**
Use `get_trends_campaigns` to analyze how campaigns performed across a specific timeline. You can also use `get_now_campaigns` for immediate checks.