MCP Installation

Installation

@flagpilot/mcp is published on npm. Run it directly with npx (no install required):

npx -y @flagpilot/mcp

Or install it globally from npm:

npm install -g @flagpilot/mcp

Configuring Claude Desktop

Add the configuration settings to your local claude_desktop_config.json path:

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

Connecting to Cursor

Add the server context inside Cursor settings (Settings → Features → MCP):

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

Connecting to Windsurf

Input the server parameters under Windsurf's MCP section similarly using command execution parameters.

Available Prompts

The MCP server understands natural language prompts to manage your feature flags. Below are the supported categories with example prompts you can use in any AI coding assistant.

Flag Management

Create, toggle, and delete feature flags directly from your IDE.

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

Rollouts & Targeting

Control gradual rollouts and user targeting rules without leaving your editor.

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

Discovery & Hygiene

Search, filter, and audit flags to keep your codebase clean.

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

Environments & History

Manage environments and review flag change history.

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

FAQ