@capivv/mcp-server 0.5.10 → 0.5.12

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, SubscriptionStateInfo, TouchSubscriptionResult, ProbeSubmissionRequest, ProbeSubmissionResult, SetAppPrivacyUrlRequest, SetAppPrivacyUrlResult, SetIapReviewScreenshotRequest, SetIapReviewScreenshotResult } 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, ProbeSubmissionRequest, ProbeSubmissionResult, SetAppPrivacyUrlRequest, SetAppPrivacyUrlResult, SetIapReviewScreenshotRequest, SetIapReviewScreenshotResult, IapStateInfo, ListAppleSubscriptionsResult, ListAppleIapsResult, DeleteAppleResult } from './types.js';
 export declare class ApiError extends Error {
     status: number;
     code: string;
@@ -97,4 +97,9 @@ export declare class CapivvClient {
     probeAppleSubmission(req: ProbeSubmissionRequest): Promise<ProbeSubmissionResult>;
     setAppPrivacyUrl(req: SetAppPrivacyUrlRequest): Promise<SetAppPrivacyUrlResult>;
     setIapReviewScreenshot(req: SetIapReviewScreenshotRequest): Promise<SetIapReviewScreenshotResult>;
+    getIapState(appleIapId: string): Promise<IapStateInfo>;
+    listAppleSubscriptions(appId: string): Promise<ListAppleSubscriptionsResult>;
+    listAppleIaps(appId: string): Promise<ListAppleIapsResult>;
+    deleteAppleSubscription(appleSubscriptionId: string): Promise<DeleteAppleResult>;
+    deleteAppleIap(appleIapId: string): Promise<DeleteAppleResult>;
 }

package/dist/client.js

@@ -362,4 +362,20 @@ export class CapivvClient {
         const { apple_iap_id, ...body } = req;
         return this.post(`/dashboard/iap/${encodeURIComponent(apple_iap_id)}/review-screenshot`, body);
     }
+    async getIapState(appleIapId) {
+        return this.get(`/dashboard/iap/${encodeURIComponent(appleIapId)}/state`);
+    }
+    // ---- V0.5.12 — Orphan recovery ----
+    async listAppleSubscriptions(appId) {
+        return this.get(`/dashboard/apps/${encodeURIComponent(appId)}/apple/subscriptions`);
+    }
+    async listAppleIaps(appId) {
+        return this.get(`/dashboard/apps/${encodeURIComponent(appId)}/apple/iaps`);
+    }
+    async deleteAppleSubscription(appleSubscriptionId) {
+        return this.delete(`/dashboard/subscriptions/${encodeURIComponent(appleSubscriptionId)}`);
+    }
+    async deleteAppleIap(appleIapId) {
+        return this.delete(`/dashboard/iap/${encodeURIComponent(appleIapId)}`);
+    }
 }

package/dist/tools/delete-apple-iap.d.ts

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

