@growthbook/mcp 1.4.4 → 1.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@growthbook/mcp",
   "mcpName": "io.github.growthbook/growthbook-mcp",
-  "version": "1.4.4",
+  "version": "1.5.0",
   "description": "MCP Server for interacting with GrowthBook",
   "access": "public",
   "homepage": "https://github.com/growthbook/growthbook-mcp",
@@ -12,9 +12,13 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "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",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "sync-version": "node scripts/sync-version.js",
+    "bump:patch": "npm version patch --no-git-tag-version && npm run sync-version",
+    "bump:minor": "npm version minor --no-git-tag-version && npm run sync-version",
+    "bump:major": "npm version major --no-git-tag-version && npm run sync-version",
     "mcpb:build": "npx -y @anthropic-ai/mcpb -- pack"
   },
   "bin": {
@@ -39,7 +43,9 @@
   },
   "devDependencies": {
     "@types/node": "^24.2.1",
-    "typescript": "^5.9.2"
+    "@vitest/coverage-v8": "^3.2.4",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
   },
   "type": "module"
 }

package/server/docs.js

@@ -459,6 +459,91 @@ GBFeatureResult result = gb.evalFeature('my-feature');
 print('Value: \${result.value}');
 print('On: \${result.on}');
 print('Source: \${result.source}');
