Skip to main content
The Kameleoon Model Context Protocol (MCP) server connects AI coding assistants directly to your Kameleoon project, enabling agentic workflows for experiments and feature flags. Beyond reading configurations and pulling variation code, your AI assistant can build and manage experiments, feature flags, goals, segments, and targeting rules, and run the full rollout lifecycle, all from your development environment. Register and authenticate the server to automate your implementation lifecycle, from a winning variation to a gated production rollout.

Features

After you connect the server, your AI agent can interact with Kameleoon to:
  • Discover and inspect experiments, feature flags, goals, segments, and targeting rules.
  • Build experiments end to end: create, duplicate, and run the full lifecycle (start, pause, resume, stop, delete).
  • Manage feature flags: create, duplicate, delete, toggle per environment, and review the change history.
  • Configure flag delivery: add targeted and experimentation rules, custom variations, and typed variables.
  • Create and maintain goals and audience segments, and bind segments to experiments.
  • Analyze experiment and feature-flag-experiment results, and pull raw variation code (JavaScript and CSS).
  • Automate the full implementation lifecycle, from a winning variation to a gated production rollout.

The primary workflow: Winning experiment to production

The Kameleoon MCP server automates the “last mile” of implementation. Without leaving the IDE, you can instruct your AI assistant to execute the following workflow:
  1. Retrieve experiment results and identify the winning variation.
  2. Extract the variation’s raw code from Kameleoon.
  3. Convert the code into native, production-ready code (such as React components) aligned with the existing codebase.
  4. Create a feature flag in Kameleoon.
  5. Wrap the new implementation behind the feature flag.
  6. Enable and validate the feature in production.

Token usage and plan considerations

Connecting the Kameleoon MCP server to an AI assistant adds a small, fixed overhead: the tool schemas that describe the available actions. This overhead stays flat regardless of which plan the assistant runs on. The token cost of a workflow comes from the work itself, not from the connection. The following factors drive usage:
  • The amount of data a workflow retrieves, such as full experiment configurations, variation code, or activity logs.
  • The amount of code the assistant generates or converts, for example when transposing a winning variation into native application code.
  • The number of sites or brands a single workflow touches. Duplicating and auditing experiments across three sites consumes proportionally more tokens than running the same operation on one site.
  • How broadly you scope a single prompt. A narrow, single-site check consumes far less than an open-ended request to review every experiment across every site.
Before you commit a team to a specific AI assistant plan, scope your expected workflows: how many sites or brands they touch, how often you run them, and whether they include large data-retrieval or code-generation steps. Recurring, multi-site workflows need a plan with a larger usage allowance or context window than a plan sized for occasional, single-site prompts. Check your AI assistant provider’s plan documentation for its specific usage limits and context window size.

Available tools

The server exposes the tools below, grouped by area. Each tool maps to a single, well-scoped action, so you can compose them into larger workflows (for example: read results, pull code, create a flag, add a rule, enable it).

Experiments

Build, inspect, and run A/B tests (Web Experiments).

Feature flags

Create and operate feature flags, toggle them per environment, and read their history and results.

Flag delivery, variations, and variables

Shape how a flag is delivered, and define the variations and typed variables it serves.

Goals

Create and maintain the conversion goals used by experiments and flags.

Segments

Define and inspect the audiences you target.

Sites and targeting rules

Discover your projects and bind segments to experiments.

Claude Code integration

Step 1: Register the server

To register the server for your user profile (making it available in all projects), open a terminal and run the following command:
To register the server only for the current project (which adds a .mcp.json file to your repository for team sharing), run:
Verify that Claude added the server:
Expected output: kameleoon: ... - ✗ Failed to connect (A failed connection here is normal because you have not completed authentication yet).

Step 2: Complete OAuth authentication

In the same terminal, trigger the login flow:
  1. The command automatically opens a browser tab. If it doesn’t, copy the URL printed in the terminal and open it manually.
  2. Sign in to your Kameleoon account.
  3. Click Authorize.
  4. When the browser displays a success message, press Ctrl+C in your terminal.
Verify the connection:
Expected output: kameleoon: ... - ✓ Connected

Step 3: Start a new Claude Code session

Claude Code makes tools from newly added MCP servers available only in sessions that you start after registering the server. Close your current Claude Code chat and open a new one.

Step 4: Verify the connection

In a new Claude Code conversation, try the following prompts:
  • “List my Kameleoon feature flags.”
  • “What experiments are active on site X?”
  • “Show me the status of experiment Y.”
  • “Show me the code for variation 1 of experiment Z.”

Claude troubleshooting

Antigravity integration

Quick setup

Paste the following self-starter prompt directly into your Antigravity chat to connect automatically:

Manual configuration

Edit the configuration file at ~/.gemini/antigravity/mcp_config.json and add the following JSON block:

Codex integration

Quick setup

Paste the following self-starter prompt into your Codex chat:

Manual configuration

Add the following block to ~/.codex/config.toml. Create the file if it does not exist:

Authenticate the connection

The Kameleoon MCP server uses OAuth. Run the following command in your terminal to start the authorization flow:
Expected behavior:
  1. The browser automatically opens a window.
  2. Click Authorize on the Kameleoon login page.
  3. Kameleoon completes the local callback on port 35535.
  4. The terminal confirms that the proxy connected successfully.
A successful connection outputs text similar to the following:

Verify tool operations

