# Contentsquare MCP

```json
{
  "name": "Contentsquare MCP",
  "slug": "contentsquare_mcp",
  "url": "https://composio.dev/toolkits/contentsquare_mcp",
  "markdown_url": "https://composio.dev/toolkits/contentsquare_mcp.md",
  "logo_url": "https://logos.composio.dev/api/contentsquare_mcp",
  "categories": [
    "analytics & data"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-09-01T05:38:38.881Z"
}
```

![Contentsquare MCP logo](https://logos.composio.dev/api/contentsquare_mcp)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Contentsquare MCP or direct API to fetch session replays, query funnel metrics, list top pages, and export custom reports through natural language.

## Summary

Contentsquare MCP is Contentsquare's hosted experience-analytics service for projects and metrics.
It helps teams measure user journeys, optimize funnels, and improve digital experiences.

## Categories

- analytics & data

## Toolkit Details

- Tools: 21

## Images

- Logo: https://logos.composio.dev/api/contentsquare_mcp

## Authentication

- **Dcr Oauth**
  - Type: `custom`
  - Description: Dcr Oauth authentication for Contentsquare MCP.
  - Setup:
    - Configure Dcr Oauth credentials for Contentsquare MCP.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List top pages by conversion rate
- Fetch session replays for checkout failures
- Export weekly funnel conversion report CSV

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `CONTENTSQUARE_MCP_COMPUTE_FUNNEL` | Computefunnel | Computes funnel analysis to measure drop-offs and conversions across key steps in a user journey. Analyzes conversion rates, drop-off points, and time to completion across up to 32 steps. |
| `CONTENTSQUARE_MCP_COMPUTE_IMPACT` | Computeimpact | Computes impact quantification analysis comparing conversion performance between segments. Provides metrics including conversion rates, bounce rates, session time, pageviews, and revenue impact with statistical significance testing. |
| `CONTENTSQUARE_MCP_COMPUTE_JOURNEY` | Computejourney | Computes user navigation journeys, visualizing how visitors navigate your site. Provides hierarchical tree structure showing common paths, drop-off points, and navigation patterns. Supports forward (from landing pages) and reverse (from exit pages) analysis up to 7 steps. |
| `CONTENTSQUARE_MCP_COMPUTE_PAGE_COMPARISON` | Computepagecomparison | Computes page comparison analysis comparing key performance metrics across multiple page groups (2-10). Provides metrics: views, bounce rate, exit rate, scroll rate, time spent, activity level, load times, and conversion rates. |
| `CONTENTSQUARE_MCP_COMPUTE_PAGE_GROUP_METRICS` | Computepagegroupmetrics | Compute page metrics, at the page group level. Use it to get an overview of the performance of the fraction of the website. |
| `CONTENTSQUARE_MCP_COMPUTE_SITE_METRICS` | Computesitemetrics | Computes aggregated metrics across the entire website. Returns data grouped by specified dimensions (device, date, browser, country, etc.). Filters: time period (startDateTime/endDateTime), device type (DESKTOP/MOBILE/TABLET/ALL), conversion goals (goalId), or advanced user filters (userFilter for browsers, goals, segments, page interactions). Use dimensions parameter to group results. Defaults to no grouping if not specified. |
| `CONTENTSQUARE_MCP_GET_PAGE_GROUPS_FOR_MAPPING` | Getpagegroupsformapping | Retrieve all page groups for a specific mapping, sorted alphabetically by name. |
| `CONTENTSQUARE_MCP_GET_TOP_ERRORS_BY_IMPACT_ON_GOAL` | Gettoperrorsbyimpactongoal | Get top errors ranked by impact on conversion goals. Shows business-critical errors affecting revenue and conversions. USE for: business impact analysis, revenue-critical issues, prioritizing fixes by business value, conversion impact of errors. Requires mappingId and goalId to analyze goal-specific impact. |
| `CONTENTSQUARE_MCP_GET_TOP_ERRORS_BY_MISSED_OPPORTUNITY` | Gettoperrorsbymissedopportunity | Get top errors ranked by missed business opportunities (eCommerce focused). Shows revenue impact of errors. USE for: eCommerce missed revenue opportunities, lost sales analysis, revenue impact of errors. Always uses goalId -1 for eCommerce analysis. Requires mappingId. |
| `CONTENTSQUARE_MCP_GET_TOP_ERRORS_BY_SESSIONS_WITH_ERRORS` | Gettoperrorsbysessionswitherrors | Get top errors ranked by sessions with errors. Main widget for general error analysis showing error trends, rates, and most frequent errors. USE for: general error questions, error trends, most frequent errors, volume comparisons, overall error patterns. This is the primary tool for error analysis. |
| `CONTENTSQUARE_MCP_GET_TOP_PAGE_GROUPS_BY_LOST_CONVERSIONS` | Gettoppagegroupsbylostconversions | Get page groups ranked by lost conversions due to errors. Shows business impact of errors by page groups. USE for: page group impact analysis, page-level conversions, top pages losing conversions, business impact by page groups. Requires mappingId and goalId to analyze conversion impact. |
| `CONTENTSQUARE_MCP_GET_TOP_PAGES_BY_SESSIONS_WITH_ERRORS` | Gettoppagesbysessionswitherrors | Get pages most affected by errors in a scatter plot comparing error volume with page traffic. USE for: identifying pages most affected by technical issues, development resource focus, scatter plot analysis of pages vs error rates. Supports both 'pagegroups' (default) for category-level analysis and 'pages' for detailed URL-level analysis. Requires mappingId parameter. |
| `CONTENTSQUARE_MCP_LIST_PROJECTS` | Listprojects | Returns a list of projects (id and name) accessible to the user |
| `CONTENTSQUARE_MCP_RECOMMEND_GOALS` | Recommendgoals | Recommend goals based on user engagement and usage frequency (how often goals are viewed, used in analyses, etc.) within the platform. |
| `CONTENTSQUARE_MCP_RECOMMEND_MAPPINGS` | Recommendmappings | Recommend mappings based on user engagement and usage frequency (how often mappings are viewed, used in analyses, etc.) within the platform. |
| `CONTENTSQUARE_MCP_RECOMMEND_PAGE_GROUPS` | Recommendpagegroups | Recommend page groups based on user engagement and usage frequency (how often page groups are viewed, used in analyses, etc.) within the platform. |
| `CONTENTSQUARE_MCP_RECOMMEND_SEGMENTS` | Recommendsegments | Recommend segments based on user engagement and usage frequency (how often segments are viewed, used in analyses, etc.) within the platform. A project with no recent engagement data falls back to the most recently updated segments instead. - This tool cannot page. When `total` exceeds `returned`, raise `limit` instead |
| `CONTENTSQUARE_MCP_SEARCH_GOALS` | Searchgoals | Search and retrieve goals for a project. |
| `CONTENTSQUARE_MCP_SEARCH_MAPPINGS` | Searchmappings | Search and retrieve mappings for a project. |
| `CONTENTSQUARE_MCP_SEARCH_SEGMENTS` | Searchsegments | Search and retrieve segments for a project, optionally filtered by name. - To find a segment by name, pass `text` rather than listing segments and scanning the result: the filter is applied before any row limit, so a filtered answer is complete even on a project too large to list. Pass one contiguous fragment of the name, not several words that may not be adjacent - NEVER describe a segment list as complete unless `offset` plus `returned` equals `total` — on a single call `offset` is 0, and while paging it is the position of the page in hand. `returned` counts one page, so on its own it reaches `total` only when the whole list fits in one - When a response carries `nextOffset`, pass it back as `offset` to read the next page; its absence means no further page can be read — which is not the same as having reached `total` - Every page of a large project costs a full read of it, so do not walk one in default-sized pages: narrow with `text` where the task allows it, and where the whole list is genuinely needed raise `limit` so it arrives in as few calls as possible |
| `CONTENTSQUARE_MCP_SUBMIT_MCP_FEEDBACK` | Submitmcpfeedback | Submit feedback about your MCP server experience. Help us improve by rating tools and sharing your thoughts! |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Contentsquare MCP Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Contentsquare MCP actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'YOUR_SPECIFIC_PROMPT_HERE'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Contentsquare MCP
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Contentsquare MCP tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('YOUR_SPECIFIC_PROMPT_HERE')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Contentsquare MCP Integration

- Supports both Contentsquare MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Contentsquare MCP data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Contentsquare MCP access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Contentsquare MCP
- Scoped, least privilege access to Contentsquare MCP resources
- Full audit trail of agent actions to support review and compliance

## Use Contentsquare MCP with any AI Agent Framework

Choose a framework you want to connect Contentsquare MCP with:

- [ChatGPT Work](https://composio.dev/toolkits/contentsquare_mcp/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/contentsquare_mcp/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/contentsquare_mcp/framework/hermes-agent)

## Related Toolkits

- [Firecrawl](https://composio.dev/toolkits/firecrawl) - Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.
- [Tavily](https://composio.dev/toolkits/tavily) - Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.
- [Exa](https://composio.dev/toolkits/exa) - Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.
- [Serpapi](https://composio.dev/toolkits/serpapi) - SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.
- [Peopledatalabs](https://composio.dev/toolkits/peopledatalabs) - Peopledatalabs delivers B2B data enrichment and identity resolution APIs. Supercharge your apps with accurate, up-to-date business and contact data.
- [Snowflake](https://composio.dev/toolkits/snowflake) - Snowflake is a cloud data warehouse built for elastic scaling, secure data sharing, and fast SQL analytics across major clouds.
- [Posthog](https://composio.dev/toolkits/posthog) - PostHog is an open-source analytics platform for tracking user interactions and product metrics. It helps teams refine features, analyze funnels, and reduce churn with actionable insights.
- [Ahrefs MCP](https://composio.dev/toolkits/ahrefs_mcp) - Ahrefs MCP is Ahrefs' hosted MCP server for SEO data and insights. Use it to access backlinks, organic metrics, keyword research, and competitor analysis.
- [Amplitude](https://composio.dev/toolkits/amplitude) - Amplitude is a digital analytics platform for product and behavioral data insights. It helps teams analyze user journeys and make data-driven decisions quickly.
- [Baremetrics](https://composio.dev/toolkits/baremetrics) - Baremetrics is a subscription analytics platform for recurring-revenue businesses. It helps teams track MRR, churn, customers, and revenue trends in one place.
- [Bing Webmaster Tools](https://composio.dev/toolkits/bing_webmaster_tools) - Bing Webmaster Tools is Microsoft's search console for site performance, crawling, indexing, URL submission, and verified site management. It helps site owners understand Bing Search visibility and fix issues that affect organic traffic.
- [Bread & Butter](https://composio.dev/toolkits/bread_butter) - Bread & Butter is a lead-intelligence and identity platform for website visitor tracking, user profiles, attribution, authentication, and conversion workflows. It helps teams understand who is visiting, where leads come from, and how users convert.
- [Bright Data MCP](https://composio.dev/toolkits/brightdata_mcp) - Bright Data MCP is an AI-powered web scraping and data collection platform. Instantly access public web data in real time with advanced scraping tools.
- [Browseai](https://composio.dev/toolkits/browseai) - Browseai is a web automation and data extraction platform that turns any website into an API. It's perfect for monitoring websites and retrieving structured data without manual scraping.
- [BSC Designer](https://composio.dev/toolkits/bsc_designer) - BSC Designer is a strategy execution platform for balanced scorecards, KPIs, dashboards, and strategy maps. It helps teams turn goals into measurable performance plans they can track over time.
- [Chameleon](https://composio.dev/toolkits/chameleon) - Chameleon is a product adoption platform for building in-app experiences, managing customer data, and analyzing user engagement. It helps teams improve onboarding, feature discovery, and product adoption with targeted user experiences.
- [Chartly](https://composio.dev/toolkits/chartly) - Chartly renders Chart.js configurations as PNG or SVG images and creates permanent chart URLs for sharing and embedding. Share and embed charts easily with stable image URLs and downloadable vector graphics.
- [ClickHouse](https://composio.dev/toolkits/clickhouse) - ClickHouse is an open-source, column-oriented database for real-time analytics and big data processing using SQL. Its lightning-fast query performance makes it ideal for handling large datasets and delivering instant insights.
- [ClickHouse MCP](https://composio.dev/toolkits/clickhouse_mcp) - ClickHouse MCP is ClickHouse Cloud's managed observability query service via the ClickStack MCP server. Use it to run fast analytical queries against observability data with managed access.
- [CoinGecko](https://composio.dev/toolkits/coingecko) - CoinGecko is a cryptocurrency data platform that provides prices, market metrics, exchange, NFT, and onchain data. Use it for comprehensive, up-to-date crypto market insights and metadata.

## Frequently Asked Questions

### Do I need my own developer credentials to use Contentsquare MCP with Composio?

Yes, Contentsquare MCP requires you to configure your own Dcr Oauth credentials. Once set up, Composio handles secure credential storage and management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)