Flipt MCP Server

A Model Context Protocol (MCP) server for Flipt, allowing AI assistants to interact with feature flags.

<img width="2060" alt="mcp" src="https://github.com/user-attachments/assets/cc32a6dd-5368-43c1-897a-a0ccfeeacaf0" />

Features

• List, create, update, and delete namespaces, flags, segments, rules, and more
• Evaluate flags for specific entities
• Toggle flags on/off
• Manage constraints, variants, distributions, and rollouts

Usage

Once the server is running, it will:

1. Set up a STDIO transport for MCP communication
2. Register tools and prompts for interacting with Flipt

The server is designed to be used with AI assistants that support the Model Context Protocol.

Node

You can install the package globally and run it:

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

Or run it directly with npx:

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

Docker

You can also run the server in a Docker container:

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

Configuration

The server can be configured using environment variables:

• FLIPT_API_URL: The URL of the Flipt API (default: http://localhost:8080)
• FLIPT_API_KEY: The API key to use for the Flipt API (optional)

You can set these in a .env file in the directory where you run the server.

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build the project
npm run build

# Start the server
npm start

# Format code
npm run fmt

# Lint code
npm run lint

License

Apache 2.0