@capivv/mcp-server 0.5.47 → 0.5.49

package/dist/client.d.ts

@@ -54,6 +54,30 @@ 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
+     * the customer set via the dashboard's Apple integration flow —
+     * promotional offers use a separate .p8 generated under
+     * Users and Access → Keys → In-App Purchase.
+     */
+    setApplePromotionalOfferKey(input: {
+        key_id: string;
+        private_key: string;
+    }): Promise<{
+        ok: boolean;
+    }>;
     listStorePrices(productId: string): Promise<{
         product_id: string;
         apple_store_product_id?: string;

package/dist/client.js

@@ -151,6 +151,35 @@ 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
+     * the customer set via the dashboard's Apple integration flow —
+     * promotional offers use a separate .p8 generated under
+     * Users and Access → Keys → In-App Purchase.
+     */
+    async setApplePromotionalOfferKey(input) {
+        return this.post(`/dashboard/integrations/apple/promotional-offer-key`, input);
+    }
     async listStorePrices(productId) {
         return this.get(`/dashboard/products/${encodeURIComponent(productId)}/store-prices`);
     }

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

@@ -49,9 +49,11 @@ import { registerCreateExperimentTool } from './create-experiment.js';
 import { registerUpdateExperimentTool } from './update-experiment.js';
 import { registerUpdateVariantTool } from './update-variant.js';
 import { registerListStorePricesTool } from './list-store-prices.js';
+import { registerSetApplePromotionalOfferKeyTool } from './set-apple-promotional-offer-key.js';
 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';
@@ -165,9 +167,11 @@ export function registerAllTools(server, client) {
     registerUpdateExperimentTool(server, client);
     registerUpdateVariantTool(server, client);
     registerListStorePricesTool(server, client);
+    registerSetApplePromotionalOfferKeyTool(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/dist/tools/set-apple-promotional-offer-key.d.ts

@@ -0,0 +1,25 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+/**
+ * V0.5.48 — issue #18 Primitive 3 follow-up. Upload the Apple
+ * promotional-offer signing key so capivv can issue signed offer
+ * payloads for pricing-A/B experiments without per-arm SKU explosion
+ * (the v0.5.44 Primitive 3 surface).
+ *
+ * Customer flow:
+ *   1. App Store Connect → Users and Access → Keys → In-App Purchase.
+ *   2. Generate a new "Subscription Key" (this is the .p8 file).
+ *   3. Note the Key ID shown next to it.
+ *   4. Open the .p8 file, copy the full contents including the
+ *      BEGIN PRIVATE KEY / END PRIVATE KEY lines.
+ *   5. Call this tool with key_id + private_key.
+ *
+ * The backend probe-parses the key with a dummy sign call before
+ * persisting, so a paste error returns a clear error here rather
+ * than failing 24h later when the SDK first asks for a signature.
+ *
+ * Distinct from the ASC API key set via capivv_connect_apple_integration —
+ * Apple scopes signing authority separately so loss of one doesn't
+ * compromise the other.
+ */
+export declare function registerSetApplePromotionalOfferKeyTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/set-apple-promotional-offer-key.js

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+/**
+ * V0.5.48 — issue #18 Primitive 3 follow-up. Upload the Apple
+ * promotional-offer signing key so capivv can issue signed offer
+ * payloads for pricing-A/B experiments without per-arm SKU explosion
+ * (the v0.5.44 Primitive 3 surface).
+ *
+ * Customer flow:
+ *   1. App Store Connect → Users and Access → Keys → In-App Purchase.
+ *   2. Generate a new "Subscription Key" (this is the .p8 file).
+ *   3. Note the Key ID shown next to it.
+ *   4. Open the .p8 file, copy the full contents including the
+ *      BEGIN PRIVATE KEY / END PRIVATE KEY lines.
+ *   5. Call this tool with key_id + private_key.
+ *
+ * The backend probe-parses the key with a dummy sign call before
+ * persisting, so a paste error returns a clear error here rather
+ * than failing 24h later when the SDK first asks for a signature.
+ *
+ * Distinct from the ASC API key set via capivv_connect_apple_integration —
+ * Apple scopes signing authority separately so loss of one doesn't
+ * compromise the other.
+ */
+export function registerSetApplePromotionalOfferKeyTool(server, client) {
+    server.tool('capivv_set_apple_promotional_offer_key', "Upload Apple's promotional-offer signing key (.p8) so capivv can sign per-cohort promotional offers for pricing-A/B experiments (variant.config.promotional_offer_config). Distinct from the ASC API key — generated separately in App Store Connect under Users and Access → Keys → In-App Purchase.", {
+        key_id: z
+            .string()
+            .min(1)
+            .describe('The Key ID Apple shows next to the generated .p8 file (e.g. "ABC123XYZ"). NOT the same as the ASC API Key ID — separate value.'),
+        private_key: z
+            .string()
+            .min(1)
+            .describe('Full contents of the .p8 file Apple generated, including the "-----BEGIN PRIVATE KEY-----" and "-----END PRIVATE KEY-----" lines. The backend probe-parses this before persisting.'),
+    }, async (input) => {
+        const result = await client.setApplePromotionalOfferKey(input);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/package.json

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