@capivv/mcp-server 0.5.47 → 0.5.48

package/dist/client.d.ts

@@ -54,6 +54,19 @@ export declare class CapivvClient {
      * "store says zero territories" from "this product type isn't read-
      * supported yet."
      */
+    /**
+     * 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,16 @@ export class CapivvClient {
      * "store says zero territories" from "this product type isn't read-
      * supported yet."
      */
+    /**
+     * 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/index.js

@@ -49,6 +49,7 @@ 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';
@@ -165,6 +166,7 @@ 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);

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.48",
   "description": "MCP server for managing Capivv subscription platform via AI assistants",
   "type": "module",
   "bin": {