home / mcp / flipt mcp server

Flipt MCP Server

Provides an MCP interface to Flipt for managing and evaluating feature flags via a stdio transport.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "flipt-io-mcp-server-flipt": {
      "command": "npx",
      "args": [
        "-y",
        "@flipt-io/mcp-server-flipt"
      ],
      "env": {
        "FLIPT_API_KEY": "<YOUR_API_KEY>",
        "FLIPT_API_URL": "<YOUR_FLIPT_API_URL>"
      }
    }
  }
}

You run an MCP server for Flipt to let AI assistants interact with feature flags. It exposes management, evaluation, and control of namespaces, flags, segments, rules, and more through a simple transport, enabling practical automation and conversational control of Flipt features.

How to use

You connect your MCP client to the Flipt MCP Server using a stdio transport, which streams commands and responses between the client and server. Use the server to list, create, update, and delete namespaces, flags, segments, rules, and related entities. You can also evaluate flags for specific entities, toggle flags on or off, and manage constraints, variants, distributions, and rollouts. Typical workflows include configuring a namespace, adding flags with their rules, and then asking the client to evaluate a flag for a given entity to decide feature behavior in real time.

How to install

npm install -g @flipt-io/mcp-server-flipt && mcp-server-flipt
```

```
npx -y @flipt-io/mcp-server-flipt
```

```
docker run -d --name mcp-server-flipt ghcr.io/flipt-io/mcp-server-flipt:latest

Configuration and environment

The server can read its configuration from environment variables. You can set these variables in a ".env" file in the directory where you run the server. The key variables are the API URL for Flipt and an optional API key.

- FLIPT_API_URL: The URL of the Flipt API (default: http://localhost:8080).

- FLIPT_API_KEY: The API key for authenticating with the Flipt API (optional).

Available tools

listNamespaces

List all namespaces in Flipt, allowing you to see available scoping for flags and rules.

createNamespace

Create a new namespace to group related flags and resources.

updateNamespace

Update properties of an existing namespace.

deleteNamespace

Delete a namespace and its associated flags and rules.

listFlags

List all flags within a namespace or across the server.

createFlag

Create a new feature flag with its rules and constraints.

updateFlag

Modify an existing flag's properties, such as constraints or default variant.

deleteFlag

Remove a flag from a namespace.

listSegments

List segments used to target groups of entities for flag evaluation.

createSegment

Create a new targeting segment for flags.

updateSegment

Update an existing segment's rules or membership.

deleteSegment

Delete a segment from the MCP view.

listRules

List evaluation rules for a flag, including conditions and outcomes.

updateRule

Update a specific evaluation rule for a flag.

deleteRule

Remove an evaluation rule from a flag.

evaluateFlag

Evaluate a flag for a given entity to determine its active variant.

toggleFlag

Enable or disable a flag across the applicable namespace.

manageConstraints

Manage constraints that govern when a flag is evaluated.

manageVariants

Manage the variants that a flag can return during evaluation.

manageDistributions

Configure how flag variants are distributed across entities.

manageRollouts

Configure gradual rollouts and rollout strategies for flags.