@growthbook/mcp 1.2.0 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthbook/mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "MCP Server for interacting with GrowthBook",
   "access": "public",
   "homepage": "https://github.com/growthbook/growthbook-mcp",
@@ -8,15 +8,16 @@
     "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"
+    "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",
@@ -27,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: {

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

@@ -10,8 +10,14 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
             .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, project }) => {
+    }, {
+        readOnlyHint: true,
+    }, async ({ limit, offset, mostRecent, project, mode }) => {
         try {
             // Default behavior
             if (!mostRecent || offset > 0) {
@@ -30,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) }],
                 };
@@ -61,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: [
@@ -77,7 +118,13 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
      */
     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: {
@@ -87,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)}
@@ -104,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");
@@ -161,6 +226,9 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
         confirmedDefaultsReviewed: z
             .boolean()
             .describe("Set to true to confirm you have called get_defaults and reviewed the output to guide these parameters."),
+    }, {
+        readOnlyHint: false,
+        destructiveHint: false,
     }, async ({ description, hypothesis, name, variations, fileExtension, confirmedDefaultsReviewed, project, }) => {
         if (!confirmedDefaultsReviewed) {
             return {

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

@@ -13,6 +13,9 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
         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 = [];
@@ -97,6 +100,8 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
         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
@@ -160,6 +165,8 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
     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,
+    }, {
+        readOnlyHint: true,
     }, async ({ limit, offset, project }) => {
         try {
             const queryParams = new URLSearchParams({
@@ -190,6 +197,8 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
      */
     server.tool("get_single_feature_flag", "Fetches a specific feature flag from the GrowthBook API", {
         id: featureFlagSchema.id,
+    }, {
+        readOnlyHint: true,
     }, async ({ id }) => {
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/features/${id}`, {
@@ -224,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({
@@ -276,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

@@ -10,6 +10,8 @@ export function registerMetricsTools({ server, baseApiUrl, apiKey, appOrigin, })
             .describe("The ID of the project to filter metrics by")
             .optional(),
         ...paginationSchema,
+    }, {
+        readOnlyHint: true,
     }, async ({ limit, offset, project }) => {
         try {
             const queryParams = new URLSearchParams({
@@ -54,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(),

package/{build → server}/tools/sdk-connections.js

@@ -10,6 +10,8 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             .describe("The ID of the project to filter SDK connections by")
             .optional(),
         ...paginationSchema,
+    }, {
+        readOnlyHint: true,
     }, async ({ limit, offset, project }) => {
         try {
             const queryParams = new URLSearchParams({
@@ -76,6 +78,9 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             .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 {

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 {