+\`\`\``,
+    rust: `## Rust Feature Flag Implementation
+
+### Basic Feature Checks
+Use \`is_on()\` and \`is_off()\` for simple boolean checks:
+\`\`\`rust
+use growthbook_rust::client::GrowthBookClientBuilder;
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let client = GrowthBookClientBuilder::new()
+        .api_url("https://cdn.growthbook.io".to_string())
+        .client_key("sdk-abc123".to_string())
+        .build()
+        .await?;
+
+    // Simple boolean check
+    if client.is_on("my-feature", None) {
+        println!("Feature is enabled!");
+    }
+
+    // Check if feature is disabled
+    if client.is_off("maintenance-mode", None) {
+        println!("Service is operational");
+    }
+
+    Ok(())
+}
+\`\`\`
+
+### Feature Values with Type Safety
+Use \`feature_result()\` and \`value_as::<T>()\` for typed values:
+\`\`\`rust
+// Get typed feature value
+let result = client.feature_result("button-color", None);
+if let Ok(color) = result.value_as::<String>() {
+    println!("Button color: {}", color);
+}
+
+// With default fallback
+let timeout = client.feature_result("api-timeout", None)
+    .value_as::<i32>()
+    .unwrap_or(30);
+\`\`\`
+
+### Attributes for Targeting
+Use attributes for user-specific feature evaluation:
+\`\`\`rust
+use growthbook_rust::model_public::{GrowthBookAttribute, GrowthBookAttributeValue};
+
+let mut attrs = Vec::new();
+attrs.push(GrowthBookAttribute::new(
+    "userId".to_string(),
+    GrowthBookAttributeValue::String("user-123".to_string())
+));
+attrs.push(GrowthBookAttribute::new(
+    "plan".to_string(),
+    GrowthBookAttributeValue::String("premium".to_string())
+));
+
+if client.is_on("premium-feature", Some(attrs)) {
+    println!("Premium feature enabled for this user!");
+}
+\`\`\`
+
+### Detailed Feature Evaluation
+Use \`feature_result()\` for comprehensive feature information:
+\`\`\`rust
+let result = client.feature_result("my-feature", None);
+
+// Access the raw value
+println!("Value: {:?}", result.value);
+
+// Check if enabled
+if result.on {
+    println!("Feature is on");
+}
+
+// Understand why this value was assigned
+match result.source {
+    FeatureResultSource::DefaultValue => println!("Using default value"),
+    FeatureResultSource::Force => println!("Forced value from targeting rule"),
+    FeatureResultSource::Experiment => println!("Value from A/B test"),
+    FeatureResultSource::UnknownFeature => println!("Feature not found"),
+}
 \`\`\``,
 };
 export function getFeatureFlagDocs(language) {
@@ -502,6 +587,9 @@ export function getFeatureFlagDocs(language) {
         case "flutter":
         case "dart":
             return FEATURE_FLAG_DOCS.flutter;
+        case "rust":
+        case "rs":
+            return FEATURE_FLAG_DOCS.rust;
         default:
             return "Feature flag documentation not available for this language. Check GrowthBook docs for implementation details.";
     }

package/server/index.js

@@ -26,34 +26,14 @@ const server = new McpServer({
     title: "GrowthBook MCP",
     websiteUrl: "https://growthbook.io",
 }, {
-    instructions: `You are a helpful assistant that interacts with GrowthBook, an open source feature flagging and experimentation platform. You can create and manage feature flags, experiments (A/B tests), and other resources associated with GrowthBook.
+    instructions: `You are a helpful assistant that interacts with GrowthBook, an open source feature flagging and experimentation platform.
 
-**Key Workflows:**
+Key workflows:
+- Feature flags: Use create_feature_flag for simple flags, then create_force_rule to add targeting conditions
+- Experiments: ALWAYS call get_defaults first, then create_experiment. Experiments are created as "draft" - users must launch in GrowthBook UI
+- Analysis: Use get_experiments with mode="summary" for quick insights
 
-1. **Creating Feature Flags:**
-   - Use create_feature_flag for simple boolean/string/number/json flags
-   - Use create_force_rule to add conditional rules to existing flags
-   - Always specify the correct fileExtension for code integration
-
-2. **Creating Experiments (A/B Tests):**
-   - CRITICAL: Always call get_defaults FIRST to see naming conventions and examples
-   - Use create_experiment to create experiments
-   - Experiments automatically create linked feature flags
-
-3. **Exploring Existing Resources:**
-   - Use get_projects, get_environments, get_feature_flags, get_experiments, or get_attributes to understand current setup
-   - Use get_single_feature_flag for detailed flag information
-   - Use get_stale_safe_rollouts to find completed rollouts that can be cleaned up
-
-4. **SDK Integration:**
-   - Use get_sdk_connections to see existing integrations
-   - Use create_sdk_connection for new app integrations
-   - Use generate_flag_types to create TypeScript definitions
-
-**Important Notes:**
-- Feature flags and experiments require a fileExtension parameter for proper code integration
-- Always review generated GrowthBook links with users so they can launch experiments
-- When experiments are "draft", users must visit GrowthBook to review and launch them`,
+All mutating tools require a fileExtension parameter for SDK integration guidance.`,
     capabilities: {
         tools: {},
         prompts: {},

package/server/tools/defaults.js

@@ -249,8 +249,13 @@ 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.", {}, {
-        readOnlyHint: true,
+    server.registerTool("get_defaults", {
+        title: "Get Defaults",
+        description: "Retrieves default configuration and naming examples for creating experiments. Analyzes your existing experiments to extract patterns and identifies your most common datasource/assignment query. Always call this before create_experiment - the examples help ensure new experiments follow your organization's conventions. Returns example names, hypotheses, descriptions from existing experiments, default datasource and assignment query IDs, and available environments. User-defined defaults (from set_user_defaults) override automatic detection.",
+        inputSchema: z.object({}),
+        annotations: {
+            readOnlyHint: true,
+        },
     }, async () => {
         const defaults = await getDefaults(apiKey, baseApiUrl);
         return {
@@ -262,17 +267,22 @@ export async function registerDefaultsTools({ server, baseApiUrl, apiKey, }) {
             ],
         };
     });
-    server.tool("set_user_defaults", "Set user-defined defaults for datasource, assignment query, and environments. These will override the automatic defaults for these fields.", {
-        datasourceId: z.string().describe("The data source ID to use as default"),
-        assignmentQueryId: z
-            .string()
-            .describe("The assignment query ID to use as default"),
-        environments: z
-            .array(z.string())
-            .describe("List of environment IDs to use as defaults"),
-    }, {
-        readOnlyHint: false,
-        destructiveHint: true,
+    server.registerTool("set_user_defaults", {
+        title: "Set User Defaults",
+        description: "Sets custom default values for experiment configuration that override automatic detection. Use when automatic defaults select the wrong datasource or assignment query. Find valid IDs by calling get_defaults first. Persists until cleared with clear_user_defaults.",
+        inputSchema: z.object({
+            datasourceId: z.string().describe("The data source ID to use as default"),
+            assignmentQueryId: z
+                .string()
+                .describe("The assignment query ID to use as default"),
+            environments: z
+                .array(z.string())
+                .describe("List of environment IDs to use as defaults"),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+        },
     }, async ({ datasourceId, assignmentQueryId, environments }) => {
         try {
             const userDefaults = {
@@ -296,9 +306,14 @@ 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.", {}, {
-        readOnlyHint: false,
-        destructiveHint: true,
+    server.registerTool("clear_user_defaults", {
+        title: "Clear User Defaults",
+        description: "Clear user-defined defaults and revert to automatic defaults.",
+        inputSchema: z.object({}),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+        },
     }, async () => {
         try {
             await readFile(userDefaultsFile, "utf8");

package/server/tools/environments.js

@@ -1,10 +1,16 @@
 import { handleResNotOk, fetchWithRateLimit, } from "../utils.js";
+import { z } from "zod";
 /**
  * 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.", {}, {
-        readOnlyHint: true,
+    server.registerTool("get_environments", {
+        title: "Get Environments",
+        description: "Lists all environments configured in GrowthBook. 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. Use this to see available environments before creating SDK connections or configuring feature flags. Environments can be scoped to specific projects for further control.",
+        inputSchema: z.object({}),
+        annotations: {
+            readOnlyHint: true,
+        },
     }, async () => {
         try {
             const res = await fetchWithRateLimit(`${baseApiUrl}/api/v1/environments`, {

package/server/tools/experiments/experiment-summary.js

@@ -1,139 +1,5 @@
 import { fetchWithRateLimit, handleResNotOk } from "../../utils.js";
-// Helper functions
-function median(arr) {
-    if (arr.length === 0)
-        return null;
-    const sorted = [...arr].sort((a, b) => a - b);
-    const mid = Math.floor(sorted.length / 2);
-    return sorted.length % 2 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2;
-}
-function round(n, decimals = 4) {
-    if (n === null || n === undefined || isNaN(n))
-        return null;
-    return Math.round(n * 10 ** decimals) / 10 ** decimals;
-}
-function formatLift(lift) {
-    if (lift === null)
-        return "N/A";
-    const sign = lift >= 0 ? "+" : "";
-    return `${sign}${(lift * 100).toFixed(1)}%`;
-}
-function getYearMonth(dateStr) {
-    if (!dateStr)
-        return null;
-    const d = new Date(dateStr);
-    if (isNaN(d.getTime()))
-        return null;
-    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, "0")}`;
-}
-function computeVerdict(exp, metricLookup) {
-    const resultData = exp.result?.results?.[0];
-    const srmPValue = resultData?.checks?.srm ?? null;
-    const totalUsers = resultData?.totalUsers || 0;
-    const srmPassing = srmPValue !== null ? srmPValue > 0.001 : true;
-    // Get goal and guardrail metric IDs
-    const goalIds = exp.settings?.goals?.map((g) => g.metricId) || [];
-    const guardrailIds = new Set(exp.settings?.guardrails?.map((g) => g.metricId) || []);
-    // Check guardrail regression
-    const guardrailsRegressed = resultData
-        ? (resultData.metrics || [])
-            .filter((m) => guardrailIds.has(m.metricId))
-            .some((m) => {
-            const metricInfo = metricLookup.get(m.metricId);
-            const isInverse = metricInfo?.inverse ?? false;
-            return m.variations.slice(1).some((v) => {
-                const analysis = v.analyses?.[0];
-                if (!analysis)
-                    return false;
-                if (analysis.chanceToBeatControl !== undefined) {
-                    return isInverse
-                        ? analysis.chanceToBeatControl > 0.95
-                        : analysis.chanceToBeatControl < 0.05;
-                }
-                return isInverse
-                    ? (analysis.ciLow ?? 0) > 0
-                    : (analysis.ciHigh ?? 0) < 0;
-            });
-        })
-        : false;
-    // Verdict: Match GrowthBook's ExperimentWinRate.tsx exactly
-    // exp.results maps to resultSummary.status in the API
-    const userResult = exp.resultSummary?.status?.toLowerCase() || "";
-    let verdict;
-    if (userResult === "won") {
-        verdict = "won";
-    }
-    else if (userResult === "lost") {
-        verdict = "lost";
-    }
-    else {
-        // Everything else is "inconclusive": dnf, inconclusive, undefined, null, ""
-        verdict = "inconclusive";
-    }
-    // Compute primary metric result for display
-    const primaryMetricResult = resultData
-        ? computePrimaryMetricResult(resultData, metricLookup, goalIds)
-        : null;
-    return {
-        verdict,
-        primaryMetricResult,
-        guardrailsRegressed,
-        srmPassing,
-        srmPValue,
-        totalUsers,
-    };
-}
-function computePrimaryMetricResult(resultData, metricLookup, goalIds) {
-    const primaryMetricId = goalIds[0];
-    if (!primaryMetricId)
-        return null;
-    const primaryMetricData = resultData.metrics?.find((m) => m.metricId === primaryMetricId);
-    if (!primaryMetricData || primaryMetricData.variations.length <= 1) {
-        return null;
-    }
-    const metricInfo = metricLookup.get(primaryMetricId);
-    const isInverse = metricInfo?.inverse ?? false;
-    // Find best performing variation (excluding control at index 0)
-    let bestVariation = primaryMetricData.variations[1];
-    let bestLift = bestVariation?.analyses?.[0]?.percentChange ?? 0;
-    for (let i = 2; i < primaryMetricData.variations.length; i++) {
-        const v = primaryMetricData.variations[i];
-        const lift = v.analyses?.[0]?.percentChange ?? 0;
-        const isBetter = isInverse ? lift < bestLift : lift > bestLift;
-        if (isBetter) {
-            bestVariation = v;
-            bestLift = lift;
-        }
-    }
-    const analysis = bestVariation?.analyses?.[0];
-    if (!analysis)
-        return null;
-    const lift = analysis.percentChange;
-    const chanceToBeatControl = analysis.chanceToBeatControl;
-    let significant = false;
-    if (chanceToBeatControl !== undefined) {
-        significant = chanceToBeatControl > 0.95 || chanceToBeatControl < 0.05;
-    }
-    else {
-        significant =
-            analysis.ciLow !== undefined &&
-                analysis.ciHigh !== undefined &&
-                (analysis.ciLow > 0 || analysis.ciHigh < 0);
-    }
-    let direction = "flat";
-    if (significant) {
-        const rawPositive = lift > 0;
-        const isWinning = isInverse ? !rawPositive : rawPositive;
-        direction = isWinning ? "winning" : "losing";
-    }
-    return {
-        id: primaryMetricId,
-        name: metricInfo?.name || primaryMetricId,
-        lift: round(lift),
-        significant,
-        direction,
-    };
-}
+import { computeVerdict, formatLift, getYearMonth, median, round, } from "./summary-logic.js";
 // Metric Lookup with caching
 const metricCache = new Map();
 const CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes