# Contentsquare MCP for AI Agents AI Agent Connect

> Contentsquare lets you pull UX analytics and site metrics directly into your AI agent. You can audit URL mappings, browse demographic segments, and trigger raw data exports for your BI tools without leaving your chat interface. It handles the heavy lifting of navigating the Contentsquare dashboard so you can focus on interpreting user behavior and optimizing conversion paths for your users.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_UWhKk6bQ5GAjzFbQe8ZMhSkHrxT56uc6tE1BFJW5/ai-agent-connect
- **Tags:** ux-analytics, conversion-rate-optimization, digital-experience, user-behavior, customer-journey

## Description

You spend half your day jumping between browser tabs to see why users are dropping off or where they're getting stuck. Instead of manually hunting through a dashboard to find a specific bounce rate or digging through complex heatmap coordinates, you can just ask your agent to do the work. This Connector connects your account to your AI client so you can query site metrics, explore audience segments, and audit URL paths through a simple conversation. If you need to get data into a spreadsheet or a data science pipeline, you can trigger raw data exports or check the status of those jobs while you move on to the next task. You can even enrich sessions with offline data like sales logs to see the full picture of the customer journey. Because Vinkius hosts this Connector, you get a reliable way to turn your UX data into actionable insights without the usual friction of manual data fetching. It's about getting the right numbers at the right time so you can actually make decisions based on what users are doing on your site. This means no more copy-pasting from one window to another. You get a direct line to your telemetry, allowing you to spot friction points in the checkout flow or identify which audience segments are responding best to your latest campaign changes. It turns your analytics into a conversational resource that lives where you already work.

## Tools

### list_projects
See all your bounded UX tracking domains within the Headless Contentsquare platform.

### get_metrics
Pull specific bounce and engagement metrics for your site.

### list_segments
Get JSON arrays of demographic limits and user behavior classifications.

### list_mappings
View the routing trees that structure your specific URL paths.

### get_export_job
Check the current status of your data science object extractions.

### list_export_jobs
See a list of all current and past raw export payloads.

### get_page_metrics
Get formatted statistical bodies for specific page URLs.

### enrich_session
Add offline attributes like sales or contact logs to live session arrays.

### list_zonings
Inspect internal interaction arrays to see specific click tracking zones.

### create_export_job
Start an automated raw data pipeline chunk export.

## Prompt Examples

**Prompt:** 
```
What's the bounce rate for our main landing page?
```

**Response:** 
```
The bounce rate for the 'Main Landing Page' is currently 34.2%. Here is a quick breakdown of engagement:

* **Engagement Score**: 65%
* **Conversion Rate**: 4.5%
* **Top Interaction Zone**: Hero Button

The performance is stable compared to last week.
```

**Prompt:** 
```
List the audience segments for the mobile app.
```

**Response:** 
```
I found 3 active demographic segments for the Mobile App:

1. **High Intent Users** (Mobile Only)
2. **Returning Customers** (iOS/Android)
3. **New Leads** (Android Only)

Which segment would you like to audit first?
```

**Prompt:** 
```
Can you start an export for yesterday's sessions?
```

**Response:** 
```
Export job initiated! Job ID: `export_abc123`. Contentsquare is now processing the raw session chunks for yesterday. I can check the status for you in a few minutes.
```

## Capabilities

### Pull site metrics
Get bounce rates and engagement numbers for specific pages.

### Browse audience segments
View demographic data and user behavior classifications.

### Audit URL paths
See how your site routes different paths and pages.

### Trigger data exports
Start raw data pipeline jobs for external analysis.

### Enrich session data
Add offline attributes like sales logs to live user interactions.

### Track page performance
Query specific document nodes for behavioral limits.

## Use Cases

### Identifying Checkout Friction
A UX researcher asks the agent to pull metrics for the checkout page and list zonings to see where users click most.

### Automating Weekly Reporting
A Product Manager asks the agent to get metrics for the last week and list projects to summarize site performance.

### Data Enrichment for CRM
A Data Analyst uses the agent to enrich sessions with sales logs to see which web paths lead to the highest revenue.

### Segment Behavior Audit
A Marketer asks the agent to list segments and get page metrics to see how different demographics interact with a new landing page.

## Benefits

- Stop manual dashboard hunting. Use `get_metrics` to pull bounce rates and engagement data instantly without clicking through multiple menus.
- Faster data science workflows. Use `create_export_job` to trigger raw data pipeline chunks directly into your external BI tools.
- Better audience clarity. Use `list_segments` to quickly browse demographic limits and classify user behaviors in seconds.
- Precise heatmap analysis. Use `list_zonings` to inspect interaction arrays and button zones without manual coordinate checking.
- Unified customer views. Use `enrich_session` to bind offline sales logs to live interaction blocks for a complete journey view.
- Rapid URL auditing. Use `list_mappings` to discover routing trees and verify how your site handles specific paths.

## How It Works

The bottom line is that you get a conversational interface for your entire Contentsquare UX analytics suite.

1. Subscribe to the Contentsquare MCP on Vinkius.
2. Input your Client ID, Client Secret, and Project ID from your Contentsquare Console.
3. Ask your AI client to pull metrics, list segments, or start a data export.

## Frequently Asked Questions

**Can I use Contentsquare MCP to see user behavior?**
Yes, you can use it to pull engagement metrics, browse audience segments, and inspect interaction zonings.

**How do I get site metrics into my AI agent?**
Once connected, you can simply ask your agent to pull metrics for specific URLs or projects.

**Can this Connector help with data exports?**
It can trigger raw data pipeline jobs and let you check the status of those exports directly in the chat.

**Can I see how my URLs are mapped?**
Yes, you can use it to discover the routing trees and URL paths within your Contentsquare account.

**Does it work for both web and mobile?**
It works for any bounded UX tracking domains you have set up in your Contentsquare platform.

**Can I add sales data to my user sessions?**
Yes, the enrich_session tool lets you bind offline attributes like sales or contact logs to your live session arrays.

**Can my agent export raw session data from Contentsquare?**
Yes. Use the 'create_export_job' tool with your desired date range and data type (sessions or pageviews). The agent will initiate the asynchronous extraction and provide you with a job ID to monitor the download status.

**How do I enrich an active session with offline sales data?**
Provide the session ID and a JSON object containing the properties you want to append. The 'enrich_session' tool will push these attributes directly to the active interaction block within the Contentsquare engine.

**Can I check the engagement metrics for a specific landing page URL?**
Absolutely. Use the 'get_page_metrics' tool. Provide the exact page URL and a date range. Your agent will return detailed statistical bodies including bounce rates and behavioral limits for that specific web document.