@flagpilot/mcp

Official Model Context Protocol (MCP) server for FlagPilot — manage feature flags directly from AI coding assistants like Claude Desktop, Cursor, and Windsurf.

Installation

Run the server with npx (no global install required):

npx -y @flagpilot/mcp

Or install globally:

npm install -g @flagpilot/mcp

Claude Desktop Configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "flagpilot": {
      "command": "npx",
      "args": ["-y", "@flagpilot/mcp"],
      "env": {
        "FLAGPILOT_SECRET_KEY": "fk_secret_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor Configuration

In Cursor, go to Settings > Features > MCP and add:

• Type: command
• Command: npx -y @flagpilot/mcp
• Environment Variable: FLAGPILOT_SECRET_KEY=fk_secret_xxxxxxxxxxxxxxxx

Windsurf Configuration

Add the server under Windsurf's MCP section using the same command execution parameters:

• Command: npx -y @flagpilot/mcp
• Environment: FLAGPILOT_SECRET_KEY=fk_secret_xxxxxxxxxxxxxxxx

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | FLAGPILOT_SECRET_KEY | Yes | Your FlagPilot secret API key | | FLAGPILOT_API_URL | No | Custom API endpoint (defaults to hosted service) |

Available Tools

The MCP server exposes the following tools to AI assistants:

| Tool | Description | |------|-------------| | create_flag | Create a new feature flag and return an SDK snippet | | toggle_flag | Enable or disable a flag (kill switch) | | set_rollout | Set gradual rollout percentage (0–100) | | list_flags | List all flags with their current state | | get_stale_flags | List stale flags classified as needs_review or inactive | | add_target_user | Add a user ID to a flag's target list | | remove_target_user | Remove a user ID from a flag's target list | | list_target_users | List all target users for a flag |

Example Prompts

Once connected, ask your AI assistant:

Flag management

• "Create a boolean feature flag named checkout-v2."
• "Disable checkout-v2 immediately."
• "Delete flags inactive for more than 90 days."

Rollouts and targeting

• "Roll out checkout-v2 to 10% of production users."
• "Show me every flag targeting beta testers."

Discovery and hygiene

• "List all feature flags in the project."
• "List all stale flags."
• "Find feature flags created this month."
• "Explain why checkout-v2 is disabled."

Environments and history

• "List environments for this project."
• "Create a staging environment."
• "Show rollout history for checkout-v2."

Documentation

Full documentation is available at tryflagpilot.com/docs.

• MCP Installation Guide
• CLI Tool
• REST API Reference

License

MIT