

<div class="admonition admonition-important"><div class="admonition-icon"><svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2.5"><path stroke-linecap="round" stroke-linejoin="round" d="M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" /></svg></div><div class="admonition-body"><div class="admonition-content">

This feature is available in [public preview](/docs/log-in-and-navigate-synerise-platform#public-preview) mode.

</div></div></div>


## What is MCP?

Model Context Protocol (MCP) is an open standard developed by Anthropic that defines how AI applications communicate with external tools and data sources. It works like a bridge: any MCP-compatible client can connect to an MCP server, which in turn provides access to tools, data, and documentation from a third-party system.

## What the Synerise MCP Server enables

The Synerise MCP Server is an implementation of the MCP standard for the Synerise platform. Once configured, you can connect any MCP-compatible client to your Synerise workspace (a chat assistant like Claude, a coding agent like Claude Code or Codex, or your own custom agent) and query analytics, inspect campaigns and workflows, retrieve customer profiles, explore AI models, browse loyalty programs, and access developer documentation, all in the flow of your work.

This removes the need to:

- Export data manually and paste it into your client
- Navigate through multiple Synerise screens to retrieve figures
- Search for documentation separately while working in your client

You get what you need from your workspace in real time, in the context of your request.

## What is available

The Synerise MCP Server covers the following product areas:

| Product area | What you can access |
|---|---|
| **Analytics** | Metrics, segmentations, funnels, trends, histograms, Sankey diagrams, reports, aggregates, expressions, including live calculation and profile segmentation membership checks  |
| **Campaigns** | Campaign details, templates, in-app messages, landing pages, documents, screen views from the Experience Hub |
| **Automation** | Workflow details, schedules, statistics, execution history, upcoming triggers and status changes, workflows with issues, in-progress workflows, performance rankings, diagram notes, status counts, data transformations, block template catalogs |
| **AI Recommendations** | Recommendation campaigns, feed configurations, statistics, top product performance, live recommendation fetching and previewing |
| **AI Search** | Search indices, query rules, synonyms, query statistics, top queries, recent searches, live search query execution, autocomplete, and filter-only browsing |
| **AI (other)** | Predictions, AB tests, recommendation and search index listings |
| **CRM** | Customer profile lookup and contact search |
| **Loyalty** | Promotions and coupon pool details (personalized promotions are not accessible) |
| **Assets** | Catalogs, Brickworks schemas, records, and externals, code snippets, API keys, generate and preview Brickworks records |
| **Events** | Event action catalog and action parameters, per-profile event history lookup |
| **Account** | Current workspace identity and caller information |
| **Mobile SDK guidance** | iOS and Android SDK setup guides, configuration help, best practices, diagnostics, FAQ, integration validation |
| **VTEX guidance** | VTEX plugin setup, component guides, configuration help, integration validation |

For a full list of available operations, see [Available tools](/developers/mcp/available-tools).

## Example workflows

The following examples show how different team members can use the Synerise MCP Server to get more done in less time.

### Analyst: querying data without switching tools

An analyst wants to understand drop-off in the checkout funnel over the last 30 days. Instead of opening Synerise, building the funnel query, waiting for results, and then copying figures into a presentation, they ask directly:

> *Calculate the checkout funnel for the last 30 days. Show me the steps and where users drop off most.*

They get back a structured breakdown, including the step with the highest drop-off rate and a suggested hypothesis.

### Marketer: reviewing campaign status

A marketer preparing for a weekly review wants a summary of all active email campaigns:

> *List all active email campaigns and tell me which ones are scheduled to send in the next 7 days.*

They get the matching campaigns back with their scheduled send times, without opening the platform.

### Developer: setting up a mobile integration

A developer integrating Synerise into a new iOS app asks:

> *Walk me through setting up push notifications with the Synerise iOS SDK.*

They get a step-by-step walkthrough, built from the relevant Mobile SDK setup guide, configuration documentation, and best practices, tailored to their question.

### Operations: checking automation health

An operations manager wants to know if any workflows have issues before the weekend:

> *Are there any workflows currently failing or paused unexpectedly?*

They get automation status back immediately, including which workflows have issues and what kind of problem each one has, so the team can investigate before going offline.

## Who benefits

The Synerise MCP Server is useful for anyone who regularly works with Synerise data or needs to reference Synerise documentation:

- **Analysts and data teams** - run analytics queries in natural language, explore segmentations, and get results explained in context.
- **Marketers** - check campaign status, loyalty promotions, and recommendation performance without switching tools.
- **Developers** - get guided through SDK and VTEX integration steps, validate configurations, and troubleshoot issues.
- **Operations and automation teams** - monitor workflow health, check upcoming triggers, and investigate execution history.

## Limitations

- **Read-only access** - the MCP server can retrieve and calculate data, but cannot create, update, or delete anything in your workspace.
- **Workspace scope** - the server connects to a single workspace at a time, determined by the API key you configure.
- **No real-time event streaming** - the server retrieves data on demand in response to each question; it does not push live updates or subscribe to workspace events.
- **Client behavior** - the accuracy and usefulness of responses depends on how your client interprets your request and selects tools. Complex or ambiguous requests may require follow-up clarification.

## What's next

Proceed to [Getting started](/developers/mcp/getting-started) to configure the Synerise MCP Server with your client.
