# Featureflip

> Featureflip is a freemium MCP server for developer tools. Manage Featureflip flags, targeting and rollouts from an AI coding assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://featureflip.io/docs/integrations/mcp/
- **Repository:** https://github.com/canopy-labs/featureflip-mcp
- **MCP Registry name:** io.github.canopy-labs/featureflip
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Featureflip's server turns flag housekeeping into something an agent can do without leaving the editor: create and toggle flags, edit targeting rules and variations, set up rollout ramps, and find flags that are stale and safe to delete. A `wrap_feature` workflow creates a flag and returns the SDK snippet for your language, and `compare_environments` shows which flags differ between two environments.

It runs locally over stdio through `npx -y @featureflip/mcp@latest` and calls the Management API with a token you supply. A personal token (ffp_) acts as you, while a service token (ffs_) is a machine identity scoped to one organization for CI or unattended agents. A token below the role needed for a write gets the same 403 as a raw API call, and every mutation is audit-logged and attributed to the token.

There are 41 tools, with webhooks needing an admin token. Flag evaluation is deliberately not exposed over MCP; use the language SDKs in application code. The server is Apache-2.0 and works on every Featureflip plan, including Free.

## Features

- **Flag lifecycle:** Create, update, toggle, archive, restore and delete flags.
- **Targeting and rollouts:** Edit targeting rules, variations, segments and rollout ramps.
- **Stale flag cleanup:** Find stale flags and flags safe to remove.
- **Environment comparison:** See which flags differ between two environments.
- **Scoped tokens:** Use a personal token or an organization-scoped service token.
- **Audit trail:** Every change is logged and attributed to the token.

## Good for

- Create a flag and get the SDK snippet while coding
- Compare staging and production flag configuration
- Clean up flags that have gone stale
- Run unattended flag changes in CI with a service token

## Install

### Claude Code (Terminal)

```sh
claude mcp add featureflip --env FEATUREFLIP_TOKEN='<FEATUREFLIP_TOKEN>' -- npx -y @featureflip/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "featureflip": {
      "command": "npx",
      "args": [
        "-y",
        "@featureflip/mcp"
      ],
      "env": {
        "FEATUREFLIP_TOKEN": "<FEATUREFLIP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "featureflip": {
      "command": "npx",
      "args": [
        "-y",
        "@featureflip/mcp"
      ],
      "env": {
        "FEATUREFLIP_TOKEN": "<FEATUREFLIP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "featureflip": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@featureflip/mcp"
      ],
      "env": {
        "FEATUREFLIP_TOKEN": "<FEATUREFLIP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "featureflip": {
      "command": "npx",
      "args": [
        "-y",
        "@featureflip/mcp"
      ],
      "env": {
        "FEATUREFLIP_TOKEN": "<FEATUREFLIP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "featureflip": {
      "command": "npx",
      "args": [
        "-y",
        "@featureflip/mcp"
      ],
      "env": {
        "FEATUREFLIP_TOKEN": "<FEATUREFLIP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_projects`: Lists projects in an organization.
- `list_environments`: Lists environments in a project.
- `list_flags`: Lists feature flags.
- `get_flag`: Reads one flag.
- `create_flag`: Creates a feature flag.
- `update_flag`: Updates a flag.
- `toggle_flag`: Turns a flag on or off.
- `archive_flag`: Archives a flag.
- `get_targeting`: Reads targeting for a flag.
- `update_targeting`: Changes targeting.
- `manage_segment`: Creates or edits a segment.
- `manage_rollout_ramp`: Manages a rollout ramp.
- `flag_status`: Cross-environment view of a flag.
- `flag_evaluations`: Shows what a flag served in one environment, by variation and rule.
- `compare_environments`: Shows which flags differ between two environments.
- `find_stale_flags`: Finds cleanup candidates.
- `list_removal_candidates`: Lists flags safe to remove, with prerequisite dependents to remove first.
- `wrap_feature`: Creates a flag and returns the SDK snippet for your language.

## FAQ

### Which token should I use?

A personal ffp_ token for interactive editor use, or an ffs_ service token for CI and unattended agents.

### Does it work on the Free plan?

Yes. The Management API is available on all plans.

### Can it evaluate flags for my app?

No. Evaluation is not exposed over MCP; use the language SDKs.

### What does it need?

Node.js 20.19 or later for the Claude Desktop bundle, and a FEATUREFLIP_TOKEN.

### Is Featureflip free?

Featureflip has a free plan, with paid plans for more usage or features.

### How do I add Featureflip to Claude Code?

Run this command in your terminal: claude mcp add featureflip --env FEATUREFLIP_TOKEN='<FEATUREFLIP_TOKEN>' -- npx -y @featureflip/mcp

### What are the best alternatives to Featureflip?

The closest alternatives to Featureflip are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/featureflip
