@growthbook/mcp 1.0.2 → 1.2.0

package/README.md

@@ -18,126 +18,5 @@ Use the following env variables to configure the MCP server.
 | GB_API_URL    | Optional | Your GrowthBook API URL. Defaults to `https://api.growthbook.io`. |
 | GB_APP_ORIGIN | Optional | Your GrowthBook app URL Defaults to `https://app.growthbook.io`.  |
 
-Find instructions below to add the MCP server to a client. Any client that supports MCP is also compatible. Consult its documentation for how to add the server.
 
-### Cursor
-
-1. Open **Cursor Settings** → **MCP**
-2. Click **Add new global MCP server**
-3. Add an entry for the GrowthBook MCP, following the pattern below:
-
-```json
-{
-  "mcpServers": {
-    "growthbook": {
-      "command": "npx",
-      "args": ["-y", "@growthbook/mcp"],
-      "env": {
-        "GB_API_KEY": "YOUR_API_KEY",
-        "GB_API_URL": "YOUR_API_URL",
-        "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
-        "GB_EMAIL": "YOUR_EMAIL"
-      }
-    }
-  }
-}
-```
-
-3. Save the settings.
-
-You should now see a green active status after the server successfully connects!
-
-### VS Code
-
-1. Open **User Settings (JSON)**
-2. Add an MCP entry:
-
-```json
- "mcp": {
-    "servers": {
-      "growthbook": {
-        "command": "npx",
-        "args": [
-          "-y", "@growthbook/mcp"
-        ],
-        "env": {
-          "GB_API_KEY": "YOUR_API_KEY",
-          "GB_API_URL": "YOUR_API_URL",
-          "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
-          "GB_EMAIL": "YOUR_EMAIL"
-        }
-      }
-    }
-  }
-```
-
-3. Save your settings.
-
-GrowthBook MCP is now ready to use in VS Code.
-
-### Claude Desktop
-
-1. **Open Settings** → **Developer**
-2. Click **Edit Config**
-3. Open `claude_desktop_config.json`
-4. Add the following configuration:
-
-```json
-{
-  "mcpServers": {
-    "growthbook": {
-      "command": "npx",
-      "args": ["-y", "@growthbook/mcp"],
-      "env": {
-        "GB_API_KEY": "YOUR_API_KEY",
-        "GB_API_URL": "YOUR_API_URL",
-        "GB_APP_ORIGIN": "YOUR_APP_ORIGIN",
-        "GB_EMAIL": "YOUR_EMAIL"
-      }
-    }
-  }
-}
-```
-
-5. Save the config and restart Claude
-
-A hammer icon should appear in the chat window, indicating that your GrowthBook MCP server is connected and available!
-
----
-
-## Tools
-
-- **Feature Flags**
-
-  - `create_feature_flag`: Create, add, or wrap an element with a feature flag. Specify key, type, default value, and metadata.
-  - `get_feature_flags`: List all feature flags in your GrowthBook instance.
-  - `get_single_feature_flag`: Fetch details for a specific feature flag by ID.
-  - `get_stale_safe_rollouts`: List all safe rollout rules that have been rolled back or released.
-  - `create_force_rule`: Create a feature flag with a targeting condition.
-  - `generate_flag_types`: Generates types for feature flags
-
-- **Experiments**
-
-  - `get_experiments`: List all experiments in GrowthBook.
-  - `get_experiment`: Fetch details for a specific experiment by ID.
-  - `get_attributes`: List all user attributes tracked in GrowthBook (useful for targeting).
-  - `create_experiment`: Creates a feature-flag based experiment.
-  - `get_defaults`: Get default values for experiments including hypothesis, description, datasource, and assignment query. (Runs automatically when the create experiment tool is called.)
-  - `create_defaults`: Set custom default values for experiments that will be used when creating new experiments.
-  - `clear_user_defaults`: Clear user-defined defaults and revert to automatic defaults.
-
-- **Environments**
-
-  - `get_environments`: List all environments (e.g., production, staging) configured in GrowthBook.
-
-- **Projects**
-
-  - `get_projects`: List all projects in your GrowthBook instance.
-
-- **SDK Connections**
-
-  - `get_sdk_connections`: List all SDK connections (how GrowthBook connects to your apps).
-  - `create_sdk_connection`: Create a new SDK connection for your app, specifying language and environment.
-
-- **Documentation Search**
-  - `search_growthbook_docs`: Search the GrowthBook documentation for information on how to use a feature, by keyword or question.
+Add the MCP server to your AI tool of choice. See the [official docs](https://docs.growthbook.io/integrations/mcp) for complete a complete guide.

package/build/index.js

@@ -9,6 +9,7 @@ import { registerSdkConnectionTools } from "./tools/sdk-connections.js";
 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";
 export const baseApiUrl = getApiUrl();
 export const apiKey = getApiKey();
 export const appOrigin = getAppOrigin();
@@ -87,6 +88,13 @@ registerDefaultsTools({
     baseApiUrl,
     apiKey,
 });
+registerMetricsTools({
+    server,
+    baseApiUrl,
+    apiKey,
+    appOrigin,
+    user,
+});
 // Start receiving messages on stdin and sending messages on stdout
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/build/tools/environments.js

@@ -18,9 +18,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/tools/experiments.js

@@ -1,108 +1,75 @@
 import { z } from "zod";
-import { generateLinkToGrowthBook, getDocsMetadata, handleResNotOk, SUPPORTED_FILE_EXTENSIONS, } from "../utils.js";
+import { generateLinkToGrowthBook, getDocsMetadata, handleResNotOk, SUPPORTED_FILE_EXTENSIONS, paginationSchema, } from "../utils.js";
 import { getDefaults } from "./defaults.js";
 export function registerExperimentTools({ server, baseApiUrl, apiKey, appOrigin, user, }) {
     /**
      * Tool: get_experiments
      */
-    server.tool("get_experiments", "Fetches all experiments from the GrowthBook API", {
-        limit: z.number().optional().default(100),
-        offset: z.number().optional().default(0),
-    }, async ({ limit, offset }) => {
+    server.tool("get_experiments", "Fetches experiments from the GrowthBook API", {
+        project: z
+            .string()
+            .describe("The ID of the project to filter experiments by")
+            .optional(),
+        ...paginationSchema,
+    }, async ({ limit, offset, mostRecent, project }) => {
         try {
-            const queryParams = new URLSearchParams({
-                limit: limit?.toString(),
-                offset: offset?.toString(),
-            });
-            const res = await fetch(`${baseApiUrl}/api/v1/experiments?${queryParams.toString()}`, {
+            // Default behavior
+            if (!mostRecent || offset > 0) {
+                const defaultQueryParams = new URLSearchParams({
+                    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}`,
+                        "Content-Type": "application/json",
+                    },
+                });
+                await handleResNotOk(defaultRes);
+                const data = await defaultRes.json();
+                return {
+                    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+                };
+            }
+            // Most recent behavior
+            const countRes = await fetch(`${baseApiUrl}/api/v1/experiments?limit=1`, {
                 headers: {
                     Authorization: `Bearer ${apiKey}`,
-                    "Content-Type": "application/json",
                 },
             });
-            await handleResNotOk(res);
-            const data = await res.json();
-            return {
-                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
-            };
-        }
-        catch (error) {
-            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",
+            await handleResNotOk(countRes);
+            const countData = await countRes.json();
+            const total = countData.total;
+            const calculatedOffset = Math.max(0, total - limit);
+            const mostRecentQueryParams = new URLSearchParams({
+                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}`,
-                    "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})
-      `;
+            await handleResNotOk(mostRecentRes);
+            const mostRecentData = await mostRecentRes.json();
+            if (mostRecentData.experiments &&
+                Array.isArray(mostRecentData.experiments)) {
+                mostRecentData.experiments = mostRecentData.experiments.reverse();
+            }
             return {
-                content: [{ type: "text", text }],
+                content: [
+                    { type: "text", text: JSON.stringify(mostRecentData, null, 2) },
+                ],
             };
         }
         catch (error) {
-            throw new Error(`Error creating force rule: ${error}`);
+            throw new Error(`Error fetching experiments: ${error}`);
         }
     });
     /**
@@ -169,7 +136,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
@@ -185,13 +151,17 @@ 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, }) => {
+    }, async ({ description, hypothesis, name, variations, fileExtension, confirmedDefaultsReviewed, project, }) => {
         if (!confirmedDefaultsReviewed) {
             return {
                 content: [
@@ -217,6 +187,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/tools/features.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { getDocsMetadata, handleResNotOk, generateLinkToGrowthBook, SUPPORTED_FILE_EXTENSIONS, } 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,13 @@ 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,
+    }, async ({ id, valueType, defaultValue, description, project, fileExtension, }) => {
         // get environments
         let environments = [];
         const defaults = await getDefaults(apiKey, baseApiUrl);
@@ -57,6 +45,7 @@ export function registerFeatureTools({ server, baseApiUrl, apiKey, appOrigin, us
                 };
                 return acc;
             }, {}),
+            ...(project && { project }),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/features`, {
@@ -72,6 +61,77 @@ 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"),
+    }, 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,21 +151,24 @@ 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.", {
-        limit: z.number().optional().default(100),
-        offset: z.number().optional().default(0),
-    }, async ({ limit, offset }) => {
+        project: featureFlagSchema.project.optional(),
+        ...paginationSchema,
+    }, 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}`,
@@ -126,14 +189,10 @@ 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,
+    }, 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",
@@ -144,11 +203,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 {
@@ -194,14 +253,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 }],
             };

package/build/tools/metrics.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { generateLinkToGrowthBook, handleResNotOk, paginationSchema, } from "../utils.js";
+export function registerMetricsTools({ server, baseApiUrl, apiKey, appOrigin, }) {
+    /**
+     * Tool: get_metrics
+     */
+    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, 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}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(metricsRes);
+            const metricsData = await metricsRes.json();
+            const factMetricRes = await fetch(`${baseApiUrl}/api/v1/fact-metrics?${queryParams.toString()}`, {
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                    "Content-Type": "application/json",
+                },
+            });
+            await handleResNotOk(factMetricRes);
+            const factMetricData = await factMetricRes.json();
+            const metricData = {
+                metrics: metricsData,
+                factMetrics: factMetricData,
+            };
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(metricData, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(`Error fetching metrics: ${error}`);
+        }
+    });
+    /**
+     * Tool: get_metric
+     */
+    server.tool("get_metric", "Fetches a metric from the GrowthBook API", {
+        metricId: z.string().describe("The ID of the metric to get"),
+    }, async ({ metricId }) => {
+        try {
+            let res;
+            if (metricId.startsWith("fact__")) {
+                res = await fetch(`${baseApiUrl}/api/v1/fact-metrics/${metricId}`, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                });
+            }
+            else {
+                res = await fetch(`${baseApiUrl}/api/v1/metrics/${metricId}`, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        "Content-Type": "application/json",
+                    },
+                });
+            }
+            await handleResNotOk(res);
+            const data = await res.json();
+            const linkToGrowthBook = generateLinkToGrowthBook(appOrigin, data.factMetric ? "fact-metrics" : "metric", metricId);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(data, null, 2) +
+                            `\n**Critical** Show the user the link to the metric in GrowthBook: [View the metric in GrowthBook](${linkToGrowthBook})
+          `,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(`Error fetching metric: ${error}`);
+        }
+    });
+}

package/build/tools/projects.js

@@ -1,12 +1,10 @@
-import { z } from "zod";
-import { handleResNotOk } from "../utils.js";
+import { handleResNotOk, paginationSchema, } from "../utils.js";
 /**
  * Tool: get_projects
  */
 export function registerProjectTools({ server, baseApiUrl, apiKey, }) {
     server.tool("get_projects", "Fetches all projects from the GrowthBook API", {
-        limit: z.number().optional().default(100),
-        offset: z.number().optional().default(0),
+        ...paginationSchema,
     }, async ({ limit, offset }) => {
         const queryParams = new URLSearchParams({
             limit: limit.toString(),
@@ -26,9 +24,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/tools/sdk-connections.js

@@ -1,18 +1,24 @@
 import { z } from "zod";
-import { handleResNotOk } from "../utils.js";
+import { handleResNotOk, paginationSchema, } from "../utils.js";
 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.", {
-        limit: z.number().optional().default(100),
-        offset: z.number().optional().default(0),
-    }, async ({ limit, offset }) => {
+        project: z
+            .string()
+            .describe("The ID of the project to filter SDK connections by")
+            .optional(),
+        ...paginationSchema,
+    }, 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}`,
@@ -61,12 +67,16 @@ 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(),
+    }, async ({ name, language, environment, projects }) => {
         if (!environment) {
             try {
                 const res = await fetch(`${baseApiUrl}/api/v1/environments`, {
@@ -95,6 +105,7 @@ export function registerSdkConnectionTools({ server, baseApiUrl, apiKey, }) {
             name,
             language,
             environment,
+            ...(projects && { projects }),
         };
         try {
             const res = await fetch(`${baseApiUrl}/api/v1/sdk-connections`, {

package/build/utils.js

@@ -1,3 +1,4 @@
+import { z } from "zod";
 import { getFeatureFlagDocs } from "./docs.js";
 // Shared file extension enum for all MCP tools
 export const SUPPORTED_FILE_EXTENSIONS = [
@@ -172,3 +173,40 @@ export async function searchGrowthBookDocs(query) {
 export function generateLinkToGrowthBook(appOrigin, resource, id) {
     return `${appOrigin}/${resource}/${id}`;
 }
+// Reusable pagination schema for GrowthBook API tools
+export const paginationSchema = {
+    limit: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(100)
+        .describe("The number of items to fetch (1-100)"),
+    offset: z
+        .number()
+        .min(0)
+        .default(0)
+        .describe("The number of items to skip. For example, set to 100 to fetch the second page with default limit. Note: The API returns items in chronological order (oldest first) by default."),
+    mostRecent: z
+        .boolean()
+        .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."),
+};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@growthbook/mcp",
-  "version": "1.0.2",
-  "description": "",
+  "version": "1.2.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",
+    "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"
@@ -17,7 +18,13 @@
   "files": [
     "build"
   ],
-  "keywords": [],
+  "keywords": [
+    "growthbook",
+    "mcp",
+    "modelcontextprotocol",
+    "featureflags",
+    "experiments"
+  ],
   "author": "GrowthBook",
   "license": "MIT",
   "packageManager": "pnpm@10.6.1",