After you authenticate, run the following checks to confirm the tools work as expected:
  1. List available tools: Confirm that tools/list succeeds and returns the Kameleoon tools. Ensure the output includes the tools listed in the tools table, such as experiment_code_get, feature_flag_list, and feature_flag_create.
  2. Retrieve feature flags: Run feature_flag_list(siteCode = "d1alzzxd7k"). A successful response returns a list of feature flags for the specified site.
  3. Retrieve experiment results: Run experiment_results_get(experimentId = 149640). A successful response includes the experiment name, site code, type, and status.

Cursor integration

Cursor integrates MCP tools directly into the IDE Chat sidebar, which makes them available while you code.
  1. Open Cursor Settings (Cmd+Shift+J on macOS, Ctrl+Shift+J on Windows/Linux).
  2. Navigate to Features > MCP Servers > + Add New MCP Server.
  3. Set the Name to kameleoon.
  4. Set the Type to command.
  5. Enter the following string as the Command:
  6. Save the configuration.

Option 2: Configure via mcp.json (advanced)

Open ~/.cursor/mcp.json (create the file if it does not exist) and add the following entry to the mcpServers object:
Restart Cursor after you edit the file manually.

Sample prompts for developer workflows

After you connect the Kameleoon MCP server, use prompts like the following in your IDE:
  • “List the Kameleoon MCP tools available in this session.”
  • “Show me all feature flags for site code d1alzzxd7k.”
  • “Get the details for feature flag new_search on site d1alzzxd7k.”
  • “Fetch experiment results for experiment 149640 and summarize the current status.”
  • “Pull the variation code for experiment <experimentId> and variation <variationId>.”
For more advanced workflows, try the following prompts:
  • “Inspect feature flag new_search for site d1alzzxd7k and explain what environments and variations it currently has.”
  • “Summarize experiment 149640 for an engineer. Include status, site code, winner state, and whether any variation data is available.”
  • “List the active feature flags for site d1alzzxd7k and point out any flags that look like stale candidates.”
  • “Retrieve the code for variation <variationId> in experiment <experimentId> and explain what frontend behavior it changes.”
  • “Create a new feature flag named <name> with key <featureKey> for site d1alzzxd7k.”
  • “Turn on feature flag <featureKey> in the staging environment for site d1alzzxd7k.”
  • “Turn off feature flag <featureKey> in the production environment for site d1alzzxd7k.”

Advanced workflow: End-to-end automation

To experience the full capability of the MCP server, use a comprehensive system prompt. The following example demonstrates how to transpose winning variation code into React components, which is intended primarily for React applications. It instructs the AI agent to handle the entire implementation lifecycle, from retrieving winning results to generating production-ready native code gated behind a new feature flag, and then rolling it out and validating it, all through the MCP tools. Paste the following prompt into your AI assistant:

Tool parameters reference

Use the exact tool names and parameter names returned by tools/list. The live MCP schema supports the following parameters.

Experiments

experiment_create accepts MVT and SDK_HYBRID as valid type values, but neither can actually be created through this tool. MVT always fails because the API requires mvtVariations (sections and variations) on creation, and no MCP tool exposes that field. SDK_HYBRID always fails with an “Incorrect Experiments type” error, regardless of payload. AI, CLASSIC, DEVELOPER, and PROMPT all create successfully. To create an MVT experiment, call the Automation API directly and follow the steps in Create a multivariate experiment.

Feature flags

Flag delivery, variations, and variables

Goals

Segments

Sites and targeting rules

Accepted enum values: experiment_lifecycle_update.status is started, resumed, paused, stopped, or deleted. Experiment type is AI, CLASSIC, DEVELOPER, MVT, PROMPT, or SDK_HYBRID. Goal type is CLICK, CUSTOM, SCROLL, PAGE_VIEWS, URL, TIME_SPENT, RETENTION_RATE, WAREHOUSE, or RATIO_METRICS. variableType is BOOLEAN, NUMBER, STRING, JSON, JS, CSS, or ENUM. trafficAllocations is a comma-separated variationKey:percentage string that sums to 100 (for example off:50,on:50). releaseDateTime is an ISO-8601 local datetime without offset (for example 2026-07-01T09:00:00) and timeZone is an IANA zone (for example Europe/Paris or UTC).
For environment-specific queries, pass environmentKey = "production" or environmentKey = "staging" where supported.

Prompting tips

  • Include the site code when you work with feature flags.
  • Include the experiment ID when you query experiments or experiment results.
  • Include both experimentId and variationId when you request variation code.
  • Explicitly name the target environment when you ask the agent to enable or disable a feature flag.
  • Request a plain-English summary if you want your AI agent to interpret the MCP response rather than just retrieving the raw data.

General troubleshooting

Port 35535 is already in use

If authentication fails with an EADDRINUSE error, another process already listens on the OAuth callback port.
  • Cause: A stale mcp-remote process remains active from a previous authentication attempt.
  • Fix: Stop the stale process that is using port 35535, then rerun the OAuth command.

MCP server does not appear in Codex chat

Codex might not hot-reload newly added MCP servers into an already-running thread.
  • Fix: Refresh Codex or start a new session after you update config.toml.

Browser flow does not complete

If the OAuth browser window opens but authorization does not finish:
  • Confirm that you clicked the Authorize button on the Kameleoon login page.
  • Check that your browser or system settings do not block localhost callbacks.
  • Manually open the callback URL if your browser fails to launch it automatically.

Headless or remote agents fail to authenticate

Remote or headless agents (such as cloud-hosted Codex) cannot complete the browser-based authorization step.
  • Fix: Use a desktop version of your tool instead.

npx command not found

If the command fails with a “not found” error, ensure that npx is available on your system path. Node.js versions 8.2 and later include npx by default.