Growthbook MCP

Official

by growthbook · TypeScript

MCP Server for interacting with GrowthBook

Integration with GrowthBook for feature flag management and experimentation.

Topics

mcpmcp-serverab-testingfeature-flags

README.md2 KBView on GitHub

GrowthBook MCP Server

With the GrowthBook MCP server, you can interact with GrowthBook right from your LLM client. See experiment details, add a feature flag, and more.

Setup

Environment Variables Use the following env variables to configure the MCP server.

Variable Name	Status	Description
GB_API_KEY	Required	A GrowthBook API key or PAT. When using a PAT, MCP server capabilities are limited by its permissions. E.g., if the user can't create an experiment in the app, they also won't be able to create one with the MCP server.
GB_EMAIL	Required	Your email address used with GrowthBook. Used when creating feature flags and experiments.
GB_API_URL	Optional	Your GrowthBook API URL. Defaults to `https://api.growthbook.io`.
GB_APP_ORIGIN	Optional	Your GrowthBook app URL Defaults to `https://app.growthbook.io`.
GB_HTTP_HEADER_*	Optional	Custom HTTP headers to include in all GrowthBook API requests. Use the pattern `GB_HTTP_HEADER_<NAME>` where `<NAME>` is converted to proper HTTP header format (underscores become hyphens). Examples: `GB_HTTP_HEADER_X_TENANT_ID=abc123` becomes `X-Tenant-ID: abc123`, `GB_HTTP_HEADER_CF_ACCESS_TOKEN=<token>` becomes `Cf-Access-Token: <token>`. Multiple custom headers can be configured.

Add the MCP server to your AI tool of choice. See the official docs for complete a complete guide.

Install

Configuration

Environment variables

GB_API_KEY

A GrowthBook API key or PAT.

GB_EMAIL

Your email address used with GrowthBook. Used when creating feature flags and experiments.

GB_API_URL

Your GrowthBook API URL. Defaults to `https://api.growthbook.io`.

GB_APP_ORIGIN

Your GrowthBook app URL Defaults to `https://app.growthbook.io`.

GB_HTTP_HEADER_*

Custom HTTP headers to include in all GrowthBook API requests. Use the pattern GB_HTTP_HEADER_<NAME> where <NAME> is converted to proper HTTP header format. Examples: GB_HTTP_HEADER_X_TENANT_ID=abc123, GB_HTTP_HEADER_CF_ACCESS_TOKEN=<token>. Multiple custom headers can be configured.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "growthbook-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@growthbook/mcp@1.8.1"
      ],
      "env": {
        "GB_API_KEY": "<YOUR_GB_API_KEY>",
        "GB_EMAIL": "<YOUR_GB_EMAIL>",
        "GB_API_URL": "<YOUR_GB_API_URL>",
        "GB_APP_ORIGIN": "<YOUR_GB_APP_ORIGIN>",
        "GB_HTTP_HEADER_*": "<YOUR_GB_HTTP_HEADER_>"
      }
    }
  }
}