Flipt MCP Server

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

Using Flipt v2? Use @flipt-io/mcp-server-flipt-v2 instead.

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.

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_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

This package lives in a pnpm workspace; see the repository README for the full workflow.

# Install dependencies (from the repository root)
pnpm install

# Run in development mode
pnpm --filter @flipt-io/mcp-server-flipt dev

# Build the package
pnpm --filter @flipt-io/mcp-server-flipt build

# Start the server
pnpm --filter @flipt-io/mcp-server-flipt start

License

Apache 2.0