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:- Retrieve experiment results and identify the winning variation.
- Extract the variation’s raw code from Kameleoon.
- Convert the code into native, production-ready code (such as React components) aligned with the existing codebase.
- Create a feature flag in Kameleoon.
- Wrap the new implementation behind the feature flag.
- 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.
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:.mcp.json file to your repository for team sharing), run:
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:- The command automatically opens a browser tab. If it doesn’t, copy the URL printed in the terminal and open it manually.
- Sign in to your Kameleoon account.
- Click Authorize.
- When the browser displays a success message, press
Ctrl+Cin your terminal.
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:- The browser automatically opens a window.
- Click Authorize on the Kameleoon login page.
- Kameleoon completes the local callback on port 35535.
- The terminal confirms that the proxy connected successfully.
Verify tool operations
After you authenticate, run the following checks to confirm the tools work as expected:- List available tools: Confirm that
tools/listsucceeds and returns the Kameleoon tools. Ensure the output includes the tools listed in the tools table, such asexperiment_code_get,feature_flag_list, andfeature_flag_create. - Retrieve feature flags: Run
feature_flag_list(siteCode = "d1alzzxd7k"). A successful response returns a list of feature flags for the specified site. - 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.Option 1: Configure via Cursor UI (recommended)
- Open Cursor Settings (
Cmd+Shift+Jon macOS,Ctrl+Shift+Jon Windows/Linux). - Navigate to Features > MCP Servers > + Add New MCP Server.
- Set the Name to
kameleoon. - Set the Type to
command. - Enter the following string as the Command:
- 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
149640and summarize the current status.” - “Pull the variation code for experiment
<experimentId>and variation<variationId>.”
- “Inspect feature flag new_search for site
d1alzzxd7kand explain what environments and variations it currently has.” - “Summarize experiment
149640for an engineer. Include status, site code, winner state, and whether any variation data is available.” - “List the active feature flags for site
d1alzzxd7kand 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 sited1alzzxd7k.” - “Turn on feature flag
<featureKey>in the staging environment for sited1alzzxd7k.” - “Turn off feature flag
<featureKey>in the production environment for sited1alzzxd7k.”
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 bytools/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).
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
experimentIdandvariationIdwhen 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 anEADDRINUSE error, another process already listens on the OAuth callback port.
- Cause: A stale
mcp-remoteprocess 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
localhostcallbacks. - 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 thatnpx is available on your system path. Node.js versions 8.2 and later include npx by default.