@growthbook/mcp 1.7.0 → 1.8.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@growthbook/mcp",
   "mcpName": "io.github.growthbook/growthbook-mcp",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "MCP Server for interacting with GrowthBook",
   "access": "public",
   "homepage": "https://github.com/growthbook/growthbook-mcp",
@@ -38,12 +38,12 @@
   "author": "GrowthBook",
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "env-paths": "^4.0.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@types/node": "^25.1.0",
+    "@types/node": "^25.3.5",
     "@vitest/coverage-v8": "^4.0.18",
     "typescript": "^5.9.2",
     "vitest": "^4.0.18"

package/server/format-responses.js

@@ -425,25 +425,6 @@ export function formatDefaults(defaults) {
     return parts.join("\n");
 }
 // ─── Stale Features ─────────────────────────────────────────────────
-// Common SDK patterns to search for when removing a flag from the codebase
-const SDK_PATTERNS = [
-    // JS/TS/React
-    "isOn",
-    "getFeatureValue",
-    "useFeatureIsOn",
-    "useFeatureValue",
-    "evalFeature",
-    // Python
-    "is_on",
-    "get_feature_value",
-    // Go / Ruby / other
-    "IsOn",
-    "GetFeatureValue",
-    "feature_is_on",
-];
-function buildSearchPatterns(flagId) {
-    return SDK_PATTERNS.map((fn) => `${fn}("${flagId}")`).join(", ");
-}
 export function formatStaleFeatureFlags(data, requestedIds) {
     const features = data.features || {};
     const foundIds = Object.keys(features);
@@ -509,7 +490,7 @@ export function formatStaleFeatureFlags(data, requestedIds) {
             parts.push(`- **\`${f.featureId}\`**: STALE (${f.staleReason}) — needs manual review`);
         }
         parts.push(`  ${envNote}`);
-        parts.push(`  Search for: ${buildSearchPatterns(id)}`);
+        parts.push(`  Search for \`${id}\` in relevant source files to find usages.`);
         parts.push("");
     }
     // Summary

package/server/tools/experiments/experiments.js

@@ -242,12 +242,16 @@ 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."),
+            customFields: z
+                .record(z.string(), z.string())
+                .optional()
+                .describe("Custom field values as key-value pairs. Keys are custom field IDs, values are string representations (e.g. {\"priority\": \"high\", \"team\": \"growth\"})."),
         }),
         annotations: {
             readOnlyHint: false,
             destructiveHint: false,
         },
-    }, async ({ description, hypothesis, name, valueType, variations, fileExtension, confirmedDefaultsReviewed, project, featureId, }) => {
+    }, async ({ description, hypothesis, name, valueType, variations, fileExtension, confirmedDefaultsReviewed, project, featureId, customFields, }) => {
         if (!confirmedDefaultsReviewed) {
             return {
                 content: [
@@ -275,6 +279,7 @@ export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin,
                 name: variation.name,
             })),
             ...(project && { project }),
+            ...(customFields && { customFields }),
         };
         try {
             const experimentRes = await fetchWithRateLimit(`${baseApiUrl}/api/v1/experiments`, {

package/server/tools/features.js

@@ -15,7 +15,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             readOnlyHint: false,
             destructiveHint: false,
         },
-    }, async ({ id, valueType, defaultValue, description, project, fileExtension, }) => {
+    }, async ({ id, valueType, defaultValue, description, project, fileExtension, customFields, }) => {
         // get environments
         let environments = [];
         const defaults = await getDefaults(apiKey, baseApiUrl);
@@ -45,6 +45,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                 return acc;
             }, {}),
             ...(project && { project }),
+            ...(customFields && { customFields }),
         };
         try {
             const res = await fetchWithRateLimit(`${baseApiUrl}/api/v1/features`, {
@@ -192,12 +193,12 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
      */
     server.registerTool("get_stale_feature_flags", {
         title: "Get Stale Feature Flags",
-        description: "Given a list of feature flag IDs, checks whether each one is stale and returns cleanup guidance including replacement values and SDK search patterns. You MUST provide featureIds — gather them first from the user, from the current file context, or by grepping the codebase for SDK patterns (isOn, getFeatureValue, useFeatureIsOn, useFeatureValue, evalFeature).",
+        description: "Given a list of feature flag IDs, checks whether each one is stale and returns cleanup guidance including replacement values and SDK search patterns. You MUST provide featureIds — gather them first from the user, from the current file context, or by using the get_feature_flags tool to list all flags and then searching the codebase for those flag IDs to determine which are present.",
         inputSchema: z.object({
             featureIds: z
                 .array(z.string())
                 .optional()
-                .describe("REQUIRED. One or more feature flag IDs to check (e.g. [\"my-feature\", \"dark-mode\"]). Gather IDs first from the user, from code context, or by grepping for SDK usage patterns."),
+                .describe("REQUIRED. One or more feature flag IDs to check (e.g. [\"my-feature\", \"dark-mode\"]). Gather IDs first from the user, from code context, or by using get_feature_flags to list flags and searching the codebase for those IDs."),
         }),
         annotations: {
             readOnlyHint: true,
@@ -215,8 +216,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                                 "To gather feature flag IDs, try one of these approaches:",
                                 "1. **Ask the user** which flags they want to check",
                                 "2. **Extract from current file context** — look for flag IDs in the open file",
-                                "3. **Grep the codebase** for GrowthBook SDK patterns:",
-                                '   `grep -rn "isOn\\|getFeatureValue\\|useFeatureIsOn\\|useFeatureValue\\|evalFeature" --include="*.{ts,tsx,js,jsx,py,go,rb}"`',
+                                "3. **Use the `get_feature_flags` tool** to list all flags, then search the codebase for those flag IDs to determine which are present",
                                 "",
                                 "Then call this tool again with the discovered flag IDs.",
                             ].join("\n"),

package/server/utils.js

@@ -405,6 +405,10 @@ export const featureFlagSchema = {
     fileExtension: z
         .enum(SUPPORTED_FILE_EXTENSIONS)
         .describe("The extension of the current file. If it's unclear, ask the user."),
+    customFields: z
+        .record(z.string(), z.string())
+        .optional()
+        .describe("Custom field values as key-value pairs. Keys are custom field IDs, values are string representations (e.g. {\"priority\": \"high\", \"team\": \"growth\"})."),
 };
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));