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:

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:

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

Flipt v1:

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

Development

This is a pnpm workspace.

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