@growthbook/mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GrowthBook
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,140 @@
+# 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.
+
+## Installation
+
+### Local Installation
+
+1. Clone the repo
+2. Run `npx tsc` to generate a build
+
+**Environment Variables**
+Use the following env variables to configure the MCP server.
+
+| Variable Name | Status   | Description                                                       |
+| ------------- | -------- | ----------------------------------------------------------------- |
+| GB_API_KEY    | Required | A GrowthBook API key.                                             |
+| GB_USER       | Required | Your name. Used when creating a feature flag.                     |
+| 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`.  |
+
+Find instructions below to add the MCP server to a client. Any client that supports MCP is also compatible. Consult its documentation for how to add the server.
+
+### Cursor
+
+1. Open **Cursor Settings** → **MCP**
+2. Click **Add new global MCP server**
+3. Add an entry for the GrowthBook MCP, following the pattern below:
+
+```json
+{
+  "mcpServers": {
+    "growthbook": {
+      "command": "node",
+      "args": ["ABSOLUTE_PATH_TO_THE_BUILT_MCP_SERVER"],
+      "env": {
+        "GB_API_KEY": "YOUR_API_KEY",
+        "GB_API_URL": "YOUR_API_URL",
+        "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
+        "GB_USER": "YOUR_NAME"
+      }
+    }
+  }
+}
+```
+
+3. Save the settings.
+
+You should now see a green active status after the server successfully connects!
+
+### VS Code
+
+1. Open **User Settings (JSON)**
+2. Add an MCP entry:
+
+```json
+ "mcp": {
+    "servers": {
+      "growthbook": {
+        "command": "node",
+        "args": [
+          "ABSOLUTE_PATH_TO_THE_BUILT_MCP_SERVER"
+        ],
+        "env": {
+          "GB_API_KEY": "YOUR_API_KEY",
+          "GB_API_URL": "YOUR_API_URL",
+          "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
+          "GB_USER": "YOUR_NAME"
+        }
+      }
+    }
+  }
+```
+
+3. Save your settings.
+
+GrowthBook MCP is now ready to use in VS Code.
+
+### Claude Desktop
+
+1. **Open Settings** → **Developer**
+2. Click **Edit Config**
+3. Open `claude_desktop_config.json`
+4. Add the following configuration:
+
+```json
+{
+  "mcpServers": {
+    "growthbook": {
+      "command": "node",
+      "args": ["ABSOLUTE_PATH_TO_THE_BUILT_MCP_SERVER"],
+      "env": {
+        "GB_API_KEY": "YOUR_API_KEY",
+        "GB_API_URL": "YOUR_API_URL",
+        "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
+        "GB_USER": "YOUR_NAME"
+      }
+    }
+  }
+}
+```
+
+5. Save the config and restart Claude
+
+A hammer icon should appear in the chat window, indicating that your GrowthBook MCP server is connected and available!
+
+---
+
+## Tools
+
+- **Feature Flags**
+
+  - `create_feature_flag`: Create, add, or wrap an element with a feature flag. Specify key, type, default value, and metadata.
+  - `get_feature_flags`: List all feature flags in your GrowthBook instance.
+  - `get_single_feature_flag`: Fetch details for a specific feature flag by ID.
+  - `get_stale_safe_rollouts`: List all safe rollout rules that have been rolled back or released.
+  - `create_force_rule`: Create a feature flag with a targeting condition.
+  - `generate_flag_types`: Generates types for feature flags
+
+- **Experiments**
+
+  - `get_experiments`: List all experiments in GrowthBook.
+  - `get_experiment`: Fetch details for a specific experiment by ID.
+  - `get_attributes`: List all user attributes tracked in GrowthBook (useful for targeting).
+
+- **Environments**
+
+  - `get_environments`: List all environments (e.g., production, staging) configured in GrowthBook.
+
+- **Projects**
+
+  - `get_projects`: List all projects in your GrowthBook instance.
+
+- **SDK Connections**
+
+  - `get_sdk_connections`: List all SDK connections (how GrowthBook connects to your apps).
+  - `create_sdk_connection`: Create a new SDK connection for your app, specifying language and environment.
+
+- **Documentation Search**
+  - `search_growthbook_docs`: Search the GrowthBook documentation for information on how to use a feature, by keyword or question.

package/build/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerEnvironmentTools } from "./tools/environments.js";
+import { registerExperimentTools } from "./tools/experiments.js";
+import { registerFeatureTools } from "./tools/features.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { registerSdkConnectionTools } from "./tools/sdk-connections.js";
+import { getApiKey, getApiUrl, getAppOrigin, getUser } from "./utils.js";
+import { registerSearchTool } from "./tools/search.js";
+export const baseApiUrl = getApiUrl();
+export const apiKey = getApiKey();
+export const appOrigin = getAppOrigin();
+export const user = getUser();
+// Create an MCP server
+const server = new McpServer({
+    name: "GrowthBook MCP",
+    version: "1.0.0",
+}, {
+    instructions: "You are a helpful assistant that interacts with GrowthBook, an open source feature flagging and experimentation platform. You can use tools to create and manage feature flags, experiments, and environments. Note that experiments are also called a/b tests.",
+});
+registerEnvironmentTools({
+    server,
+    baseApiUrl,
+    apiKey,
+});
+registerProjectTools({
+    server,
+    baseApiUrl,
+    apiKey,
+});
+registerSdkConnectionTools({
+    server,
+    baseApiUrl,
+    apiKey,
+});
+registerFeatureTools({
+    server,
+    baseApiUrl,
+    apiKey,
+    appOrigin,
+    user,
+});
+registerExperimentTools({
+    server,
+    baseApiUrl,
+    apiKey,
+    appOrigin,
+});
+registerSearchTool({
+    server,
+});
+// Start receiving messages on stdin and sending messages on stdout
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/build/tools/environments.js

@@ -0,0 +1,27 @@
+import { handleResNotOk } from "../utils.js";
+/**
+ * Tool: get_environments
+ * Description: Fetches all environments from the GrowthBook API. Environments can be used to enable/disable feature flags per environment and control feature delivery segmentation.
+ */
+export function registerEnvironmentTools({ server, baseApiUrl, apiKey, }) {
+    server.tool("get_environments", "Fetches all environments from the GrowthBook API. GrowthBook comes with one environment by default (production), but you can add as many as you need. Feature flags can be enabled and disabled on a per-environment basis. You can also set the default feature state for any new environment. Additionally, you can scope environments to only be available in specific projects, allowing for further control and segmentation over feature delivery.", {}, async () => {
+        try {
+            const res = await fetch(`${baseApiUrl}/api/v1/environments`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+            };
+        }
+    });
+}

package/build/tools/experiments.js

@@ -0,0 +1,183 @@
+import { z } from "zod";
+import { findImplementationDocs, generateLinkToGrowthBook, getDocsMetadata, handleResNotOk, } from "../utils.js";
+export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin, }) {
+    /**
+     * Tool: get_experiments
+     * Description: Fetches all experiments from the GrowthBook API.
+     */
+    server.tool("get_experiments", "Fetches all experiments from the GrowthBook API", {
+        limit: z.number().optional().default(100),
+        offset: z.number().optional().default(0),
+        project: z.string().optional(),
+    }, async ({ limit, offset, project }) => {
+        try {
+            const queryParams = new URLSearchParams({
+                limit: limit?.toString(),
+                offset: offset?.toString(),
+            });
+            if (project)
+                queryParams.append("project", project);
+            const res = await fetch(`${baseApiUrl}/api/v1/experiments?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            console.error("Error fetching experiments:", error);
+            throw error;
+        }
+    });
+    /**
+     * Tool: create_force_rule
+     * Description: Creates a new force rule on an existing feature. A force rule sets a feature to a specific value for a specific environment based on a condition. For A/B tests and experiments, use create_experiment instead.
+     */
+    server.tool("create_force_rule", "Create a new force rule on an existing feature. If the existing feature isn't apparent, create a new feature using create_feature_flag first. A force rule sets a feature to a specific value for a specific environment based on a condition. For A/B tests and experiments, use create_experiment instead.", {
+        featureId: z
+            .string()
+            .describe("The ID of the feature to create the rule on"),
+        description: z.string().optional(),
+        condition: z
+            .string()
+            .describe("Applied to everyone by default. Write conditions in MongoDB-style query syntax.")
+            .optional(),
+        value: z
+            .string()
+            .describe("The type of the value should match the feature type"),
+        environments: z.string().array(),
+        fileExtension: z
+            .enum([
+            ".tsx",
+            ".jsx",
+            ".ts",
+            ".js",
+            ".vue",
+            ".py",
+            ".go",
+            ".php",
+            ".rb",
+            ".java",
+            ".cs",
+        ])
+            .describe("The extension of the current file. If it's unclear, ask the user."),
+    }, async ({ featureId, description, condition, value, environments, fileExtension, }) => {
+        try {
+            const payload = {
+                // Loop through the environments and create a rule for each one keyed by environment name
+                environments: environments.reduce((acc, env) => {
+                    acc[env] = {
+                        enabled: true,
+                        rules: [
+                            {
+                                type: "force",
+                                description,
+                                condition,
+                                value,
+                            },
+                        ],
+                    };
+                    return acc;
+                }, {}),
+            };
+            const res = await fetch(`${baseApiUrl}/api/v1/features/${featureId}`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(payload),
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, "features", featureId);
+            const docsText = await findImplementationDocs(fileExtension);
+            const { docs, language } = getDocsMetadata(fileExtension);
+            const text = `This is the API response: ${JSON.stringify(data, null, 2)}
+      
+        Additionally, here is a template of what to show to the user:
+
+        **✅ Your feature flag \`my-flag-name\` is ready!.**
+        [View it in GrowthBook](${linkToGrowthBook})
+    
+        **How to use it in your code:**
+        (To the LLM agent. Use the text below to properly add the feature flag to the codebase. Also, surface the relevant docs/implemenation to the user)
+
+        ${docsText}
+
+        **Want to learn more?**
+        See the [GrowthBook ${language} docs](${docs})
+      `;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+            };
+        }
+    });
+    /**
+     * Tool: get_experiment
+     * Description: Gets a single experiment from GrowthBook by its ID.
+     */
+    server.tool("get_experiment", "Gets a single experiment from GrowthBook", {
+        experimentId: z.string().describe("The ID of the experiment to get"),
+    }, async ({ experimentId }) => {
+        try {
+            const res = await fetch(`${baseApiUrl}/api/v1/experiments/${experimentId}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, "experiment", experimentId);
+            const text = `
+    ${JSON.stringify(data, null, 2)}
+    
+    [View the experiment in GrowthBook](${linkToGrowthBook})
+    `;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+            };
+        }
+    });
+    /**
+     * Tool: get_attributes
+     * Description: Gets all attributes from the GrowthBook API.
+     */
+    server.tool("get_attributes", "Get all attributes", {}, async () => {
+        try {
+            const queryParams = new URLSearchParams();
+            queryParams.append("limit", "100");
+            const res = await fetch(`${baseApiUrl}/api/v1/attributes?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            console.error("Error fetching attributes:", error);
+            throw error;
+        }
+    });
+}

