Flipt MCP Servers

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

This repository contains two packages, one per major Flipt version:

Package	Flipt version	npm	Docker
`packages/mcp-server-flipt`	Flipt v1	`@flipt-io/mcp-server-flipt`	`ghcr.io/flipt-io/mcp-server-flipt`
`packages/mcp-server-flipt-v2`	Flipt v2	`@flipt-io/mcp-server-flipt-v2`	`ghcr.io/flipt-io/mcp-server-flipt-v2`

Not sure which one you need? If your Flipt server has environments and Git-backed storage, it is v2 — use @flipt-io/mcp-server-flipt-v2. See each package's README for installation, configuration, and the full tool catalog.

Quick start

Flipt v2:

Terminal

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

Flipt v1:

Terminal

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

Development

This is a pnpm workspace.

bash

pnpm install       # install all dependencies
pnpm -r build      # build both packages
pnpm -r test       # test both packages
pnpm -r check      # typecheck both packages
pnpm lint          # lint both packages
pnpm fmt           # format both packages

# scope a command to one package
pnpm --filter @flipt-io/mcp-server-flipt-v2 dev

Releasing

v1: push a vX.Y.Z tag (unchanged legacy scheme)
v2: push a mcp-server-flipt-v2@X.Y.Z tag

Each tag publishes the matching package to npm and its image to ghcr.io via the publish workflow. Bump versions with pnpm version <bump> --no-git-tag-version inside the package directory (the version lifecycle script keeps src/version.ts in sync), then create the tag manually using the scheme above.

License

Apache 2.0