@capivv/mcp-server 0.5.48 → 0.5.49

package/dist/client.d.ts

@@ -54,6 +54,17 @@ export declare class CapivvClient {
      * "store says zero territories" from "this product type isn't read-
      * supported yet."
      */
+    /**
+     * V0.5.49 — issue #18 follow-up. What-if Bayesian posterior with
+     * caller-provided overrides. Doesn't mutate the experiment's
+     * stored pre_registration.
+     */
+    getExperimentPosterior(input: {
+        experiment_id: string;
+        decision_threshold_pct?: number;
+        prior_alpha?: number;
+        prior_beta?: number;
+    }): Promise<unknown>;
     /**
      * V0.5.48 — issue #18 Primitive 3 follow-up. Upload the Apple
      * promotional-offer signing key. Distinct from the ASC API key

package/dist/client.js

@@ -151,6 +151,25 @@ export class CapivvClient {
      * "store says zero territories" from "this product type isn't read-
      * supported yet."
      */
+    /**
+     * V0.5.49 — issue #18 follow-up. What-if Bayesian posterior with
+     * caller-provided overrides. Doesn't mutate the experiment's
+     * stored pre_registration.
+     */
+    async getExperimentPosterior(input) {
+        const params = new URLSearchParams();
+        if (input.decision_threshold_pct !== undefined) {
+            params.set('decision_threshold_pct', String(input.decision_threshold_pct));
+        }
+        if (input.prior_alpha !== undefined) {
+            params.set('prior_alpha', String(input.prior_alpha));
+        }
+        if (input.prior_beta !== undefined) {
+            params.set('prior_beta', String(input.prior_beta));
+        }
+        const qs = params.toString() ? `?${params.toString()}` : '';
+        return this.get(`/dashboard/experiments/${encodeURIComponent(input.experiment_id)}/posterior${qs}`);
+    }
     /**
      * V0.5.48 — issue #18 Primitive 3 follow-up. Upload the Apple
      * promotional-offer signing key. Distinct from the ASC API key

package/dist/tools/get-experiment-posterior.d.ts

@@ -0,0 +1,22 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+/**
+ * V0.5.49 — focused Bayesian posterior endpoint. Issue #18 follow-up.
+ *
+ * `capivv_get_experiment_summary` returns the posterior computed
+ * against the experiment's stored pre-registration block. This tool
+ * lets the agent (or operator doing what-if analysis) override the
+ * decision threshold + Beta priors WITHOUT mutating the experiment's
+ * stored pre_registration.
+ *
+ * Example usage:
+ *   "What would the ship/wait recommendation be at a 10pp threshold
+ *    instead of our pre-registered 5pp?"
+ *   "What if we use a tighter Beta(10, 90) prior reflecting our
+ *    history of ~10% conversion?"
+ *
+ * Returns the same PosteriorSummary shape as
+ * `capivv_get_experiment_summary.posterior_summary`, plus the
+ * (control, challenger) variant ids used in the comparison.
+ */
+export declare function registerGetExperimentPosteriorTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/get-experiment-posterior.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+/**
+ * V0.5.49 — focused Bayesian posterior endpoint. Issue #18 follow-up.
+ *
+ * `capivv_get_experiment_summary` returns the posterior computed
+ * against the experiment's stored pre-registration block. This tool
+ * lets the agent (or operator doing what-if analysis) override the
+ * decision threshold + Beta priors WITHOUT mutating the experiment's
+ * stored pre_registration.
+ *
+ * Example usage:
+ *   "What would the ship/wait recommendation be at a 10pp threshold
+ *    instead of our pre-registered 5pp?"
+ *   "What if we use a tighter Beta(10, 90) prior reflecting our
+ *    history of ~10% conversion?"
+ *
+ * Returns the same PosteriorSummary shape as
+ * `capivv_get_experiment_summary.posterior_summary`, plus the
+ * (control, challenger) variant ids used in the comparison.
+ */
+export function registerGetExperimentPosteriorTool(server, client) {
+    server.tool('capivv_get_experiment_posterior', "Compute the Bayesian posterior summary for an experiment with caller-provided decision threshold + Beta priors. Does NOT mutate the experiment's stored pre_registration. Use for what-if analysis; use capivv_get_experiment_summary for the official numbers.", {
+        experiment_id: z.string().uuid().describe('The experiment to analyze'),
+        decision_threshold_pct: z
+            .number()
+            .min(0)
+            .optional()
+            .describe('The minimum lift in percentage points to count as "worth shipping." Drives prob_uplift_exceeds_threshold. Default 0 (any positive lift counts).'),
+        prior_alpha: z
+            .number()
+            .positive()
+            .optional()
+            .describe('Beta prior α₀. Default 1 (uniform). Use a larger value to encode prior conversions you\'ve seen (e.g. prior_alpha=10 with prior_beta=190 encodes "we\'ve seen ~5% conversion in 200 prior observations").'),
+        prior_beta: z
+            .number()
+            .positive()
+            .optional()
+            .describe('Beta prior β₀. Default 1 (uniform).'),
+    }, async (args) => {
+        const result = await client.getExperimentPosterior(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/index.js

@@ -53,6 +53,7 @@ import { registerSetApplePromotionalOfferKeyTool } from './set-apple-promotional
 import { registerStartExperimentTool } from './start-experiment.js';
 import { registerStopExperimentTool } from './stop-experiment.js';
 import { registerGetExperimentSummaryTool } from './get-experiment-summary.js';
+import { registerGetExperimentPosteriorTool } from './get-experiment-posterior.js';
 import { registerUpdateAppTool } from './update-app.js';
 import { registerDeleteAppTool } from './delete-app.js';
 import { registerArchiveAppTool } from './archive-app.js';
@@ -170,6 +171,7 @@ export function registerAllTools(server, client) {
     registerStartExperimentTool(server, client);
     registerStopExperimentTool(server, client);
     registerGetExperimentSummaryTool(server, client);
+    registerGetExperimentPosteriorTool(server, client);
     // Apps gap-fillers (V8 Phase B.6)
     registerUpdateAppTool(server, client);
     registerDeleteAppTool(server, client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capivv/mcp-server",
-  "version": "0.5.48",
+  "version": "0.5.49",
   "description": "MCP server for managing Capivv subscription platform via AI assistants",
   "type": "module",
   "bin": {