package/build/tools/features.js

@@ -0,0 +1,260 @@
+import { z } from "zod";
+import { getDocsMetadata, findImplementationDocs, handleResNotOk, generateLinkToGrowthBook, } from "../utils.js";
+export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, user, }) {
+    /**
+     * Tool: create_feature_flag
+     * Description: Creates, adds, or wraps an element with a feature flag in GrowthBook. Allows specifying key, type, default value, and other metadata.
+     */
+    server.tool("create_feature_flag", "Create, add, or wrap an element with a feature flag.", {
+        id: z
+            .string()
+            .regex(/^[a-zA-Z0-9_-]+$/, "Feature key can only include letters, numbers, hyphens, and underscores.")
+            .describe("A unique key name for the feature"),
+        archived: z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe("Whether the feature flag is archived"),
+        description: z
+            .string()
+            .optional()
+            .default("")
+            .describe("A description of the feature flag"),
+        project: z
+            .string()
+            .optional()
+            .default("")
+            .describe("The project the feature flag belongs to"),
+        valueType: z
+            .enum(["string", "number", "boolean", "json"])
+            .describe("The value type the feature flag will return"),
+        defaultValue: z
+            .string()
+            .describe("The default value of the feature flag"),
+        tags: z
+            .array(z.string())
+            .optional()
+            .describe("Tags for the feature flag"),
+        fileExtension: z
+            .enum([
+            ".tsx",
+            ".jsx",
+            ".ts",
+            ".js",
+            ".vue",
+            ".py",
+            ".go",
+            ".php",
+            ".rb",
+            ".java",
+            ".cs",
+        ])
+            .describe("The extension of the current file. If it's unclear, ask the user."),
+    }, async ({ id, archived, description, project, valueType, defaultValue, tags, fileExtension, }) => {
+        const payload = {
+            id,
+            archived,
+            description,
+            owner: user,
+            project,
+            valueType,
+            defaultValue,
+            tags,
+        };
+        try {
+            const res = await fetch(`${baseApiUrl}/api/v1/features`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(payload),
+            });
+            if (!res.ok) {
+                let errorMessage = `HTTP ${res.status} ${res.statusText}`;
+                try {
+                    const errorBody = await res.json();
+                    errorMessage += `: ${JSON.stringify(errorBody)}`;
+                }
+                catch {
+                    // fallback to text if not JSON
+                    const errorText = await res.text();
+                    if (errorText)
+                        errorMessage += `: ${errorText}`;
+                }
+                throw new Error(errorMessage);
+            }
+            const data = await res.json();
+            const docsText = await findImplementationDocs(fileExtension);
+            const { docs, language } = getDocsMetadata(fileExtension);
+            const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, "features", id);
+            const text = `This is the API response: ${JSON.stringify(data, null, 2)}
+      
+        Additionally, here is a template of what to show to the user:
+
+        **✅ Your feature flag \`my-flag-name\` is ready!.**
+        [View it in GrowthBook](${linkToGrowthBook})
+    
+        **How to use it in your code:**
+        (To the LLM agent. Use the text below to properly add the feature flag to the codebase. Also, surface the relevant docs/implemenation to the user)
+
+        ${docsText}
+
+        **Want to learn more?**
+        See the [GrowthBook ${language} docs](${docs})
+      `;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            console.error("Error creating feature flag:", error);
+            throw error;
+        }
+    });
+    /**
+     * Tool: get_feature_flags
+     * Description: Fetches all feature flags from the GrowthBook API, with optional limit, offset, and project filtering.
+     */
+    server.tool("get_feature_flags", "Fetches all feature flags from the GrowthBook API. Flags are returned in the order they were created, from oldest to newest.", {
+        limit: z.number().optional().default(100),
+        offset: z.number().optional().default(0),
+        project: z.string().optional(),
+    }, async ({ limit, offset, project }) => {
+        try {
+            const queryParams = new URLSearchParams({
+                limit: limit?.toString(),
+                offset: offset?.toString(),
+            });
+            if (project)
+                queryParams.append("project", project);
+            const res = await fetch(`${baseApiUrl}/api/v1/features?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            console.error("Error fetching flags:", error);
+            throw error;
+        }
+    });
+    /**
+     * Tool: get_single_feature_flag
+     * Description: Fetches a specific feature flag from the GrowthBook API by its ID, with optional project filtering.
+     */
+    server.tool("get_single_feature_flag", "Fetches a specific feature flag from the GrowthBook API", {
+        id: z.string().describe("The ID of the feature flag"),
+        project: z.string().optional(),
+    }, async ({ id, project }) => {
+        try {
+            const queryParams = new URLSearchParams();
+            if (project)
+                queryParams.append("project", project);
+            const res = await fetch(`${baseApiUrl}/api/v1/features/${id}?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, "features", id);
+            const text = `
+        ${JSON.stringify(data.feature, null, 2)}
+    
+        Share information about the feature flag with the user. In particular, give details about the enabled environments,
+        rules for each environment, and the default value. If the feature flag is archived or doesnt exist, inform the user and 
+        ask if they want to remove references to the feature flag from the codebase. 
+        
+        [View it in GrowthBook](${linkToGrowthBook})
+        `;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            console.error("Error fetching flags:", error);
+            throw error;
+        }
+    });
+    /**
+     * Tool: get_stale_safe_rollouts
+     * Description: Fetches all complete safe rollouts (rolled-back or released) from the GrowthBook API, with optional limit, offset, and project filtering.
+     */
+    server.tool("get_stale_safe_rollouts", "Fetches all complete safe rollouts (rolled-back or released) from the GrowthBook API", {
+        limit: z.number().optional().default(100),
+        offset: z.number().optional().default(0),
+        project: z.string().optional(),
+    }, async ({ limit, offset, project }) => {
+        try {
+            const queryParams = new URLSearchParams({
+                limit: limit?.toString(),
+                offset: offset?.toString(),
+            });
+            if (project)
+                queryParams.append("project", project);
+            const res = await fetch(`${baseApiUrl}/api/v1/features?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            const filteredSafeRollouts = data.features.filter((feature) => {
+                const envs = feature.environments;
+                if (!envs)
+                    return false;
+                return Object.values(envs).some((env) => {
+                    const rules = env.rules;
+                    if (!rules)
+                        return false;
+                    return rules.some((rule) => {
+                        return (rule.type === "safe-rollout" &&
+                            (rule.status === "rolled-back" || rule.status === "released"));
+                    });
+                });
+            });
+            const text = `
+      ${JSON.stringify(filteredSafeRollouts, null, 2)}
+  
+      Share information about the rolled-back or released safe rollout rules with the user. Safe Rollout rules are stored under 
+      environmentSettings, keyed by environment and are within the rules array with a type of "safe-rollout". Ask the user if they
+      would like to remove references to the feature associated with the rolled-back or released safe rollout rules and if they do,
+      remove the references and associated GrowthBook code and replace the values with controlValue if the safe rollout rule is rolled-back or with the 
+      variationValue if the safe rollout is released. In addition to the current file, you may need to update other files in the codebase.
+      `;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            console.error("Error fetching stale safe rollouts:", error);
+            throw error;
+        }
+    });
+    /**
+     * Tool: generate_flag_types
+     * Description: Generates types for feature flags using the GrowthBook CLI.
+     */
+    server.tool("generate_flag_types", "Generate types for feature flags", {}, async () => {
+        const text = `Run the following commands for the user to generate types for their feature flags:
+
+      The first command will log you in to GrowthBook:
+      npx -y growthbook@latest auth login -k ${apiKey} -u ${baseApiUrl} -p default
+
+      The second command will generate types for your feature flags:
+      npx -y growthbook@latest features generate-types -u ${baseApiUrl}
+      `;
+        return {
+            content: [{ type: "text", text }],
+        };
+    });
+}

package/build/tools/projects.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { handleResNotOk } from "../utils.js";
+/**
+ * Tool: get_projects
+ * Description: Fetches all projects from the GrowthBook API, with optional limit and offset for pagination.
+ */
+export function registerProjectTools({ server, baseApiUrl, apiKey, }) {
+    server.tool("get_projects", "Fetches all projects from the GrowthBook API", {
+        limit: z.number().optional().default(10),
+        offset: z.number().optional().default(0),
+    }, async ({ limit, offset }) => {
+        const queryParams = new URLSearchParams({
+            limit: limit.toString(),
+            offset: offset.toString(),
+        });
+        try {
+            const res = await fetch(`${baseApiUrl}/api/v1/projects?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+            };
+        }
+    });
+}

