@growthbook/mcp 0.1.3 → 1.0.0

package/README.md

@@ -14,7 +14,7 @@ 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_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`.  |
 
@@ -36,7 +36,7 @@ Find instructions below to add the MCP server to a client. Any client that suppo
         "GB_API_KEY": "YOUR_API_KEY",
         "GB_API_URL": "YOUR_API_URL",
         "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
-        "GB_USER": "YOUR_NAME"
+        "GB_EMAIL": "YOUR_EMAIL"
       }
     }
   }
@@ -64,7 +64,7 @@ You should now see a green active status after the server successfully connects!
           "GB_API_KEY": "YOUR_API_KEY",
           "GB_API_URL": "YOUR_API_URL",
           "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
-          "GB_USER": "YOUR_NAME"
+          "GB_EMAIL": "YOUR_EMAIL"
         }
       }
     }
@@ -92,7 +92,7 @@ GrowthBook MCP is now ready to use in VS Code.
         "GB_API_KEY": "YOUR_API_KEY",
         "GB_API_URL": "YOUR_API_URL",
         "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
-        "GB_USER": "YOUR_NAME"
+        "GB_EMAIL": "YOUR_EMAIL"
       }
     }
   }

package/build/index.js

@@ -12,7 +12,7 @@ import { registerDefaultsTools } from "./tools/defaults.js";
 export const baseApiUrl = getApiUrl();
 export const apiKey = getApiKey();
 export const appOrigin = getAppOrigin();
-export const user = getUser();
+export const user = await getUser(baseApiUrl, apiKey);
 // Create an MCP server
 const server = new McpServer({
     name: "GrowthBook MCP",

package/build/tools/experiments.js

@@ -57,7 +57,7 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 // Loop through the environments and create a rule for each one keyed by environment name
                 environments: defaultEnvironments.reduce((acc, env) => {
                     acc[env] = {
-                        enabled: true,
+                        enabled: false,
                         rules: [
                             {
                                 type: "force",
@@ -176,7 +176,12 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 .string()
                 .describe("Variation name. Base name off the examples from get_defaults. If none are available, use a short, descriptive name that captures the essence of the variation."),
             value: z
-                .union([z.string(), z.number(), z.boolean(), z.record(z.any())])
+                .union([
+                z.string(),
+                z.number(),
+                z.boolean(),
+                z.record(z.string(), z.any()),
+            ])
                 .describe("The value of the control and each of the variations. The value should be a string, number, boolean, or object. If it's an object, it should be a valid JSON object."),
         }))
             .describe("Experiment variations. The key should be the variation name and the value should be the variation value. Look to variations included in preview experiments for guidance on generation. The default or control variation should always be first."),
@@ -203,6 +208,7 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             name,
             description,
             hypothesis,
+            owner: user.email,
             trackingKey: name.toLowerCase().replace(/[^a-z0-9]/g, "-"),
             tags: ["mcp"],
             assignmentQueryId: experimentDefaults?.assignmentQuery,
@@ -226,7 +232,7 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             const flagId = `flag_${name.toLowerCase().replace(/[^a-z0-9]/g, "_")}`;
             const flagPayload = {
                 id: flagId,
-                owner: user,
+                owner: user.name,
                 defaultValue: variations[0].value,
                 valueType: typeof variations[0].value === "string"
                     ? "string"
@@ -237,7 +243,7 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 environments: {
                     ...experimentDefaults.environments.reduce((acc, env) => {
                         acc[env] = {
-                            enabled: true,
+                            enabled: false,
                             rules: [
                                 {
                                     type: "experiment-ref",

package/build/tools/features.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { getDocsMetadata, handleResNotOk, generateLinkToGrowthBook, SUPPORTED_FILE_EXTENSIONS, } from "../utils.js";
 import { exec } from "child_process";
+import { getDefaults } from "./defaults.js";
 export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, user, }) {
     /**
      * Tool: create_feature_flag
@@ -14,7 +15,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             .string()
             .optional()
             .default("")
-            .describe("A briefdescription of the feature flag"),
+            .describe("A brief description of the feature flag"),
         valueType: z
             .enum(["string", "number", "boolean", "json"])
             .describe("The value type the feature flag will return"),
@@ -25,13 +26,37 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             .enum(SUPPORTED_FILE_EXTENSIONS)
             .describe("The extension of the current file. If it's unclear, ask the user."),
     }, async ({ id, description, valueType, defaultValue, fileExtension }) => {
+        // get environments
+        let environments = [];
+        const defaults = await getDefaults(apiKey, baseApiUrl);
+        if (defaults.environments) {
+            environments = defaults.environments;
+        }
+        else {
+            const envRes = await fetch(`${baseApiUrl}/api/v1/features/environments`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(envRes);
+            const envData = await envRes.json();
+            environments = envData.environments.map((env) => env.id);
+        }
         const payload = {
             id,
             description,
-            owner: user,
+            owner: user.name,
             valueType,
             defaultValue,
             tags: ["mcp"],
+            environments: environments.reduce((acc, env) => {
+                acc[env] = {
+                    enabled: false,
+                    rules: [],
+                };
+                return acc;
+            }, {}),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/features`, {

package/build/utils.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { getFeatureFlagDocs } from "./docs.js";
 // Shared file extension enum for all MCP tools
 export const SUPPORTED_FILE_EXTENSIONS = [
@@ -52,12 +53,39 @@ export function getAppOrigin() {
     const userAppOrigin = process.env.GB_APP_ORIGIN;
     return `${userAppOrigin || defaultAppOrigin}`;
 }
-export function getUser() {
-    const user = process.env.GB_USER;
+export async function getUser(baseApiUrl, apiKey) {
+    const user = process.env.GB_EMAIL || process.env.GB_USER;
     if (!user) {
-        throw new Error("GB_USER environment variable is required");
+        throw new Error("GB_EMAIL environment variable is required");
+    }
+    // Show deprecation warning if using the old variable
+    if (process.env.GB_USER && !process.env.GB_EMAIL) {
+        console.error("⚠️  GB_USER is deprecated. Use GB_EMAIL instead.");
+    }
+    const emailSchema = z.string().email();
+    if (!emailSchema.safeParse(user).success) {
+        throw new Error("GB_EMAIL is not a valid email");
+    }
+    try {
+        const users = await fetch(`${baseApiUrl}/api/v1/members?userEmail=${user}`, {
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+            },
+        });
+        await handleResNotOk(users);
+        const usersData = await users.json();
+        if (usersData.members.length === 0) {
+            throw new Error(`Email not found in GrowthBook. Update GB_EMAIL environment variable to your email address in GrowthBook.`);
+        }
+        const userFromGrowthBook = {
+            email: usersData.members[0].email,
+            name: usersData.members[0].name,
+        };
+        return userFromGrowthBook;
+    }
+    catch (error) {
+        throw new Error(`Error fetching user from GrowthBook. Please check your GB_EMAIL and GB_API_KEY environment variables.`);
     }
-    return user;
 }
 export function getDocsMetadata(extension) {
     switch (extension) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthbook/mcp",
-  "version": "0.1.3",
+  "version": "1.0.0",
   "description": "",
   "access": "public",
   "homepage": "https://github.com/growthbook/growthbook-mcp",
@@ -22,13 +22,13 @@
   "license": "MIT",
   "packageManager": "pnpm@10.6.1",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.13.1",
+    "@modelcontextprotocol/sdk": "^1.17.2",
     "env-paths": "^3.0.0",
     "zod": "^3.25.67"
   },
   "devDependencies": {
-    "@types/node": "^24.0.4",
-    "typescript": "^5.8.3"
+    "@types/node": "^24.2.1",
+    "typescript": "^5.9.2"
   },
   "type": "module"
 }