package/dist/tools/delete-apple-iap.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export function registerDeleteAppleIapTool(server, client) {
+    server.tool('capivv_delete_apple_iap', [
+        "Delete an in-app purchase from App Store Connect. Use this to clean up orphans left by a failed capivv_create_product.",
+        '',
+        "**Destructive.** Apple returns 204 on delete and 404 on already-deleted (treated as success).",
+        '',
+        'Get apple_iap_id from capivv_list_apple_iaps or App Store Connect.',
+    ].join(' '), {
+        apple_iap_id: z
+            .string()
+            .describe('Apple in-app purchase ID (e.g. "6765812345") — NOT the Capivv product UUID.'),
+    }, async ({ apple_iap_id }) => {
+        const result = await client.deleteAppleIap(apple_iap_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/delete-apple-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 registerDeleteAppleSubscriptionTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/delete-apple-subscription.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export function registerDeleteAppleSubscriptionTool(server, client) {
+    server.tool('capivv_delete_apple_subscription', [
+        "Delete a subscription from App Store Connect. Use this to clean up orphans left by a failed capivv_create_product (where Apple created the resource but Capivv rolled back).",
+        '',
+        "**Destructive.** Apple's API returns 204 on delete and 404 on already-deleted (treated as success). Once deleted the subscription is gone from ASC.",
+        '',
+        'Get apple_subscription_id from capivv_list_apple_subscriptions or App Store Connect.',
+    ].join(' '), {
+        apple_subscription_id: z
+            .string()
+            .describe('Apple subscription ID (e.g. "6764778053") — NOT the Capivv product UUID.'),
+    }, async ({ apple_subscription_id }) => {
+        const result = await client.deleteAppleSubscription(apple_subscription_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/get-iap-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 registerGetIapStateTool(server: McpServer, client: CapivvClient): void;

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

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export function registerGetIapStateTool(server, client) {
+    server.tool('capivv_get_iap_state', [
+        "Read an Apple in-app purchase's lifecycle state from App Store Connect. Mirror of capivv_get_subscription_state for IAPs (consumable / non-consumable).",
+        '',
+        'Returns the IAP\'s current `state` (MISSING_METADATA, READY_TO_SUBMIT, WAITING_FOR_REVIEW, IN_REVIEW, APPROVED, etc.), the productId, name, and whether it\'s CONSUMABLE or NON_CONSUMABLE. Useful after capivv_create_product / capivv_set_iap_review_screenshot to confirm the IAP is no longer stuck in MISSING_METADATA.',
+        '',
+        'Get `apple_iap_id` from the `store_create.store_product_id` field of capivv_create_product or from App Store Connect.',
+    ].join(' '), {
+        apple_iap_id: z
+            .string()
+            .describe('Apple in-app purchase ID (e.g. "6765812345") — NOT the Capivv product UUID.'),
+    }, async ({ apple_iap_id }) => {
+        const result = await client.getIapState(apple_iap_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/index.js

@@ -78,6 +78,11 @@ import { registerTouchSubscriptionTool } from './touch-subscription.js';
 import { registerProbeSubmissionTool } from './probe-submission.js';
 import { registerSetAppPrivacyUrlTool } from './set-app-privacy-url.js';
 import { registerSetIapReviewScreenshotTool } from './set-iap-review-screenshot.js';
+import { registerGetIapStateTool } from './get-iap-state.js';
+import { registerListAppleSubscriptionsTool } from './list-apple-subscriptions.js';
+import { registerListAppleIapsTool } from './list-apple-iaps.js';
+import { registerDeleteAppleSubscriptionTool } from './delete-apple-subscription.js';
+import { registerDeleteAppleIapTool } from './delete-apple-iap.js';
 export function registerAllTools(server, client) {
     // Identity — call this first to verify which workspace you're connected to
     registerWhoamiTool(server, client);
@@ -198,4 +203,14 @@ export function registerAllTools(server, client) {
     registerProbeSubmissionTool(server, client);
     registerSetAppPrivacyUrlTool(server, client);
     registerSetIapReviewScreenshotTool(server, client);
+    // V0.5.11 — IAP state probe (mirror of get_subscription_state).
+    registerGetIapStateTool(server, client);
+    // V0.5.12 — orphan recovery (list/delete on the Apple side for
+    // both subs and IAPs). Pairs with capivv_create_product's roll-back
+    // path: when ASC creates the resource but Capivv side rolls back,
+    // these tools let the agent find and clean up the leftover.
+    registerListAppleSubscriptionsTool(server, client);
+    registerListAppleIapsTool(server, client);
+    registerDeleteAppleSubscriptionTool(server, client);
+    registerDeleteAppleIapTool(server, client);
 }

package/dist/tools/list-apple-iaps.d.ts

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

package/dist/tools/list-apple-iaps.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerListAppleIapsTool(server, client) {
+    server.tool('capivv_list_apple_iaps', [
+        "List every in-app purchase (consumable / non-consumable) on the connected Apple App Store Connect account for a Capivv app.",
+        '',
+        "Returns Apple iap_id, productId, name, lifecycle state, and inAppPurchaseType for each. Use this to spot orphan IAPs Apple created during a failed capivv_create_product (so you can delete them with capivv_delete_apple_iap, or recover them with capivv_create_product + skip_store_write=true).",
+    ].join(' '), {
+        app_id: z.string().describe('Capivv app UUID.'),
+    }, async ({ app_id }) => {
+        const result = await client.listAppleIaps(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/list-apple-subscriptions.d.ts

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

package/dist/tools/list-apple-subscriptions.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerListAppleSubscriptionsTool(server, client) {
+    server.tool('capivv_list_apple_subscriptions', [
+        "List every subscription on the connected Apple App Store Connect account for a Capivv app.",
+        '',
+        'Returns Apple subscription_id, productId, name, and lifecycle state for each — enough to spot orphans left by failed capivv_create_product attempts (e.g. a subscription Apple created but Capivv rolled back). Pair with capivv_delete_apple_subscription to clean orphans up.',
+    ].join(' '), {
+        app_id: z.string().describe('Capivv app UUID.'),
+    }, async ({ app_id }) => {
+        const result = await client.listAppleSubscriptions(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/types.d.ts

@@ -652,3 +652,23 @@ export interface SetIapReviewScreenshotResult {
     screenshot_id: string;
     bytes_uploaded: number;
 }
+export interface IapStateInfo {
+    apple_iap_id: string;
+    product_id: string;
+    name: string | null;
+    state: string | null;
+    /** "CONSUMABLE" / "NON_CONSUMABLE". */
+    in_app_purchase_type: string | null;
+}
+export interface ListAppleSubscriptionsResult {
+    bundle_id: string;
+    subscriptions: SubscriptionStateInfo[];
+}
+export interface ListAppleIapsResult {
+    bundle_id: string;
+    iaps: IapStateInfo[];
+}
+export interface DeleteAppleResult {
+    deleted: boolean;
+    apple_id: string;
+}

package/package.json

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