package/build/tools/sdk-connections.js

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { handleResNotOk } from "../utils.js";
+export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
+    /**
+     * Tool: get_sdk_connections
+     * Description: Retrieves all SDK connections, which are how GrowthBook connects to an app.
+     * Users need the key, which is a public key that allows the app to fetch features and experiments from the API.
+     */
+    server.tool("get_sdk_connections", `Get all SDK connections, 
+    which are how GrowthBook connects to an app. 
+    Importantly, users need the key, which is a public client key that allows the app to fetch features and experiments the API `, {
+        limit: z.number().optional().default(100),
+        offset: z.number().optional().default(0),
+        project: z.string().optional(),
+    }, async ({ limit, offset, project }) => {
+        try {
+            const queryParams = new URLSearchParams({
+                limit: limit?.toString(),
+                offset: offset?.toString(),
+            });
+            if (project)
+                queryParams.append("project", project);
+            const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+            };
+        }
+    });
+    /**
+     * Tool: create_sdk_connection
+     * Description: Creates an SDK connection for a user. Returns an SDK clientKey that can be used to fetch features and experiments.
+     * Requires a name, language, and optionally an environment.
+     */
+    server.tool("create_sdk_connection", `Create an SDK connection for a user. Returns an SDK clientKey that can be used to fetch features and experiments.`, {
+        name: z
+            .string()
+            .describe("Name of the SDK connection in GrowthBook. Should reflect the current project."),
+        language: z
+            .enum([
+            "nocode-webflow",
+            "nocode-wordpress",
+            "nocode-shopify",
+            "nocode-other",
+            "javascript",
+            "nodejs",
+            "react",
+            "php",
+            "ruby",
+            "python",
+            "go",
+            "java",
+            "csharp",
+            "android",
+            "ios",
+            "flutter",
+            "elixir",
+            "edge-cloudflare",
+            "edge-fastly",
+            "edge-lambda",
+            "edge-other",
+            "other",
+        ])
+            .describe("The language of the SDK. Either 'javascript' or 'typescript'."),
+        environment: z
+            .string()
+            .optional()
+            .describe("The environment associated with the SDK connection."),
+    }, async ({ name, language, environment }) => {
+        if (!environment) {
+            try {
+                const res = await fetch(`${baseApiUrl}/api/v1/environments`, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                });
+                await handleResNotOk(res);
+                const data = await res.json();
+                const text = `${JSON.stringify(data, null, 2)}
+    
+        Here is the list of environments. Ask the user to select one and use the key in the create_sdk_connection tool.
+        `;
+                return {
+                    content: [{ type: "text", text }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error: ${error}` }],
+                };
+            }
+        }
+        const payload = {
+            name,
+            language,
+            environment,
+        };
+        try {
+            const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(payload),
+            });
+            await handleResNotOk(res);
+            const data = await res.json();
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error}` }],
+            };
+        }
+    });
+}

