@capivv/mcp-server 0.5.5 → 0.5.7

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from './config.js';
-import type { App, Product, Entitlement, Offering, Rule, Experiment, ExperimentSummary, AnalyticsOverview, OnboardingResponse, ImportPreviewResponse, CreateAppRequest, CreateEntitlementRequest, CreateProductRequest, CreateOfferingRequest, CreateRuleRequest, ValidateRuleRequest, ValidateRuleResponse, WhoamiResponse, ApiKeyUsageResponse, Paywall, CreatePaywallRequest, UpdatePaywallRequest, PaywallStats, Promotion, CreatePromotionRequest, UpdatePromotionRequest, RescueFlow, CreateRescueFlowRequest, UpdateRescueFlowRequest, RescueStats, PricingStrategy, CreatePricingStrategyRequest, PricingPreviewResult, PricingRecomputeRequest, PricingRecomputeResult, PricingPushResult, PricingChangeRequest, SetCountryPriceOverrideRequest, ExperimentWithVariants, CreateExperimentRequest, UpdateExperimentRequest, UpdateAppRequest, UpdateEntitlementRequest, UpdateOfferingRequest, AutopilotRunResult, SyncSuggestion, SyncSuggestionsCount, TriggerSyncResult, IntegrationSummary, ConnectAppleIntegrationRequest, ConnectAppleIntegrationResult, ConnectGoogleIntegrationRequest, ConnectGoogleIntegrationResult, SetSubscriptionReviewScreenshotRequest, SetSubscriptionReviewScreenshotResult } from './types.js';
+import type { App, Product, Entitlement, Offering, Rule, Experiment, ExperimentSummary, AnalyticsOverview, OnboardingResponse, ImportPreviewResponse, CreateAppRequest, CreateEntitlementRequest, CreateProductRequest, CreateOfferingRequest, CreateRuleRequest, ValidateRuleRequest, ValidateRuleResponse, WhoamiResponse, ApiKeyUsageResponse, Paywall, CreatePaywallRequest, UpdatePaywallRequest, PaywallStats, Promotion, CreatePromotionRequest, UpdatePromotionRequest, RescueFlow, CreateRescueFlowRequest, UpdateRescueFlowRequest, RescueStats, PricingStrategy, CreatePricingStrategyRequest, PricingPreviewResult, PricingRecomputeRequest, PricingRecomputeResult, PricingPushResult, PricingChangeRequest, SetCountryPriceOverrideRequest, ExperimentWithVariants, CreateExperimentRequest, UpdateExperimentRequest, UpdateAppRequest, UpdateEntitlementRequest, UpdateOfferingRequest, AutopilotRunResult, SyncSuggestion, SyncSuggestionsCount, TriggerSyncResult, IntegrationSummary, ConnectAppleIntegrationRequest, ConnectAppleIntegrationResult, ConnectGoogleIntegrationRequest, ConnectGoogleIntegrationResult, SetSubscriptionReviewScreenshotRequest, SetSubscriptionReviewScreenshotResult, SubscriptionStateInfo, TouchSubscriptionResult } from './types.js';
 export declare class ApiError extends Error {
     status: number;
     code: string;
@@ -92,4 +92,6 @@ export declare class CapivvClient {
     connectGoogleIntegration(data: ConnectGoogleIntegrationRequest): Promise<ConnectGoogleIntegrationResult>;
     disconnectIntegration(provider: string): Promise<void>;
     setSubscriptionReviewScreenshot(data: SetSubscriptionReviewScreenshotRequest): Promise<SetSubscriptionReviewScreenshotResult>;
+    getSubscriptionState(appleSubscriptionId: string): Promise<SubscriptionStateInfo>;
+    touchSubscription(appleSubscriptionId: string): Promise<TouchSubscriptionResult>;
 }

package/dist/client.js

@@ -344,4 +344,10 @@ export class CapivvClient {
         const { apple_subscription_id, ...body } = data;
         return this.post(`/dashboard/subscriptions/${encodeURIComponent(apple_subscription_id)}/review-screenshot`, body);
     }
+    async getSubscriptionState(appleSubscriptionId) {
+        return this.get(`/dashboard/subscriptions/${encodeURIComponent(appleSubscriptionId)}/state`);
+    }
+    async touchSubscription(appleSubscriptionId) {
+        return this.post(`/dashboard/subscriptions/${encodeURIComponent(appleSubscriptionId)}/touch`);
+    }
 }

