# Contentsquare MCP for AI Agents MCP

> Contentsquare lets you audit your digital experience metrics directly through natural conversation. Your AI client can pull explicit site performance data, list demographic segments, and map out user journeys across your e-commerce platform without ever leaving your chat window. It's deep UX analytics on demand.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** ux-analytics, conversion-rate-optimization, digital-experience, user-behavior, customer-journey

## Description

Managing a complex website means constantly jumping between dashboards to figure out why conversion rates dipped or where users are getting stuck. This MCP connects your AI agent directly to Contentsquare’s full suite of digital experience and user behavior metrics. You can talk about your site's performance, and the tool pulls the raw data for you.

The platform lets you do much more than just check bounce rates. Your agent can map out exactly which URLs users hit, validate specific audience segments against global standards, or even attach offline data—like sales records—to a user’s active session history. If you're using Vinkius, this MCP gives your AI client access to thousands of other services, making it one place for all your site analytics needs.

Instead of spending hours building reports and stitching together different views, you ask questions like, 'Show me the engagement metrics for users who came from Instagram last month,' and get a detailed answer instantly. It’s about getting actionable insights without ever writing an API query or navigating complex menus.

## Tools

### list_projects
Finds all the active UX tracking domains available within your Contentsquare account.

### get_metrics
Pulls explicit site metrics, including bounce rates and overall engagement percentages.

### list_segments
Provides a list of demographic data sets used to classify user behavior globally.

### list_mappings
Discovers the exact routing paths that structure your website's URLs.

### list_zonings
Inspects deep interaction areas, such as click tracking zones and heatmap coordinates.

### create_export_job
Starts an automated job to extract raw data chunks for later retrieval.

### get_export_job
Checks the current execution status of a previously started data export job.

### list_export_jobs
Retrieves a list of all historical and pending raw data extraction jobs.

### get_page_metrics
Executes targeted queries to get specific statistical bodies for single, defined page URLs.

### enrich_session
Adds external business attributes, like sales or contact logs, directly into a live user session record.

## Prompt Examples

**Prompt:** 
```
Give me a breakdown of bounce rates and conversion rates for my main website last week.
```

**Response:** 
```
**Site Performance Metrics: Last Week (Jan 1 - Jan 7)**

| Metric | Value |
| :--- | :--- |
| **Engagement** | 65% |
| **Bounce Rate** | 32% |
| **Conversion Rate** | 4.5% |

The performance was stable compared to the previous week, suggesting marketing efforts are maintaining baseline traffic quality.
```

**Prompt:** 
```
What demographic groups performed best on the product pages?
```

**Response:** 
```
*Segment Analysis:* 

We analyzed your top-performing user segments:
*   **Age Group 25–34:** Highest engagement (78%) and conversion rate. They are most active in viewing category pages.
*   **Region: Pacific Northwest:** Strong purchase intent, though bounce rates are slightly higher on mobile devices.

I recommend focusing UX improvements on the mobile experience for this region.
```

**Prompt:** 
```
Can you check if the 'FAQ' page metrics differ from the main product listing page?
```

**Response:** 
```
**Metrics Comparison: FAQ vs. Product Listing**

*   **Product Page (URL: /product/abc):** Bounce Rate 28% | Engagement 71% |
*   **FAQ Page (URL: /faq):** Bounce Rate 45% | Engagement 55% |

The FAQ page shows a significantly higher bounce rate, suggesting users are arriving there and leaving quickly without finding the answer. This indicates content clarity issues.
```

## Capabilities

### Audit Site Performance Metrics
Retrieves key performance indicators like engagement and bounce rates for your entire digital property.

### Analyze User Groups and Segments
Accesses pre-defined demographic data to classify user behavior and validate specific audience segments across different regions.

### Map Website Navigation Paths
Discovers the routing tree for every URL on your site, allowing you to audit how users move through key pages.

### Extract Raw Behavioral Data
Triggers automated data pipelines that extract raw session or pageview chunks, feeding them directly into external BI tools.

### Enhance User Session Data
Appends external business attributes, such as sales logs or contact information, to a user's live interaction history for deeper context.

## Use Cases

### Diagnosing Funnel Drop-Offs
A product manager notices a drop in conversions. They ask their agent to analyze `list_zonings` and compare the results against standard demographic segments (`list_segments`) to pinpoint which user group is abandoning checkout.

### Validating Marketing Campaigns
A digital marketer needs to know if a specific campaign landing page performed well. They query `get_page_metrics` for the exact URL and compare those results with general site metrics using `get_metrics`.

### Integrating CRM Data into Analytics
A data analyst wants to connect observed web behavior to actual revenue. They use `enrich_session` to attach sales logs from the CRM system directly to the session record for accurate attribution modeling.

### Preparing Custom Datasets
An analyst needs a massive, clean dataset for external machine learning models. They ask the agent to `create_export_job` for all sessions from last quarter and then monitor it using `list_export_jobs`.

## Benefits

- Get instant site performance data: Instead of building a report, ask your agent to pull explicit metrics like bounce rates or engagement figures using the `get_metrics` tool.
- Deepen context with session enrichment: Use `enrich_session` to append sales records or contact logs directly to user sessions, giving you full purchase-to-behavior visibility.
- Audit site structure easily: The agent can map out routing trees for your URLs via `list_mappings`, letting you audit the entire digital experience path without guesswork.
- Run complex data pipelines on demand: Initiate raw exports using `create_export_job` and check their status with `get_export_job`—all through simple conversation.
- Target specific page performance: You can run direct queries for exact document nodes against single URLs using `get_page_metrics`, skipping the noise of site-wide averages.

## How It Works

The bottom line is you get deep UX analytics answers via conversation instead of dashboard clicks.

1. Subscribe to this MCP and input your Contentsquare API credentials (Client ID, Secret, and Project ID) into the Vinkius platform.
2. Your AI agent uses these credentials to authenticate with Contentsquare's system via the MCP connection.
3. You ask a natural language question—like 'What were the bounce rates for mobile users last week?'—and your agent executes the necessary data calls and returns a formatted, ready-to-use answer.

## Frequently Asked Questions

**How do I use Contentsquare with my AI agent via the MCP?**
You connect your API keys to Vinkius, and then simply ask your AI client questions about user behavior. The tool handles all the complex data pulling so you get direct answers instead of spending time in dashboards.

**Can this Contentsquare MCP help me find out why my sales dipped?**
Absolutely. You can ask your agent to cross-reference general site metrics with external data, like attaching recorded sales logs to user sessions, which helps pinpoint the exact moment and context of a revenue dip.

**Is Contentsquare MCP better than just exporting raw data?**
It’s complementary. While you can export raw data using `create_export_job` for deep science work, this MCP provides instant, actionable summaries first. You ask the question, get the answer; then, if needed, you trigger a full dataset extraction.

**What kind of user segments can Contentsquare MCP analyze?**
It accesses standard API demographic directories to classify users by location, device type, and general behavioral patterns. This lets you validate specific audience groups against your product goals in natural language.

**Does the Contentsquare MCP cover all my website URLs?**
The agent can discover your routing paths using `list_mappings`, showing you the full structural map of your site. This confirms which URLs are accessible and ensures no critical pages are being overlooked.