@growthbook/mcp 1.1.0 → 1.3.0

package/package.json

@@ -1,21 +1,23 @@
 {
   "name": "@growthbook/mcp",
-  "version": "1.1.0",
+  "version": "1.3.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",
-    "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"
+    "dev": "tsc --watch",
+    "bump:patch": "npm version patch --no-git-tag-version",
+    "bump:minor": "npm version minor --no-git-tag-version",
+    "bump:major": "npm version major --no-git-tag-version",
+    "mcpb:build": "npx -y @anthropic-ai/mcpb -- pack"
   },
   "bin": {
-    "mcp": "build/index.js"
+    "mcp": "server/index.js"
   },
   "files": [
-    "build"
+    "server"
   ],
   "keywords": [
     "growthbook",
@@ -26,7 +28,6 @@
   ],
   "author": "GrowthBook",
   "license": "MIT",
-  "packageManager": "pnpm@10.6.1",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.17.2",
     "env-paths": "^3.0.0",

package/{build → server}/index.js

@@ -10,6 +10,7 @@ import { getApiKey, getApiUrl, getAppOrigin } from "./utils.js";
 import { registerSearchTools } from "./tools/search.js";
 import { registerDefaultsTools } from "./tools/defaults.js";
 import { registerMetricsTools } from "./tools/metrics.js";
+import { registerExperimentAnalysisPrompt } from "./prompts/experiment-analysis.js";
 export const baseApiUrl = getApiUrl();
 export const apiKey = getApiKey();
 export const appOrigin = getAppOrigin();
@@ -95,6 +96,15 @@ registerMetricsTools({
     appOrigin,
     user,
 });
+registerExperimentAnalysisPrompt({
+    server,
+});
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();
-await server.connect(transport);
+try {
+    await server.connect(transport);
+}
+catch (error) {
+    console.error(error);
+    process.exit(1);
+}

package/server/prompts/experiment-analysis.js

@@ -0,0 +1,13 @@
+export function registerExperimentAnalysisPrompt({ server, }) {
+    server.prompt("experiment-analysis", "Analyze recent experiments and give me actionable advice", () => ({
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: "Use GrowthBook to fetch my recent experiments. Analyze the experiments and tell me:\n\n1. Which experiment types are actually worth running vs. theater?\n\n2. What's the one pattern in our losses that we're blind to?\n\n3. If you could only run 3 experiments next quarter based on these results, what would they be and why?\n\n4. What's the biggest methodological risk in our current approach that could be invalidating results?\n\nBe specific. Use the actual data. Don't give me generic advice.",
+                },
+            },
+        ],
+    }));
+}

package/{build → server}/tools/defaults.js

