@growthbook/mcp 1.1.0 → 1.2.0

package/build/tools/environments.js

@@ -18,9 +18,7 @@ export function registerEnvironmentTools({ server, baseApiUrl, apiKey, }) {
             };
         }
         catch (error) {
-            return {
-                content: [{ type: "text", text: `Error: ${error}` }],
-            };
+            throw new Error(`Error fetching environments: ${error}`);
         }
     });
 }

package/build/tools/experiments.js

@@ -6,8 +6,12 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
      * Tool: get_experiments
      */
     server.tool("get_experiments", "Fetches experiments from the GrowthBook API", {
+        project: z
+            .string()
+            .describe("The ID of the project to filter experiments by")
+            .optional(),
         ...paginationSchema,
-    }, async ({ limit, offset, mostRecent }) => {
+    }, async ({ limit, offset, mostRecent, project }) => {
         try {
             // Default behavior
             if (!mostRecent || offset > 0) {
@@ -15,6 +19,9 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                     limit: limit.toString(),
                     offset: offset.toString(),
                 });
+                if (project) {
+                    defaultQueryParams.append("projectId", project);
+                }
                 const defaultRes = await fetch(`${baseApiUrl}/api/v1/experiments?${defaultQueryParams.toString()}`, {
                     headers: {
                         Authorization: `Bearer ${apiKey}`,
@@ -41,6 +48,9 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 limit: limit.toString(),
                 offset: calculatedOffset.toString(),
             });
+            if (project) {
+                mostRecentQueryParams.append("projectId", project);
+            }
             const mostRecentRes = await fetch(`${baseApiUrl}/api/v1/experiments?${mostRecentQueryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -62,81 +72,6 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             throw new Error(`Error fetching experiments: ${error}`);
         }
     });
-    /**
-     * Tool: create_force_rule
-     */
-    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 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"),
-        fileExtension: z
-            .enum(SUPPORTED_FILE_EXTENSIONS)
-            .describe("The extension of the current file. If it's unclear, ask the user."),
-    }, async ({ featureId, description, condition, value, fileExtension }) => {
-        try {
-            // Fetch feature defaults first and surface to user
-            const defaults = await getDefaults(apiKey, baseApiUrl);
-            const defaultEnvironments = defaults.environments;
-            const payload = {
-                // Loop through the environments and create a rule for each one keyed by environment name
-                environments: defaultEnvironments.reduce((acc, env) => {
-                    acc[env] = {
-                        enabled: false,
-                        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 { docs, language, stub } = 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)
-
-        ${stub}
-
-        **Want to learn more?**
-        See the [GrowthBook ${language} docs](${docs})
-      `;
-            return {
-                content: [{ type: "text", text }],
-            };
-        }
-        catch (error) {
-            throw new Error(`Error creating force rule: ${error}`);
-        }
-    });
     /**
      * Tool: get_experiment
      */
@@ -201,7 +136,6 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             .string()
             .optional()
             .describe("Experiment hypothesis. Base hypothesis off the examples from get_defaults. If none are available, use a falsifiable statement about what will happen if the experiment succeeds or fails."),
-        value: z.string().describe("The default value of the experiment."),
         variations: z
             .array(z.object({
             name: z
@@ -217,13 +151,17 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 .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."),
+        project: z
+            .string()
+            .describe("The ID of the project to create the experiment in")
+            .optional(),
         fileExtension: z
             .enum(SUPPORTED_FILE_EXTENSIONS)
             .describe("The extension of the current file. If it's unclear, ask the user."),
         confirmedDefaultsReviewed: z
             .boolean()
             .describe("Set to true to confirm you have called get_defaults and reviewed the output to guide these parameters."),
-    }, async ({ description, hypothesis, name, variations, fileExtension, confirmedDefaultsReviewed, }) => {
+    }, async ({ description, hypothesis, name, variations, fileExtension, confirmedDefaultsReviewed, project, }) => {
         if (!confirmedDefaultsReviewed) {
             return {
                 content: [
@@ -249,6 +187,7 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 key: idx.toString(),
                 name: variation.name,
             })),
+            ...(project && { project }),
         };
         try {
             const experimentRes = await fetch(`${baseApiUrl}/api/v1/experiments`, {

package/build/tools/features.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { getDocsMetadata, handleResNotOk, generateLinkToGrowthBook, SUPPORTED_FILE_EXTENSIONS, paginationSchema, } from "../utils.js";
+import { getDocsMetadata, handleResNotOk, generateLinkToGrowthBook, paginationSchema, featureFlagSchema, } from "../utils.js";
 import { exec } from "child_process";
 import { getDefaults } from "./defaults.js";
 export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, user, }) {
@@ -7,25 +7,13 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
      * Tool: create_feature_flag
      */
     server.tool("create_feature_flag", "Creates a new feature flag in GrowthBook and modifies the codebase when relevant.", {
-        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"),
-        description: z
-            .string()
-            .optional()
-            .default("")
-            .describe("A brief description of the feature flag"),
-        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"),
-        fileExtension: z
-            .enum(SUPPORTED_FILE_EXTENSIONS)
-            .describe("The extension of the current file. If it's unclear, ask the user."),
-    }, async ({ id, description, valueType, defaultValue, fileExtension }) => {
+        id: featureFlagSchema.id,
+        valueType: featureFlagSchema.valueType,
+        defaultValue: featureFlagSchema.defaultValue,
+        description: featureFlagSchema.description.optional().default(""),
+        project: featureFlagSchema.project.optional(),
+        fileExtension: featureFlagSchema.fileExtension,
+    }, async ({ id, valueType, defaultValue, description, project, fileExtension, }) => {
         // get environments
         let environments = [];
         const defaults = await getDefaults(apiKey, baseApiUrl);
@@ -57,6 +45,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                 };
                 return acc;
             }, {}),
+            ...(project && { project }),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/features`, {
@@ -72,6 +61,77 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             const { docs, language, stub } = 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)
+
+        ${stub}
+
+        **Want to learn more?**
+        See the [GrowthBook ${language} docs](${docs})
+      `;
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            throw new Error(`Error creating feature flag: ${error}`);
+        }
+    });
+    /**
+     * Tool: create_force_rule
+     */
+    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 based on a condition. For A/B tests and experiments, use create_experiment instead.", {
+        featureId: featureFlagSchema.id,
+        description: featureFlagSchema.description.optional().default(""),
+        fileExtension: featureFlagSchema.fileExtension,
+        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"),
+    }, async ({ featureId, description, condition, value, fileExtension }) => {
+        try {
+            // Fetch feature defaults first and surface to user
+            const defaults = await getDefaults(apiKey, baseApiUrl);
+            const defaultEnvironments = defaults.environments;
+            const payload = {
+                // Loop through the environments and create a rule for each one keyed by environment name
+                environments: defaultEnvironments.reduce((acc, env) => {
+                    acc[env] = {
+                        enabled: false,
+                        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 { docs, language, stub } = 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:
 
@@ -91,20 +151,24 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             };
         }
         catch (error) {
-            throw new Error(`Error creating feature flag: ${error}`);
+            throw new Error(`Error creating force rule: ${error}`);
         }
     });
     /**
      * Tool: get_feature_flags
      */
     server.tool("get_feature_flags", "Fetches all feature flags from the GrowthBook API, with optional limit, offset, and project filtering.", {
+        project: featureFlagSchema.project.optional(),
         ...paginationSchema,
-    }, async ({ limit, offset }) => {
+    }, async ({ limit, offset, project }) => {
         try {
             const queryParams = new URLSearchParams({
                 limit: limit?.toString(),
                 offset: offset?.toString(),
             });
+            if (project) {
+                queryParams.append("projectId", project);
+            }
             const res = await fetch(`${baseApiUrl}/api/v1/features?${queryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -125,14 +189,10 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
      * Tool: get_single_feature_flag
      */
     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 }) => {
+        id: featureFlagSchema.id,
+    }, async ({ id }) => {
         try {
-            const queryParams = new URLSearchParams();
-            if (project)
-                queryParams.append("project", project);
-            const res = await fetch(`${baseApiUrl}/api/v1/features/${id}?${queryParams.toString()}`, {
+            const res = await fetch(`${baseApiUrl}/api/v1/features/${id}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
                     "Content-Type": "application/json",
@@ -143,11 +203,11 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             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. 
-        
+        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 {
@@ -193,14 +253,14 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                 });
             });
             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.
-      `;
+        ${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 }],
             };

package/build/tools/metrics.js

@@ -4,14 +4,21 @@ export function registerMetricsTools({ server, baseApiUrl, apiKey, appOrigin, })
     /**
      * Tool: get_metrics
      */
-    server.tool("get_metrics", "Fetches metrics from the GrowthBook API", {
+    server.tool("get_metrics", "Fetches metrics from the GrowthBook API, with optional limit, offset, and project filtering.", {
+        project: z
+            .string()
+            .describe("The ID of the project to filter metrics by")
+            .optional(),
         ...paginationSchema,
-    }, async ({ limit, offset }) => {
+    }, async ({ limit, offset, project }) => {
         try {
             const queryParams = new URLSearchParams({
                 limit: limit?.toString(),
                 offset: offset?.toString(),
             });
+            if (project) {
+                queryParams.append("projectId", project);
+            }
             const metricsRes = await fetch(`${baseApiUrl}/api/v1/metrics?${queryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,

package/build/tools/projects.js

@@ -24,9 +24,7 @@ export function registerProjectTools({ server, baseApiUrl, apiKey, }) {
             };
         }
         catch (error) {
-            return {
-                content: [{ type: "text", text: `Error: ${error}` }],
-            };
+            throw new Error(`Error fetching projects: ${error}`);
         }
     });
 }

