---
title: Optimizely Experimentation MCP server overview
slug: experimentation-strategy/docs/optimizely-experimentation-mcp-server-overview
docTags: 
createdAt: 2026-08-05T20:33:26.471Z
---

- Optimizely Web Experimentation
- Optimizely Personalization
- Optimizely Feature Experimentation
- Optimizely Performance Edge

The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) is an open standard that lets agents connect to external tools and data sources. Instead of copying data into prompts or writing API scripts, MCP gives your AI client structured access to live systems.

The Optimizely Experimentation MCP server is a hosted service that connects your agent to Optimizely Experimentation. Use it to query projects, flags, and experiment results in the AI tools you already use. Generate SDK implementation code and create and manage experiments, flags, and audiences through natural language.

## Benefits

The MCP server brings Optimizely into the tools you already work in. Ask questions like *What experiments are running in my project?* or *Show me the results for the checkout redesign test* directly in your IDE, terminal, or browser-based AI client instead of navigating dashboards or writing API calls.

Log in with your Optimizely account. The server sees exactly what your account has access to: the same projects, experiments, and data as the Optimizely UI.

## Prerequisites

To use the Experimentation MCP server, you need the following:

1. An Opti ID account.
2. An Optimizely account with Optimizely Agent Platform enabled, connected to at least one Feature Experimentation or Web Experimentation instance.
3. An AI client that supports remote MCP.

During authentication, you connect to your Agent Platform instance, and the MCP server automatically has access to any experimentation instances linked to it.

### About Opti ID

[Opti ID](docId\:pbehd96P529DqHZ0HOQlm) is Optimizely's unified identity system. It is the single set of credentials you use to log in across Optimizely products. If you already have an Optimizely account, you have an Opti ID. It is the same login.

### About Agent Platform

[Optimizely Agent Platform](docId\:IzAAN1fw7whD1HB4iODAB) is an agent orchestration platform that helps you work smarter across Optimizely One. The MCP server authenticates through your Agent Platform instance, which connects it to your Experimentation data. See [Product connections](docId:_qedlrgpN69DdvQvZT9FD). During configuration, you are asked to select your Agent Platform instance as part of the Open Authorization (OAuth) flow.

## What you can do

The MCP server provides tools in three categories:

- **Query** – List projects, flags, experiments, and environments. Retrieve experiment results. Compare configurations across environments.
- **Manage** – Create and update flags, experiments, and audiences. Configure targeting rules and rollouts.
- **Implement** – Search Feature Experimentation SDK documentation. Get implementation guidance for your language and framework. Generate SDK integration code.

Creating or updating flags, experiments, and audiences modifies live Optimizely data. The agent always confirms the target project, environment, and details before committing any changes. Review the agent's confirmation carefully before approving.

### Available tools

| Tool                                    | Category  | Description                                                                                                                                                                                                                                                         |
| --------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `exp_get_schemas`                       | Query     | Retrieve the data schema for experimentation entities (projects, flags, experiments, and so on).                                                                                                                                                                    |
| `exp_execute_query`                     | Query     | Run structured queries against your experimentation data.                                                                                                                                                                                                           |
| `exp_summarize_test_result`             | Query     | Retrieve and analyze results for individual experiments.                                                                                                                                                                                                            |
| `exp_program_reporting_top_experiments` | Query     | Surface top-performing experiments across your program. Returns  reporting data for paused and concluded experiments.                                                                                                                                               |
| `exp_program_reporting_execute_query`   | Query     | Runs custom queries on results data for paused, concluded, and archived experiments: lift, significance, confidence intervals, conversion rates, and visitor counts. Use it when you want your own slice, like one metric or one variation across many experiments. |
| `exp_search_fx_sdk_docs`                | Implement | Search [Feature Experimentation SDK documentation](docId\:c9ujHSMi58bPacUj9ApTQ) across supported languages (JavaScript, Python, Java, Ruby, Go, Swift, Android, Flutter, C#, PHP, React, React Native, Next.js, Angular).                                          |
| `exp_manage_entity_lifecycle`           | Manage    | Create, update, and archive flags, experiments, audiences, and more.                                                                                                                                                                                                |
| `exp_get_entity_templates`              | Manage    | Retrieve templates and required fields for creating or updating entities.                                                                                                                                                                                           |

Most tools return live data. The `exp_program_reporting_top_experiments` tool returns data from the reporting tool, which is most relevant for paused and concluded experiments rather than active ones.

## Who this is for

### Developers working in AI-powered editors

If you use [Cursor](https://cursor.com/get-started), [Claude Code](https://code.claude.com/docs/en/overview), or [Visual Studio Code with Copilot](https://github.com/features/copilot/ai-code-editor), the MCP server lets you query your experiment and flag configurations, look up SDK docs, and check experiment results without leaving your editor.

### Technical PMs using browser-based AI

If you use [Claude Desktop](https://code.claude.com/docs/en/desktop-quickstart), [Claude.ai](https://code.claude.com/docs/en/web-quickstart), or [ChatGPT](https://chatgpt.com), you can query your experimentation program, pull results, and ask questions about experiment performance in natural language.

### Experimentation leads scaling programs

If you manage a large number of flags and experiments, the MCP server gives you a faster way to get answers, such as *Which experiments ended last week?* or *Show me all flags in the payments project.*

:::hint{type="info"}
**Note**

For Web Experimentation, you can query experiments, create experiments, campaigns, audiences, and other entities in projects. Variation-level code changes (custom HTML, CSS, and JavaScript) are not supported through MCP. Instead, use the [Visual Editor](docId:-71fnhHzz_HGFgIDE1_wO).
:::

## Supported AI clients

The MCP server works with any AI client that supports remote MCP. See [Optimizely Experimentation MCP server quickstart](docId\:rQEyY_Qi9Wfj_2zvzavux) for the fastest path to your first query, or [Install Optimizely Experimentation MCP server](docId\:oDoyHBD4Pfoypf3Vm_G6K) for step-by-step setup for the most common clients.
