@growthbook/mcp 1.7.0 → 1.8.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@growthbook/mcp",
   "mcpName": "io.github.growthbook/growthbook-mcp",
-  "version": "1.7.0",
+  "version": "1.8.1",
   "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`, {
@@ -139,7 +140,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
      */
     server.registerTool("get_feature_flags", {
         title: "Get Feature Flags",
-        description: "Lists feature flags in your GrowthBook organization, or fetches details for a specific flag by ID. Use to find existing flags before creating new ones, get a flag's current configuration and rules, or find flag IDs needed for create_force_rule or create_experiment. Single flag fetch (via featureFlagId) returns full config including environment rules. If flag is archived, suggest removing from codebase.",
+        description: "Lists feature flags with full details (rules, environments, values) or fetches a single flag by ID. Returns up to 100 flags per page. Use to inspect flag configuration, rules, and status. For a lightweight list of all flag IDs (no limit), use list_feature_keys instead.",
         inputSchema: z.object({
             project: featureFlagSchema.project.optional(),
             featureFlagId: featureFlagSchema.id.optional(),
@@ -187,17 +188,57 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             ]));
         }
     });
+    /**
+     * Tool: list_feature_keys
+     */
+    server.registerTool("list_feature_keys", {
+        title: "List Feature Keys",
+        description: "Returns all feature flag IDs (keys only, no details) in your GrowthBook organization. Useful for discovering flag IDs when you need to check a large number of flags — for example, before calling get_stale_feature_flags. Optionally filter by project.",
+        inputSchema: z.object({
+            projectId: z
+                .string()
+                .optional()
+                .describe("Filter by project ID to only return flags in that project."),
+        }),
+        annotations: {
+            readOnlyHint: true,
+        },
+    }, async ({ projectId }) => {
+        try {
+            const queryParams = projectId
+                ? `?projectId=${encodeURIComponent(projectId)}`
+                : "";
+            const res = await fetchWithRateLimit(`${baseApiUrl}/api/v1/feature-keys${queryParams}`, {
+                headers: buildHeaders(apiKey),
+            });
+            await handleResNotOk(res);
+            const keys = (await res.json());
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `**${keys.length} feature flag(s) found${projectId ? ` in project \`${projectId}\`` : ""}:**\n\n${keys.map((k) => `\`${k}\``).join(", ")}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(formatApiError(error, "fetching feature keys", [
+                "Check that your GB_API_KEY has permission to read features.",
+            ]));
+        }
+    });
     /**
      * Tool: get_stale_feature_flags
      */
     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 list_feature_keys to get all flag IDs and then searching the codebase for those 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 list_feature_keys to get all flag IDs and searching the codebase for those IDs."),
         }),
         annotations: {
             readOnlyHint: true,
@@ -215,8 +256,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 `list_feature_keys` tool** to get all flag IDs, then search the codebase for those 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));