package/build/tools/sdk-connections.js

@@ -5,13 +5,20 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
      * Tool: get_sdk_connections
      */
     server.tool("get_sdk_connections", "Get all SDK connections. SDK connections are how GrowthBook connects to an app. Users need the client key to fetch features and experiments from the API.", {
+        project: z
+            .string()
+            .describe("The ID of the project to filter SDK connections by")
+            .optional(),
         ...paginationSchema,
-    }, async ({ limit, offset }) => {
+    }, async ({ limit, offset, project }) => {
         try {
             const queryParams = new URLSearchParams({
                 limit: limit?.toString(),
                 offset: offset?.toString(),
             });
+            if (project) {
+                queryParams.append("projectId", project);
+            }
             const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections?${queryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -60,12 +67,16 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             "edge-other",
             "other",
         ])
-            .describe("The language of the SDK. Either 'javascript' or 'typescript'."),
+            .describe("The language or platform for the SDK connection."),
         environment: z
             .string()
             .optional()
             .describe("The environment associated with the SDK connection."),
-    }, async ({ name, language, environment }) => {
+        projects: z
+            .array(z.string())
+            .describe("The projects to create the SDK connection in")
+            .optional(),
+    }, async ({ name, language, environment, projects }) => {
         if (!environment) {
             try {
                 const res = await fetch(`${baseApiUrl}/api/v1/environments`, {
@@ -94,6 +105,7 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             name,
             language,
             environment,
+            ...(projects && { projects }),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections`, {

package/build/utils.js

@@ -191,3 +191,22 @@ export const paginationSchema = {
         .default(false)
         .describe("When true, fetches the most recent items and returns them newest-first. When false (default), returns oldest items first."),
 };
+export const featureFlagSchema = {
+    id: z
+        .string()
+        .regex(/^[a-zA-Z0-9_.:|_-]+$/, "Feature key can only include letters, numbers, and the characters _, -, ., :, and |")
+        .describe("A unique key name for the feature"),
+    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"),
+    description: z.string().describe("A brief description of the feature flag"),
+    archived: z.boolean().describe("Whether the feature flag should be archived"),
+    project: z
+        .string()
+        .describe("The ID of the project to which the feature flag belongs"),
+    // Contextual info
+    fileExtension: z
+        .enum(SUPPORTED_FILE_EXTENSIONS)
+        .describe("The extension of the current file. If it's unclear, ask the user."),
+};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@growthbook/mcp",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "MCP Server for interacting with GrowthBook",
   "access": "public",
   "homepage": "https://github.com/growthbook/growthbook-mcp",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "build": "tsc",
+    "dev": "tsc --watch",
     "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"