MCP Server Flipt

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