package/build/tools/search.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { searchGrowthBookDocs } from "../utils.js";
+/**
+ * Tool: search_growthbook_docs
+ * Description: Searches the GrowthBook documentation for information on how to use a feature, based on a user-provided query.
+ */
+export function registerSearchTool({ server }) {
+    server.tool("search_growthbook_docs", "Search the GrowthBook docs on how to use a feature", {
+        query: z
+            .string()
+            .describe("The search query to look up in the GrowthBook docs."),
+    }, async ({ query }) => {
+        const hits = await searchGrowthBookDocs(query);
+        return {
+            content: hits.slice(0, 5).map((hit) => ({
+                type: "text",
+                text: hit.title
+                    ? `${hit.title}: ${hit.url}`
+                    : hit.url || JSON.stringify(hit),
+            })),
+        };
+    });
+}

package/build/utils.js

@@ -0,0 +1,172 @@
+export async function handleResNotOk(res) {
+    if (!res.ok) {
+        let errorMessage = `HTTP ${res.status} ${res.statusText}`;
+        try {
+            const errorBody = await res.json();
+            errorMessage += `: ${JSON.stringify(errorBody)}`;
+        }
+        catch {
+            // fallback to text if not JSON
+            const errorText = await res.text();
+            if (errorText)
+                errorMessage += `: ${errorText}`;
+        }
+        throw new Error(errorMessage);
+    }
+}
+export function getApiKey() {
+    const apiKey = process.env.GB_API_KEY;
+    if (!apiKey) {
+        throw new Error("GB_API_KEY environment variable is required");
+    }
+    return apiKey;
+}
+export function getApiUrl() {
+    const defaultApiUrl = "https://api.growthbook.io";
+    const userApiUrl = process.env.GB_API_URL;
+    return `${userApiUrl || defaultApiUrl}`;
+}
+export function getAppOrigin() {
+    const defaultAppOrigin = "https://app.growthbook.io";
+    const userAppOrigin = process.env.GB_APP_ORIGIN;
+    return `${userAppOrigin || defaultAppOrigin}`;
+}
+export function getUser() {
+    const user = process.env.GB_USER;
+    if (!user) {
+        throw new Error("GB_USER environment variable is required");
+    }
+    return user;
+}
+export function getDocsMetadata(extension) {
+    switch (extension) {
+        case ".tsx":
+        case ".jsx":
+            return {
+                language: "react",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/react.mdx",
+                docs: "https://docs.growthbook.io/lib/react",
+            };
+        case ".ts":
+        case ".js":
+            return {
+                language: "javascript",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/js.mdx",
+                docs: "https://docs.growthbook.io/lib/js",
+            };
+        case ".vue":
+            return {
+                language: "vue",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/vue.mdx",
+                docs: "https://docs.growthbook.io/lib/vue",
+            };
+        case ".py":
+            return {
+                language: "python",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/python.mdx",
+                docs: "https://docs.growthbook.io/lib/python",
+            };
+        case ".go":
+            return {
+                language: "go",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/go.mdx",
+                docs: "https://docs.growthbook.io/lib/go",
+            };
+        case ".php":
+            return {
+                language: "php",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/php.mdx",
+                docs: "https://docs.growthbook.io/lib/php",
+            };
+        case ".rb":
+            return {
+                language: "ruby",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/ruby.mdx",
+                docs: "https://docs.growthbook.io/lib/ruby",
+            };
+        case ".java":
+            return {
+                language: "java",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/java.mdx",
+                docs: "https://docs.growthbook.io/lib/java",
+            };
+        case ".cs":
+            return {
+                language: "csharp",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/csharp.mdx",
+                docs: "https://docs.growthbook.io/lib/csharp",
+            };
+        case ".swift":
+            return {
+                language: "swift",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/swift.mdx",
+                docs: "https://docs.growthbook.io/lib/swift",
+            };
+        case ".ex":
+        case ".exs":
+            return {
+                language: "elixir",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/elixir.mdx",
+                docs: "https://docs.growthbook.io/lib/elixir",
+            };
+        case ".kt":
+        case ".kts":
+        case ".ktm":
+            return {
+                language: "kotlin",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/kotlin.mdx",
+                docs: "https://docs.growthbook.io/lib/kotlin",
+            };
+        case ".dart":
+            return {
+                language: "flutter",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/flutter.mdx",
+                docs: "https://docs.growthbook.io/lib/flutter",
+            };
+        default:
+            return {
+                language: "unknown",
+                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/index.mdx",
+                docs: "https://docs.growthbook.io/lib/",
+            };
+    }
+}
+export async function searchGrowthBookDocs(query) {
+    const APPLICATION_ID = "MN7ZMY63CG";
+    const API_KEY = "e17ebcbd97bce29ad0bdec269770e9df";
+    const INDEX_NAME = "growthbook";
+    const url = `https://${APPLICATION_ID}-dsn.algolia.net/1/indexes/${INDEX_NAME}/query`;
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers: {
+                "X-Algolia-API-Key": API_KEY,
+                "X-Algolia-Application-Id": APPLICATION_ID,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ query }),
+        });
+        await handleResNotOk(response);
+        const data = await response.json();
+        const hits = data.hits || [];
+        return hits;
+    }
+    catch (error) {
+        return [];
+    }
+}
+export async function findImplementationDocs(extension) {
+    const { md } = getDocsMetadata(extension);
+    try {
+        const response = await fetch(md);
+        await handleResNotOk(response);
+        const markdown = await response.text();
+        return markdown;
+    }
+    catch (error) {
+        return "Docs not found";
+    }
+}
+export function generateLinkToGrowthBook(appOrigin, resource, id) {
+    return `${appOrigin}/${resource}/${id}`;
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@growthbook/mcp",
+  "version": "0.1.0",
+  "description": "",
+  "access": "public",
+  "homepage": "https://github.com/growthbook/growthbook-mcp",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc",
+    "bump:patch": "pnpm version patch --no-git-tag-version",
+    "bump:minor": "pnpm version minor --no-git-tag-version",
+    "bump:major": "pnpm version major --no-git-tag-version"
+  },
+  "bin": {
+    "mcp": "build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [],
+  "author": "GrowthBook",
+  "license": "MIT",
+  "packageManager": "pnpm@10.6.1",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.2",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "typescript": "^5.8.3"
+  },
+  "type": "module"
+}