Flipt MCP Server

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

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:

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

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

Installing via Smithery

To install Flipt MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @flipt-io/mcp-server-flipt --client claude

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

Flipt Feature Flags