@growthbook/mcp 0.1.0 → 0.1.2

package/build/tools/features.js

@@ -1,65 +1,37 @@
 import { z } from "zod";
-import { getDocsMetadata, findImplementationDocs, handleResNotOk, generateLinkToGrowthBook, } from "../utils.js";
+import { getDocsMetadata, handleResNotOk, generateLinkToGrowthBook, SUPPORTED_FILE_EXTENSIONS, } from "../utils.js";
+import { exec } from "child_process";
 export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, user, }) {
     /**
      * Tool: create_feature_flag
-     * Description: Creates, adds, or wraps an element with a feature flag in GrowthBook. Allows specifying key, type, default value, and other metadata.
      */
-    server.tool("create_feature_flag", "Create, add, or wrap an element with a 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"),
-        archived: z
-            .boolean()
-            .optional()
-            .default(false)
-            .describe("Whether the feature flag is archived"),
         description: z
             .string()
             .optional()
             .default("")
-            .describe("A description of the feature flag"),
-        project: z
-            .string()
-            .optional()
-            .default("")
-            .describe("The project the feature flag belongs to"),
+            .describe("A briefdescription 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"),
-        tags: z
-            .array(z.string())
-            .optional()
-            .describe("Tags for the feature flag"),
         fileExtension: z
-            .enum([
-            ".tsx",
-            ".jsx",
-            ".ts",
-            ".js",
-            ".vue",
-            ".py",
-            ".go",
-            ".php",
-            ".rb",
-            ".java",
-            ".cs",
-        ])
+            .enum(SUPPORTED_FILE_EXTENSIONS)
             .describe("The extension of the current file. If it's unclear, ask the user."),
-    }, async ({ id, archived, description, project, valueType, defaultValue, tags, fileExtension, }) => {
+    }, async ({ id, description, valueType, defaultValue, fileExtension }) => {
         const payload = {
             id,
-            archived,
             description,
             owner: user,
-            project,
             valueType,
             defaultValue,
-            tags,
+            tags: ["mcp"],
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/features`, {
@@ -70,23 +42,9 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                 },
                 body: JSON.stringify(payload),
             });
-            if (!res.ok) {
-                let errorMessage = `HTTP ${res.status} ${res.statusText}`;
-                try {
-                    const errorBody = await res.json();
-                    errorMessage += `: ${JSON.stringify(errorBody)}`;
-                }
-                catch {
-                    // fallback to text if not JSON
-                    const errorText = await res.text();
-                    if (errorText)
-                        errorMessage += `: ${errorText}`;
-                }
-                throw new Error(errorMessage);
-            }
+            await handleResNotOk(res);
             const data = await res.json();
-            const docsText = await findImplementationDocs(fileExtension);
-            const { docs, language } = getDocsMetadata(fileExtension);
+            const { docs, language, stub } = getDocsMetadata(fileExtension);
             const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, "features", id);
             const text = `This is the API response: ${JSON.stringify(data, null, 2)}
       
@@ -98,7 +56,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
         **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)
 
-        ${docsText}
+        ${stub}
 
         **Want to learn more?**
         See the [GrowthBook ${language} docs](${docs})
@@ -108,26 +66,21 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             };
         }
         catch (error) {
-            console.error("Error creating feature flag:", error);
-            throw error;
+            throw new Error(`Error creating feature flag: ${error}`);
         }
     });
     /**
      * Tool: get_feature_flags
-     * Description: Fetches all feature flags from the GrowthBook API, with optional limit, offset, and project filtering.
      */