@@ -249,7 +249,9 @@ export async function getDefaults(apiKey, baseApiUrl) {
  * Tool: get_defaults
  */
 export async function registerDefaultsTools({ server, baseApiUrl, apiKey, }) {
-    server.tool("get_defaults", "Get the default values for experiments, including hypothesis, description, datasource, assignment query, and environments.", {}, async () => {
+    server.tool("get_defaults", "Get the default values for experiments, including hypothesis, description, datasource, assignment query, and environments.", {}, {
+        readOnlyHint: true,
+    }, async () => {
         const defaults = await getDefaults(apiKey, baseApiUrl);
         return {
             content: [
@@ -268,6 +270,9 @@ export async function registerDefaultsTools({ server, baseApiUrl, apiKey, }) {
         environments: z
             .array(z.string())
             .describe("List of environment IDs to use as defaults"),
+    }, {
+        readOnlyHint: false,
+        destructiveHint: true,
     }, async ({ datasourceId, assignmentQueryId, environments }) => {
         try {
             const userDefaults = {
@@ -291,7 +296,10 @@ export async function registerDefaultsTools({ server, baseApiUrl, apiKey, }) {
             throw new Error(`Error setting user defaults: ${error}`);
         }
     });
-    server.tool("clear_user_defaults", "Clear user-defined defaults and revert to automatic defaults.", {}, async () => {
+    server.tool("clear_user_defaults", "Clear user-defined defaults and revert to automatic defaults.", {}, {
+        readOnlyHint: false,
+        destructiveHint: true,
+    }, async () => {
         try {
             await readFile(userDefaultsFile, "utf8");
             await unlink(userDefaultsFile);

package/{build → server}/tools/environments.js

@@ -3,7 +3,9 @@ import { handleResNotOk } from "../utils.js";
  * Tool: get_environments
  */
 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 () => {
+    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.", {}, {
+        readOnlyHint: true,
+    }, async () => {
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/environments`, {
                 headers: {
@@ -18,9 +20,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 → server}/tools/experiments.js

@@ -6,8 +6,18 @@ 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(),
+        mode: z
+            .enum(["default", "analyze"])
+            .default("default")
+            .describe("The mode to use to fetch experiments. Default mode returns summary info about experiments. Analyze mode will also fetch experiment results, allowing for better analysis, interpretation, and reporting."),
         ...paginationSchema,
-    }, async ({ limit, offset, mostRecent }) => {
+    }, {
+        readOnlyHint: true,
+    }, async ({ limit, offset, mostRecent, project, mode }) => {
         try {
             // Default behavior
             if (!mostRecent || offset > 0) {
@@ -15,6 +25,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}`,
@@ -23,6 +36,24 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 });
                 await handleResNotOk(defaultRes);
                 const data = await defaultRes.json();
+                const experiments = data.experiments;
+                if (mode === "analyze") {
+                    for (const [index, experiment] of experiments.entries()) {
+                        try {
+                            const resultsRes = await fetch(`${baseApiUrl}/api/v1/experiments/${experiment.id}/results`, {
+                                headers: {
+                                    Authorization: `Bearer ${apiKey}`,
+                                },
+                            });
+                            await handleResNotOk(resultsRes);
+                            const resultsData = await resultsRes.json();
+                            experiments[index].result = resultsData.result;
+                        }
+                        catch (error) {
+                            console.error(`Error fetching results for experiment ${experiment.id} (${experiment.name})`, error);
+                        }
+                    }
+                }
                 return {
                     content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
                 };
@@ -41,6 +72,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}`,
@@ -51,6 +85,23 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             if (mostRecentData.experiments &&
                 Array.isArray(mostRecentData.experiments)) {
                 mostRecentData.experiments = mostRecentData.experiments.reverse();
+                if (mode === "analyze") {
+                    for (const [index, experiment,] of mostRecentData.experiments.entries()) {
+                        try {
+                            const resultsRes = await fetch(`${baseApiUrl}/api/v1/experiments/${experiment.id}/results`, {
+                                headers: {
+                                    Authorization: `Bearer ${apiKey}`,
+                                },
+                            });
+                            await handleResNotOk(resultsRes);
+                            const resultsData = await resultsRes.json();
+                            mostRecentData.experiments[index].result = resultsData.result;
+                        }
+                        catch (error) {
+                            console.error(`Error fetching results for experiment ${experiment.id} (${experiment.name})`, error);
+                        }
+                    }
+                }
             }
             return {
                 content: [
@@ -62,87 +113,18 @@ 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
      */
     server.tool("get_experiment", "Gets a single experiment from GrowthBook", {
         experimentId: z.string().describe("The ID of the experiment to get"),
-    }, async ({ experimentId }) => {
+        mode: z
+            .enum(["default", "analyze"])
+            .default("default")
+            .describe("The mode to use to fetch the experiment. Default mode returns summary info about the experiment. Analyze mode will also fetch experiment results, allowing for better analysis, interpretation, and reporting."),
+    }, {
+        readOnlyHint: true,
+    }, async ({ experimentId, mode }) => {
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/experiments/${experimentId}`, {
                 headers: {
@@ -152,6 +134,22 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             });
             await handleResNotOk(res);
             const data = await res.json();
+            // If analyze mode, fetch results
+            if (mode === "analyze") {
+                try {
+                    const resultsRes = await fetch(`${baseApiUrl}/api/v1/experiments/${experimentId}/results`, {
+                        headers: {
+                            Authorization: `Bearer ${apiKey}`,
+                        },
+                    });
+                    await handleResNotOk(resultsRes);
+                    const resultsData = await resultsRes.json();
+                    data.result = resultsData.result;
+                }
+                catch (error) {
+                    console.error(`Error fetching results for experiment ${experimentId}`, error);
+                }
+            }
             const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, "experiment", experimentId);
             const text = `
     ${JSON.stringify(data, null, 2)}
@@ -169,7 +167,9 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
     /**
      * Tool: get_attributes
      */
-    server.tool("get_attributes", "Get all attributes", {}, async () => {
+    server.tool("get_attributes", "Get all attributes", {}, {
+        readOnlyHint: true,
+    }, async () => {
         try {
             const queryParams = new URLSearchParams();
             queryParams.append("limit", "100");
@@ -201,7 +201,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 +216,20 @@ 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, }) => {
+    }, {
+        readOnlyHint: false,
+        destructiveHint: false,
+    }, async ({ description, hypothesis, name, variations, fileExtension, confirmedDefaultsReviewed, project, }) => {
         if (!confirmedDefaultsReviewed) {
             return {
                 content: [
@@ -249,6 +255,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 → server}/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,16 @@ 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,
+    }, {
+        readOnlyHint: false,
+        destructiveHint: false,
+    }, async ({ id, valueType, defaultValue, description, project, fileExtension, }) => {
         // get environments
         let environments = [];
         const defaults = await getDefaults(apiKey, baseApiUrl);
@@ -57,6 +48,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                 };
                 return acc;
             }, {}),
+            ...(project && { project }),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/features`, {
@@ -72,6 +64,79 @@ 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"),
+    }, {
+        readOnlyHint: false,
+    }, 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 +156,26 @@ 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 }) => {
+    }, {
+        readOnlyHint: true,
+    }, 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 +196,12 @@ 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,
+    }, {
+        readOnlyHint: true,
+    }, 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 +212,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 {
@@ -164,6 +233,8 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
     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),
+    }, {
+        readOnlyHint: true,
     }, async ({ limit, offset }) => {
         try {
             const queryParams = new URLSearchParams({
@@ -193,14 +264,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 }],
             };
@@ -216,6 +287,9 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
         currentWorkingDirectory: z
             .string()
             .describe("The current working directory of the user's project"),
+    }, {
+        readOnlyHint: false,
+        idempotentHint: true,
     }, async ({ currentWorkingDirectory }) => {
         function runCommand(command, cwd) {
             return new Promise((resolve, reject) => {

package/{build → server}/tools/metrics.js

@@ -4,14 +4,23 @@ 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 }) => {
+    }, {
+        readOnlyHint: true,
+    }, 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}`,
@@ -47,6 +56,8 @@ export function registerMetricsTools({ server, baseApiUrl, apiKey, appOrigin, })
      */
     server.tool("get_metric", "Fetches a metric from the GrowthBook API", {
         metricId: z.string().describe("The ID of the metric to get"),
+    }, {
+        readOnlyHint: true,
     }, async ({ metricId }) => {
         try {
             let res;

package/{build → server}/tools/projects.js

@@ -5,6 +5,8 @@ import { handleResNotOk, paginationSchema, } from "../utils.js";
 export function registerProjectTools({ server, baseApiUrl, apiKey, }) {
     server.tool("get_projects", "Fetches all projects from the GrowthBook API", {
         ...paginationSchema,
+    }, {
+        readOnlyHint: true,
     }, async ({ limit, offset }) => {
         const queryParams = new URLSearchParams({
             limit: limit.toString(),
@@ -24,9 +26,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 → server}/tools/sdk-connections.js

@@ -5,13 +5,22 @@ 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 }) => {
+    }, {
+        readOnlyHint: true,
+    }, 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 +69,19 @@ 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(),
+    }, {
+        readOnlyHint: false,
+        destructiveHint: false,
+    }, async ({ name, language, environment, projects }) => {
         if (!environment) {
             try {
                 const res = await fetch(`${baseApiUrl}/api/v1/environments`, {
@@ -94,6 +110,7 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             name,
             language,
             environment,
+            ...(projects && { projects }),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections`, {

package/{build → server}/tools/search.js

@@ -8,6 +8,8 @@ export function registerSearchTools({ server }) {
         query: z
             .string()
             .describe("The search query to look up in the GrowthBook docs."),
+    }, {
+        readOnlyHint: true,
     }, async ({ query }) => {
         const hits = await searchGrowthBookDocs(query);
         return {

package/{build → server}/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."),
+};