package/dist/tools/create-product.js

@@ -7,6 +7,8 @@ export function registerCreateProductTool(server, client) {
         'Pass `skip_store_write: true` to opt out of the store-side write — only useful when migrating an existing store-side product into Capivv (rare).',
         '',
         'On success the response includes a `store_create` block with the store-side product ID and snapped prices. On store failure the Capivv-side record is rolled back and the verbatim store error is returned.',
+        '',
+        'KNOWN APPLE ISSUE — auto-renewing subscriptions: After this call succeeds, Apple may keep the subscription at MISSING_METADATA even when all metadata is uploaded. This is a known divergence between Apple\'s modern /v1/subscriptions API and its legacy /v1/inAppPurchases mirror. After uploading the review screenshot via capivv_set_subscription_review_screenshot, poll capivv_get_subscription_state — if state stays at MISSING_METADATA for more than a few minutes, call capivv_touch_subscription (best-effort) or have the customer click Save in the App Store Connect web UI.',
     ].join(' '), {
         app_id: z.string().describe('App ID this product belongs to'),
         external_id: z.string().describe('Store product ID (e.g., "com.example.pro_monthly")'),
@@ -42,6 +44,14 @@ export function registerCreateProductTool(server, client) {
             .string()
             .optional()
             .describe('Locale used for store-side product localization. Defaults to "en-US".'),
+        apple_available_territories: z
+            .array(z.string())
+            .optional()
+            .describe('Apple territories (ISO 3166-1 alpha-3, e.g. ["USA", "DEU", "GBR"]) the subscription is available in. Defaults derive from the prices\' currencies; USD prices → ["USA"]. Setting this is required for the subscription to leave MISSING_METADATA.'),
+        apple_available_in_new_territories: z
+            .boolean()
+            .optional()
+            .describe('When true (default), opts the subscription into new Apple territories automatically as Apple adds them. SaaS-friendly default.'),
     }, async (args) => {
         const { skip_store_write, ...rest } = args;
         const product = await client.createProduct({

package/dist/tools/get-subscription-state.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+export declare function registerGetSubscriptionStateTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/get-subscription-state.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export function registerGetSubscriptionStateTool(server, client) {
+    server.tool('capivv_get_subscription_state', [
+        'Read the current Apple-side state of a subscription. Returns name, productId, and Apple\'s lifecycle state (MISSING_METADATA / READY_TO_SUBMIT / WAITING_FOR_REVIEW / IN_REVIEW / APPROVED / REJECTED / etc).',
+        '',
+        'Use this to verify a subscription is actually ready after capivv_create_product + capivv_set_subscription_review_screenshot. Apple\'s modern /v1/subscriptions and legacy /v1/inAppPurchases views can diverge — a subscription with all metadata + screenshot uploaded sometimes stays at MISSING_METADATA because the legacy mirror lags. Poll this every 30-60 seconds; if state doesn\'t progress within a few minutes, call capivv_touch_subscription or click Save in App Store Connect\'s web UI.',
+    ].join(' '), {
+        apple_subscription_id: z
+            .string()
+            .describe('Apple subscription ID (e.g. "6764778053") — the store-side ID, not the Capivv UUID.'),
+    }, async ({ apple_subscription_id }) => {
+        const info = await client.getSubscriptionState(apple_subscription_id);
+        return { content: [{ type: 'text', text: JSON.stringify(info, null, 2) }] };
+    });
+}

package/dist/tools/index.js

@@ -73,6 +73,8 @@ import { registerConnectAppleIntegrationTool } from './connect-apple-integration
 import { registerConnectGoogleIntegrationTool } from './connect-google-integration.js';
 import { registerDisconnectIntegrationTool } from './disconnect-integration.js';
 import { registerSetSubscriptionReviewScreenshotTool } from './set-subscription-review-screenshot.js';
+import { registerGetSubscriptionStateTool } from './get-subscription-state.js';
+import { registerTouchSubscriptionTool } from './touch-subscription.js';
 export function registerAllTools(server, client) {
     // Identity — call this first to verify which workspace you're connected to
     registerWhoamiTool(server, client);
@@ -178,4 +180,9 @@ export function registerAllTools(server, client) {
     // wrapped in a single MCP call so the agent can take a subscription from
     // MISSING_METADATA to READY_FOR_REVIEW in one step.)
     registerSetSubscriptionReviewScreenshotTool(server, client);
+    // Subscription state probe + touch (v0.5.6 — workaround for Apple's
+    // modern-vs-legacy view divergence keeping subscriptions in
+    // MISSING_METADATA after a successful create.)
+    registerGetSubscriptionStateTool(server, client);
+    registerTouchSubscriptionTool(server, client);
 }

package/dist/tools/touch-subscription.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CapivvClient } from '../client.js';
+export declare function registerTouchSubscriptionTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/touch-subscription.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export function registerTouchSubscriptionTool(server, client) {
+    server.tool('capivv_touch_subscription', [
+        'BEST-EFFORT workaround for Apple\'s modern-vs-legacy view divergence.',
+        '',
+        'After capivv_create_product creates the subscription via Apple\'s /v1/subscriptions endpoint, a legacy /v1/inAppPurchases mirror is also created with its own state machine. The legacy record can stay at WAITING_FOR_SCREENSHOT (which keeps the modern view at MISSING_METADATA) even after the screenshot uploads cleanly, because Apple\'s state recompute pipeline still reads from the legacy view and the modern API doesn\'t reliably trigger that recompute.',
+        '',
+        'This tool does a no-op PATCH on the subscription (re-set name to its current value), which mirrors what clicking "Save" in App Store Connect\'s web UI appears to trigger. Whether it actually fires the recompute hasn\'t been confirmed in every state — call capivv_get_subscription_state 30-60 seconds afterwards to check. If state still doesn\'t progress, fall back to manual ASC web UI Save.',
+    ].join(' '), {
+        apple_subscription_id: z
+            .string()
+            .describe('Apple subscription ID (e.g. "6764778053") — the store-side ID, not the Capivv UUID.'),
+    }, async ({ apple_subscription_id }) => {
+        const result = await client.touchSubscription(apple_subscription_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/types.d.ts

@@ -250,6 +250,18 @@ export interface CreateProductRequest {
     also_create_in_store?: boolean;
     /** Default product locale for store-side localizations. Defaults to "en-US". */
     default_locale?: string;
+    /**
+     * V0.5.7: Apple territories the subscription is available in (ISO 3166-1
+     * alpha-3 — e.g. ["USA", "DEU", "GBR"]). Defaults derive from the
+     * prices' currencies; USD prices → ["USA"]. Without availability the
+     * Apple subscription stays in MISSING_METADATA.
+     */
+    apple_available_territories?: string[];
+    /**
+     * V0.5.7: opt the subscription in to new Apple territories as Apple
+     * adds them. Defaults to true.
+     */
+    apple_available_in_new_territories?: boolean;
 }
 export interface Paywall {
     id: string;
@@ -577,3 +589,14 @@ export interface SetSubscriptionReviewScreenshotResult {
     screenshot_id: string;
     bytes_uploaded: number;
 }
+export interface SubscriptionStateInfo {
+    apple_subscription_id: string;
+    product_id: string;
+    name: string | null;
+    state: string | null;
+}
+export interface TouchSubscriptionResult {
+    apple_subscription_id: string;
+    touched: boolean;
+    next_action: string;
+}

package/package.json

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