-    server.tool("get_feature_flags", "Fetches all feature flags from the GrowthBook API. Flags are returned in the order they were created, from oldest to newest.", {
+    server.tool("get_feature_flags", "Fetches all feature flags from the GrowthBook API, with optional limit, offset, and project filtering.", {
         limit: z.number().optional().default(100),
         offset: z.number().optional().default(0),
-        project: z.string().optional(),
-    }, async ({ limit, offset, project }) => {
+    }, async ({ limit, offset }) => {
         try {
             const queryParams = new URLSearchParams({
                 limit: limit?.toString(),
                 offset: offset?.toString(),
             });
-            if (project)
-                queryParams.append("project", project);
             const res = await fetch(`${baseApiUrl}/api/v1/features?${queryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -141,13 +94,11 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             };
         }
         catch (error) {
-            console.error("Error fetching flags:", error);
-            throw error;
+            throw new Error(`Error fetching flags: ${error}`);
         }
     });
     /**
      * Tool: get_single_feature_flag
-     * Description: Fetches a specific feature flag from the GrowthBook API by its ID, with optional project filtering.
      */
     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"),
@@ -180,26 +131,21 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             };
         }
         catch (error) {
-            console.error("Error fetching flags:", error);
-            throw error;
+            throw new Error(`Error fetching flags: ${error}`);
         }
     });
     /**
      * Tool: get_stale_safe_rollouts
-     * Description: Fetches all complete safe rollouts (rolled-back or released) from the GrowthBook API, with optional limit, offset, and project filtering.
      */
     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),
-        project: z.string().optional(),
-    }, async ({ limit, offset, project }) => {
+    }, async ({ limit, offset }) => {
         try {
             const queryParams = new URLSearchParams({
                 limit: limit?.toString(),
                 offset: offset?.toString(),
             });
-            if (project)
-                queryParams.append("project", project);
             const res = await fetch(`${baseApiUrl}/api/v1/features?${queryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -236,25 +182,45 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
             };
         }
         catch (error) {
-            console.error("Error fetching stale safe rollouts:", error);
-            throw error;
+            throw new Error(`Error fetching stale safe rollouts: ${error}`);
         }
     });
     /**
      * Tool: generate_flag_types
-     * Description: Generates types for feature flags using the GrowthBook CLI.
      */
-    server.tool("generate_flag_types", "Generate types for feature flags", {}, async () => {
-        const text = `Run the following commands for the user to generate types for their feature flags:
-
-      The first command will log you in to GrowthBook:
-      npx -y growthbook@latest auth login -k ${apiKey} -u ${baseApiUrl} -p default
-
-      The second command will generate types for your feature flags:
-      npx -y growthbook@latest features generate-types -u ${baseApiUrl}
-      `;
-        return {
-            content: [{ type: "text", text }],
-        };
+    server.tool("generate_flag_types", "Generate types for feature flags", {
+        currentWorkingDirectory: z
+            .string()
+            .describe("The current working directory of the user's project"),
+    }, async ({ currentWorkingDirectory }) => {
+        function runCommand(command, cwd) {
+            return new Promise((resolve, reject) => {
+                exec(command, { cwd }, (error, stdout, stderr) => {
+                    if (error) {
+                        reject(stderr || error.message);
+                    }
+                    else {
+                        resolve(stdout);
+                    }
+                });
+            });
+        }
+        try {
+            // Login command
+            await runCommand(`npx -y growthbook@latest auth login -k ${apiKey} -u ${baseApiUrl} -p default`, currentWorkingDirectory);
+            // Generate types command
+            const output = await runCommand(`npx -y growthbook@latest features generate-types -u ${baseApiUrl}`, currentWorkingDirectory);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ Types generated successfully:\n${output}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(`Error generating types: ${error}`);
+        }
     });
 }

package/build/tools/projects.js

@@ -2,11 +2,10 @@ import { z } from "zod";
 import { handleResNotOk } from "../utils.js";
 /**
  * Tool: get_projects
- * Description: Fetches all projects from the GrowthBook API, with optional limit and offset for pagination.
  */
 export function registerProjectTools({ server, baseApiUrl, apiKey, }) {
     server.tool("get_projects", "Fetches all projects from the GrowthBook API", {
-        limit: z.number().optional().default(10),
+        limit: z.number().optional().default(100),
         offset: z.number().optional().default(0),
     }, async ({ limit, offset }) => {
         const queryParams = new URLSearchParams({

package/build/tools/sdk-connections.js

@@ -3,23 +3,16 @@ import { handleResNotOk } from "../utils.js";
 export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
     /**
      * Tool: get_sdk_connections
-     * Description: Retrieves all SDK connections, which are how GrowthBook connects to an app.
-     * Users need the key, which is a public key that allows the app to fetch features and experiments from the API.
      */
-    server.tool("get_sdk_connections", `Get all SDK connections, 
-    which are how GrowthBook connects to an app. 
-    Importantly, users need the key, which is a public client key that allows the app to fetch features and experiments the API `, {
+    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.", {
         limit: z.number().optional().default(100),
         offset: z.number().optional().default(0),
-        project: z.string().optional(),
-    }, async ({ limit, offset, project }) => {
+    }, async ({ limit, offset }) => {
         try {
             const queryParams = new URLSearchParams({
                 limit: limit?.toString(),
                 offset: offset?.toString(),
             });
-            if (project)
-                queryParams.append("project", project);
             const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections?${queryParams.toString()}`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
@@ -33,15 +26,11 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             };
         }
         catch (error) {
-            return {
-                content: [{ type: "text", text: `Error: ${error}` }],
-            };
+            throw new Error(`Error fetching sdk connections: ${error}`);
         }
     });
     /**
      * Tool: create_sdk_connection
-     * Description: Creates an SDK connection for a user. Returns an SDK clientKey that can be used to fetch features and experiments.
-     * Requires a name, language, and optionally an environment.
      */
     server.tool("create_sdk_connection", `Create an SDK connection for a user. Returns an SDK clientKey that can be used to fetch features and experiments.`, {
         name: z
@@ -123,9 +112,7 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             };
         }
         catch (error) {
-            return {
-                content: [{ type: "text", text: `Error: ${error}` }],
-            };
+            throw new Error(`Error creating sdk connection: ${error}`);
         }
     });
 }

package/build/tools/search.js

@@ -2,9 +2,8 @@ import { z } from "zod";
 import { searchGrowthBookDocs } from "../utils.js";
 /**
  * Tool: search_growthbook_docs
- * Description: Searches the GrowthBook documentation for information on how to use a feature, based on a user-provided query.
  */
-export function registerSearchTool({ server }) {
+export function registerSearchTools({ server }) {
     server.tool("search_growthbook_docs", "Search the GrowthBook docs on how to use a feature", {
         query: z
             .string()

package/build/utils.js

@@ -1,13 +1,34 @@
+import { getFeatureFlagDocs } from "./docs.js";
+// Shared file extension enum for all MCP tools
+export const SUPPORTED_FILE_EXTENSIONS = [
+    ".tsx",
+    ".jsx",
+    ".ts",
+    ".js",
+    ".vue",
+    ".py",
+    ".go",
+    ".php",
+    ".rb",
+    ".java",
+    ".cs",
+    ".swift",
+    ".ex",
+    ".exs",
+    ".kt",
+    ".kts",
+    ".ktm",
+    ".dart",
+];
 export async function handleResNotOk(res) {
     if (!res.ok) {
+        const errorText = await res.text();
         let errorMessage = `HTTP ${res.status} ${res.statusText}`;
         try {
-            const errorBody = await res.json();
+            const errorBody = JSON.parse(errorText);
             errorMessage += `: ${JSON.stringify(errorBody)}`;
         }
         catch {
-            // fallback to text if not JSON
-            const errorText = await res.text();
             if (errorText)
                 errorMessage += `: ${errorText}`;
         }
@@ -44,69 +65,69 @@ export function getDocsMetadata(extension) {
         case ".jsx":
             return {
                 language: "react",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/react.mdx",
+                stub: getFeatureFlagDocs("react"),
                 docs: "https://docs.growthbook.io/lib/react",
             };
         case ".ts":
         case ".js":
             return {
                 language: "javascript",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/js.mdx",
+                stub: getFeatureFlagDocs("javascript"),
                 docs: "https://docs.growthbook.io/lib/js",
             };
         case ".vue":
             return {
                 language: "vue",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/vue.mdx",
+                stub: getFeatureFlagDocs("vue"),
                 docs: "https://docs.growthbook.io/lib/vue",
             };
         case ".py":
             return {
                 language: "python",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/python.mdx",
+                stub: getFeatureFlagDocs("python"),
                 docs: "https://docs.growthbook.io/lib/python",
             };
         case ".go":
             return {
                 language: "go",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/go.mdx",
+                stub: getFeatureFlagDocs("go"),
                 docs: "https://docs.growthbook.io/lib/go",
             };
         case ".php":
             return {
                 language: "php",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/php.mdx",
+                stub: getFeatureFlagDocs("php"),
                 docs: "https://docs.growthbook.io/lib/php",
             };
         case ".rb":
             return {
                 language: "ruby",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/ruby.mdx",
+                stub: getFeatureFlagDocs("ruby"),
                 docs: "https://docs.growthbook.io/lib/ruby",
             };
         case ".java":
             return {
                 language: "java",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/java.mdx",
+                stub: getFeatureFlagDocs("java"),
                 docs: "https://docs.growthbook.io/lib/java",
             };
         case ".cs":
             return {
                 language: "csharp",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/csharp.mdx",
+                stub: getFeatureFlagDocs("csharp"),
                 docs: "https://docs.growthbook.io/lib/csharp",
             };
         case ".swift":
             return {
                 language: "swift",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/swift.mdx",
+                stub: getFeatureFlagDocs("swift"),
                 docs: "https://docs.growthbook.io/lib/swift",
             };
         case ".ex":
         case ".exs":
             return {
                 language: "elixir",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/elixir.mdx",
+                stub: getFeatureFlagDocs("elixir"),
                 docs: "https://docs.growthbook.io/lib/elixir",
             };
         case ".kt":
@@ -114,19 +135,19 @@ export function getDocsMetadata(extension) {
         case ".ktm":
             return {
                 language: "kotlin",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/kotlin.mdx",
+                stub: getFeatureFlagDocs("kotlin"),
                 docs: "https://docs.growthbook.io/lib/kotlin",
             };
         case ".dart":
             return {
                 language: "flutter",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/flutter.mdx",
+                stub: getFeatureFlagDocs("flutter"),
                 docs: "https://docs.growthbook.io/lib/flutter",
             };
         default:
             return {
                 language: "unknown",
-                md: "https://raw.githubusercontent.com/growthbook/growthbook/main/docs/docs/lib/index.mdx",
+                stub: getFeatureFlagDocs("unknown"),
                 docs: "https://docs.growthbook.io/lib/",
             };
     }
@@ -155,18 +176,6 @@ export async function searchGrowthBookDocs(query) {
         return [];
     }
 }
-export async function findImplementationDocs(extension) {
-    const { md } = getDocsMetadata(extension);
-    try {
-        const response = await fetch(md);
-        await handleResNotOk(response);
-        const markdown = await response.text();
-        return markdown;
-    }
-    catch (error) {
-        return "Docs not found";
-    }
-}
 export function generateLinkToGrowthBook(appOrigin, resource, id) {
     return `${appOrigin}/${resource}/${id}`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growthbook/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "",
   "access": "public",
   "homepage": "https://github.com/growthbook/growthbook-mcp",
@@ -22,11 +22,12 @@
   "license": "MIT",
   "packageManager": "pnpm@10.6.1",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.10.2",
-    "zod": "^3.22.4"
+    "@modelcontextprotocol/sdk": "^1.13.1",
+    "env-paths": "^3.0.0",
+    "zod": "^3.25.67"
   },
   "devDependencies": {
-    "@types/node": "^22.15.3",
+    "@types/node": "^24.0.4",
     "typescript": "^5.8.3"
   },
   "type": "module"