@flagpilot/mcp

@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