Skip to main content

​
Overview

The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). Think of MCP like a USB-C port for AI applications - it provides a standardized way to connect AI models to different data sources and tools. Flipt’s v2 MCP server allows AI assistants and LLMs to directly interact with your environments, feature flags, segments, and evaluations through a standardized interface. This enables powerful AI-driven workflows and integrations with tools that support the MCP protocol.
Using Flipt v1? See the v1 MCP server documentation instead.

​
Use Cases

​
AI-Enabled IDEs

When using AI-enabled IDEs like Cursor that support MCP, your AI assistant can:
  • Check feature flag states while reviewing code
  • Help toggle features on/off during development
  • Assist in creating and managing feature flags
  • Evaluate flags for specific users/entities
  • Create branch environments to test flag changes safely and propose them back via your SCM
  • Help debug feature flag logic and rules
For example, you could ask your AI assistant:
  • “What’s the current state of the ‘dark-mode’ flag?”
  • “Enable the ‘beta-features’ flag for all users in the ‘internal’ segment”
  • “Create a branch of the production environment and add a flag for our upcoming notification system”

​
AI Agents and Workflows

The Flipt MCP server can be integrated into broader AI agent workflows to:
  • Automate feature flag management based on system metrics
  • Coordinate feature rollouts across multiple services
  • Propose flag changes as pull requests through branch environments
  • Manage complex feature flag rules and segments

​
Getting Started

Check out the Flipt MCP server repository for the most up to date information on how to use the MCP server.

​
Cursor

To use the Flipt MCP server with Cursor, you need to configure Cursor to use the MCP server. The Cursor docs have a guide on how to configure Cursor to use a MCP server. For Flipt v2, you can use the following configuration:

​
Docker

You can also run the server in a Docker container:

​
Configuration

The server can be configured using environment variables:
You can also set these in a .env file in the directory where you run the server.

​
Available Tools

Every tool that operates inside an environment accepts an optional environmentKey, falling back to the FLIPT_ENVIRONMENT environment variable.

​
Notes on the v2 Data Model

In Flipt v2, variants, rules, rollouts, distributions, and constraints live inside their parent flag or segment document rather than behind their own API endpoints. The corresponding tools read the parent document, apply the change, and write it back with the revision from the read, so a concurrent modification results in a conflict error instead of a lost update - fetch the resource again and retry. Rules, rollouts, and constraints have no IDs in v2; delete them by their index as shown by get_flag / get_segment. Variants and distributions are addressed by key.