@capivv/mcp-server 0.2.0 → 0.5.1

package/dist/tools/create-rescue-flow.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export function registerCreateRescueFlowTool(server, client) {
+    server.tool('capivv_create_rescue_flow', [
+        'Create a cancellation rescue flow. Triggered when a user attempts to cancel; runs the configured steps (reason capture, retention offers, deflection) in priority order.',
+        'After creation, use capivv_update_rescue_flow to attach `conditions` (eligibility filters) and `steps` (the offer ladder) — both default to empty.',
+    ].join(' '), {
+        name: z.string().describe('Display name (e.g. "Annual rescue ladder")'),
+        identifier: z
+            .string()
+            .describe('Stable identifier the SDK uses to fetch this flow (e.g. "annual_rescue_v1")'),
+        description: z.string().optional().describe('Free-form description'),
+        priority: z
+            .number()
+            .optional()
+            .describe('Priority (higher runs first when multiple flows match). Defaults to 0.'),
+    }, async (args) => {
+        const flow = await client.createRescueFlow(args);
+        return { content: [{ type: 'text', text: JSON.stringify(flow, null, 2) }] };
+    });
+}

package/dist/tools/delete-app.d.ts

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

package/dist/tools/delete-app.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerDeleteAppTool(server, client) {
+    server.tool('capivv_delete_app', 'Permanently delete an app and all its products, entitlements, prices, paywalls, etc. (cascades). Prefer capivv_archive_app for reversible removal.', {
+        app_id: z.string().describe('App ID to delete'),
+    }, async ({ app_id }) => {
+        await client.deleteApp(app_id);
+        return { content: [{ type: 'text', text: `App ${app_id} permanently deleted.` }] };
+    });
+}

package/dist/tools/delete-entitlement.d.ts

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

package/dist/tools/delete-entitlement.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export function registerDeleteEntitlementTool(server, client) {
+    server.tool('capivv_delete_entitlement', 'Delete an entitlement by ID. Cascades to grants and revocations. Will fail if the entitlement is still referenced by active products — detach them first.', {
+        entitlement_id: z.string().describe('Entitlement ID to delete'),
+    }, async ({ entitlement_id }) => {
+        await client.deleteEntitlement(entitlement_id);
+        return {
+            content: [{ type: 'text', text: `Entitlement ${entitlement_id} deleted.` }],
+        };
+    });
+}

package/dist/tools/delete-paywall.d.ts

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

package/dist/tools/delete-paywall.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export function registerDeletePaywallTool(server, client) {
+    server.tool('capivv_delete_paywall', 'Delete a paywall by ID. The paywall is removed from the dashboard and stops being served to clients. Use capivv_list_paywalls to find the paywall_id.', {
+        paywall_id: z.string().describe('Paywall ID to delete'),
+    }, async ({ paywall_id }) => {
+        await client.deletePaywall(paywall_id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Paywall ${paywall_id} deleted.`,
+                },
+            ],
+        };
+    });
+}

package/dist/tools/delete-promotion.d.ts

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

package/dist/tools/delete-promotion.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export function registerDeletePromotionTool(server, client) {
+    server.tool('capivv_delete_promotion', 'Delete a promotion by ID. Stops the promotion immediately and removes it from the dashboard. Active redemptions are preserved in the audit log. Use capivv_list_promotions to find the promotion_id.', {
+        promotion_id: z.string().describe('Promotion ID to delete'),
+    }, async ({ promotion_id }) => {
+        await client.deletePromotion(promotion_id);
+        return {
+            content: [{ type: 'text', text: `Promotion ${promotion_id} deleted.` }],
+        };
+    });
+}

package/dist/tools/delete-rescue-flow.d.ts

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

package/dist/tools/delete-rescue-flow.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export function registerDeleteRescueFlowTool(server, client) {
+    server.tool('capivv_delete_rescue_flow', 'Delete a rescue flow by ID. The flow stops running immediately. Historical rescue events remain in analytics. Use capivv_list_rescue_flows to find the rescue_flow_id.', {
+        rescue_flow_id: z.string().describe('Rescue flow ID to delete'),
+    }, async ({ rescue_flow_id }) => {
+        await client.deleteRescueFlow(rescue_flow_id);
+        return {
+            content: [{ type: 'text', text: `Rescue flow ${rescue_flow_id} deleted.` }],
+        };
+    });
+}

package/dist/tools/disconnect-integration.d.ts

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

package/dist/tools/disconnect-integration.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerDisconnectIntegrationTool(server, client) {
+    server.tool('capivv_disconnect_integration', 'Disconnect a store integration. Removes stored credentials and stops syncing. Useful when rotating an Apple .p8 or Google service account — call this, then capivv_connect_apple_integration / capivv_connect_google_integration with the new credentials.', {
+        provider: z
+            .enum(['apple_app_store', 'google_play', 'stripe'])
+            .describe('Which provider to disconnect.'),
+    }, async ({ provider }) => {
+        await client.disconnectIntegration(provider);
+        return {
+            content: [{ type: 'text', text: `Disconnected ${provider}.` }],
+        };
+    });
+}

package/dist/tools/get-entitlement.d.ts

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

package/dist/tools/get-entitlement.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerGetEntitlementTool(server, client) {
+    server.tool('capivv_get_entitlement', 'Get a single entitlement by ID. Use capivv_list_entitlements to find the entitlement_id.', {
+        entitlement_id: z.string().describe('Entitlement ID'),
+    }, async ({ entitlement_id }) => {
+        const ent = await client.getEntitlement(entitlement_id);
+        return { content: [{ type: 'text', text: JSON.stringify(ent, null, 2) }] };
+    });
+}

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

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

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

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerGetExperimentSummaryTool(server, client) {
+    server.tool('capivv_get_experiment_summary', 'Get full details for a single experiment: its variants, sample sizes, conversion rates, statistical significance, and recommendations. Use capivv_list_experiments to find the experiment_id.', {
+        experiment_id: z.string().describe('Experiment ID'),
+    }, async ({ experiment_id }) => {
+        const exp = await client.getExperiment(experiment_id);
+        return { content: [{ type: 'text', text: JSON.stringify(exp, null, 2) }] };
+    });
+}

package/dist/tools/get-offering.d.ts

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

package/dist/tools/get-offering.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerGetOfferingTool(server, client) {
+    server.tool('capivv_get_offering', 'Get a single offering by ID with full package details. Use capivv_list_offerings to find the offering_id.', {
+        offering_id: z.string().describe('Offering ID'),
+    }, async ({ offering_id }) => {
+        const offering = await client.getOffering(offering_id);
+        return { content: [{ type: 'text', text: JSON.stringify(offering, null, 2) }] };
+    });
+}

package/dist/tools/get-paywall-stats.d.ts

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

package/dist/tools/get-paywall-stats.js

@@ -0,0 +1,6 @@
+export function registerGetPaywallStatsTool(server, client) {
+    server.tool('capivv_get_paywall_stats', 'Get aggregated paywall stats for the workspace: total views, total conversions, and average conversion rate (across every paywall in the tenant). Use capivv_list_paywalls for per-paywall numbers.', async () => {
+        const stats = await client.getPaywallStats();
+        return { content: [{ type: 'text', text: JSON.stringify(stats, null, 2) }] };
+    });
+}

package/dist/tools/get-product.d.ts

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

package/dist/tools/get-product.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerGetProductTool(server, client) {
+    server.tool('capivv_get_product', 'Get a single product by ID with full metadata, including the store_product_id when the product was created via Phase A end-to-end. Use capivv_list_products to find the product_id.', {
+        product_id: z.string().describe('Product ID'),
+    }, async ({ product_id }) => {
+        const product = await client.getProduct(product_id);
+        return { content: [{ type: 'text', text: JSON.stringify(product, null, 2) }] };
+    });
+}

package/dist/tools/get-rescue-stats.d.ts

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

package/dist/tools/get-rescue-stats.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+export function registerGetRescueStatsTool(server, client) {
+    server.tool('capivv_get_rescue_stats', 'Get aggregated rescue stats for the workspace: total cancellation attempts, successful saves, save rate, and recovered revenue. Defaults to the last 30 days.', {
+        days: z
+            .number()
+            .optional()
+            .describe('Lookback window in days. Defaults to 30.'),
+    }, async ({ days }) => {
+        const stats = await client.getRescueStats(days ?? 30);
+        return { content: [{ type: 'text', text: JSON.stringify(stats, null, 2) }] };
+    });
+}

package/dist/tools/get-rule.d.ts

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

package/dist/tools/get-rule.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerGetRuleTool(server, client) {
+    server.tool('capivv_get_rule', 'Get a single rule (entitlement-grant YAML logic) by ID. Use capivv_list_rules to find the rule_id.', {
+        rule_id: z.string().describe('Rule ID'),
+    }, async ({ rule_id }) => {
+        const rule = await client.getRuleById(rule_id);
+        return { content: [{ type: 'text', text: JSON.stringify(rule, null, 2) }] };
+    });
+}

package/dist/tools/index.js

@@ -22,6 +22,56 @@ import { registerVerifySetupTool } from './verify-setup.js';
 import { registerWhoamiTool } from './whoami.js';
 import { registerAutopilotStatusTool } from './autopilot-status.js';
 import { registerApiKeyUsageTool } from './api-key-usage.js';
+import { registerListPaywallsTool } from './list-paywalls.js';
+import { registerCreatePaywallTool } from './create-paywall.js';
+import { registerUpdatePaywallTool } from './update-paywall.js';
+import { registerDeletePaywallTool } from './delete-paywall.js';
+import { registerGetPaywallStatsTool } from './get-paywall-stats.js';
+import { registerListPromotionsTool } from './list-promotions.js';
+import { registerCreatePromotionTool } from './create-promotion.js';
+import { registerUpdatePromotionTool } from './update-promotion.js';
+import { registerDeletePromotionTool } from './delete-promotion.js';
+import { registerListRescueFlowsTool } from './list-rescue-flows.js';
+import { registerCreateRescueFlowTool } from './create-rescue-flow.js';
+import { registerUpdateRescueFlowTool } from './update-rescue-flow.js';
+import { registerDeleteRescueFlowTool } from './delete-rescue-flow.js';
+import { registerGetRescueStatsTool } from './get-rescue-stats.js';
+import { registerListPricingStrategiesTool } from './list-pricing-strategies.js';
+import { registerCreatePricingStrategyTool } from './create-pricing-strategy.js';
+import { registerPreviewPricingTool } from './preview-pricing.js';
+import { registerRecomputePricesTool } from './recompute-prices.js';
+import { registerPushPricesToStoresTool } from './push-prices-to-stores.js';
+import { registerListChangeRequestsTool } from './list-change-requests.js';
+import { registerApproveChangeRequestTool } from './approve-change-request.js';
+import { registerSetCountryPriceOverrideTool } from './set-country-price-override.js';
+import { registerCreateExperimentTool } from './create-experiment.js';
+import { registerUpdateExperimentTool } from './update-experiment.js';
+import { registerStartExperimentTool } from './start-experiment.js';
+import { registerStopExperimentTool } from './stop-experiment.js';
+import { registerGetExperimentSummaryTool } from './get-experiment-summary.js';
+import { registerUpdateAppTool } from './update-app.js';
+import { registerDeleteAppTool } from './delete-app.js';
+import { registerArchiveAppTool } from './archive-app.js';
+import { registerRestoreAppTool } from './restore-app.js';
+import { registerRunAppAutopilotTool } from './run-app-autopilot.js';
+import { registerRevertAppAutopilotTool } from './revert-app-autopilot.js';
+import { registerGetEntitlementTool } from './get-entitlement.js';
+import { registerUpdateEntitlementTool } from './update-entitlement.js';
+import { registerDeleteEntitlementTool } from './delete-entitlement.js';
+import { registerGetProductTool } from './get-product.js';
+import { registerGetRuleTool } from './get-rule.js';
+import { registerListRuleVersionsTool } from './list-rule-versions.js';
+import { registerRollbackRuleTool } from './rollback-rule.js';
+import { registerGetOfferingTool } from './get-offering.js';
+import { registerUpdateOfferingTool } from './update-offering.js';
+import { registerCheckDriftTool } from './check-drift.js';
+import { registerResolveDriftTool } from './resolve-drift.js';
+import { registerSyncSuggestionsCountTool } from './sync-suggestions-count.js';
+import { registerTriggerSyncTool } from './trigger-sync.js';
+import { registerListIntegrationsTool } from './list-integrations.js';
+import { registerConnectAppleIntegrationTool } from './connect-apple-integration.js';
+import { registerConnectGoogleIntegrationTool } from './connect-google-integration.js';
+import { registerDisconnectIntegrationTool } from './disconnect-integration.js';
 export function registerAllTools(server, client) {
     // Identity — call this first to verify which workspace you're connected to
     registerWhoamiTool(server, client);
@@ -58,4 +108,69 @@ export function registerAllTools(server, client) {
     registerDeleteRuleTool(server, client);
     // Experiments
     registerListExperimentsTool(server, client);
+    // Paywalls (V8 Phase B.1)
+    registerListPaywallsTool(server, client);
+    registerCreatePaywallTool(server, client);
+    registerUpdatePaywallTool(server, client);
+    registerDeletePaywallTool(server, client);
+    registerGetPaywallStatsTool(server, client);
+    // Promotions (V8 Phase B.2)
+    registerListPromotionsTool(server, client);
+    registerCreatePromotionTool(server, client);
+    registerUpdatePromotionTool(server, client);
+    registerDeletePromotionTool(server, client);
+    // Rescue flows (V8 Phase B.3)
+    registerListRescueFlowsTool(server, client);
+    registerCreateRescueFlowTool(server, client);
+    registerUpdateRescueFlowTool(server, client);
+    registerDeleteRescueFlowTool(server, client);
+    registerGetRescueStatsTool(server, client);
+    // Pricing (V8 Phase B.4)
+    registerListPricingStrategiesTool(server, client);
+    registerCreatePricingStrategyTool(server, client);
+    registerPreviewPricingTool(server, client);
+    registerRecomputePricesTool(server, client);
+    registerPushPricesToStoresTool(server, client);
+    registerListChangeRequestsTool(server, client);
+    registerApproveChangeRequestTool(server, client);
+    registerSetCountryPriceOverrideTool(server, client);
+    // Experiment writes (V8 Phase B.5)
+    registerCreateExperimentTool(server, client);
+    registerUpdateExperimentTool(server, client);
+    registerStartExperimentTool(server, client);
+    registerStopExperimentTool(server, client);
+    registerGetExperimentSummaryTool(server, client);
+    // Apps gap-fillers (V8 Phase B.6)
+    registerUpdateAppTool(server, client);
+    registerDeleteAppTool(server, client);
+    registerArchiveAppTool(server, client);
+    registerRestoreAppTool(server, client);
+    registerRunAppAutopilotTool(server, client);
+    registerRevertAppAutopilotTool(server, client);
+    // Entitlements gap-fillers (V8 Phase B.7)
+    registerGetEntitlementTool(server, client);
+    registerUpdateEntitlementTool(server, client);
+    registerDeleteEntitlementTool(server, client);
+    // Products gap-filler (V8 Phase B.8)
+    registerGetProductTool(server, client);
+    // Rules gap-fillers (V8 Phase B.9)
+    registerGetRuleTool(server, client);
+    registerListRuleVersionsTool(server, client);
+    registerRollbackRuleTool(server, client);
+    // Offerings gap-fillers (V8 Phase B.10)
+    registerGetOfferingTool(server, client);
+    registerUpdateOfferingTool(server, client);
+    // Drift detection + remediation (V8 Phase C)
+    registerCheckDriftTool(server, client);
+    registerResolveDriftTool(server, client);
+    registerSyncSuggestionsCountTool(server, client);
+    registerTriggerSyncTool(server, client);
+    // Integrations management (V8.1 — added after the Interrupt customer
+    // hit a blocked-store-write because their integration was in a stale
+    // error state. The agent can now diagnose and fix integrations
+    // without bouncing the customer to the dashboard.)
+    registerListIntegrationsTool(server, client);
+    registerConnectAppleIntegrationTool(server, client);
+    registerConnectGoogleIntegrationTool(server, client);
+    registerDisconnectIntegrationTool(server, client);
 }

package/dist/tools/list-change-requests.d.ts

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

package/dist/tools/list-change-requests.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export function registerListChangeRequestsTool(server, client) {
+    server.tool('capivv_list_change_requests', 'List pricing change requests that exceeded the strategy\'s guardrails and are waiting for human approval. Filter by status (pending / approved / rejected) or by product_id.', {
+        app_id: z.string().describe('App to scope the listing to'),
+        status: z
+            .string()
+            .optional()
+            .describe('Filter by status: pending, approved, or rejected'),
+        product_id: z.string().optional().describe('Filter by product'),
+    }, async ({ app_id, status, product_id }) => {
+        const requests = await client.listPricingChangeRequests(app_id, status, product_id);
+        return { content: [{ type: 'text', text: JSON.stringify(requests, null, 2) }] };
+    });
+}

package/dist/tools/list-integrations.d.ts

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

package/dist/tools/list-integrations.js

@@ -0,0 +1,6 @@
+export function registerListIntegrationsTool(server, client) {
+    server.tool('capivv_list_integrations', 'List every store integration (Apple App Store, Google Play, Stripe) for the workspace with its status, last sync, and any error message. Useful for diagnosing why capivv_create_product failed — if the integration shows "error", the credentials are likely stale or revoked.', async () => {
+        const integrations = await client.listIntegrations();
+        return { content: [{ type: 'text', text: JSON.stringify(integrations, null, 2) }] };
+    });
+}

package/dist/tools/list-paywalls.d.ts

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

package/dist/tools/list-paywalls.js

@@ -0,0 +1,6 @@
+export function registerListPaywallsTool(server, client) {
+    server.tool('capivv_list_paywalls', 'List every paywall in the workspace with its type, status, view / conversion counts, and config. Use this to find a paywall_id before calling capivv_update_paywall or capivv_delete_paywall.', async () => {
+        const paywalls = await client.listPaywalls();
+        return { content: [{ type: 'text', text: JSON.stringify(paywalls, null, 2) }] };
+    });
+}

package/dist/tools/list-pricing-strategies.d.ts

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

package/dist/tools/list-pricing-strategies.js

@@ -0,0 +1,8 @@
+export function registerListPricingStrategiesTool(server, client) {
+    server.tool('capivv_list_pricing_strategies', 'List every pricing strategy across the workspace, including affordability tier bounds, blend weights (PPP / Big Mac / FX-neutral), and guardrails. Use this to find a strategy_id before previewing or recomputing prices.', async () => {
+        const strategies = await client.listPricingStrategies();
+        return {
+            content: [{ type: 'text', text: JSON.stringify(strategies, null, 2) }],
+        };
+    });
+}

package/dist/tools/list-promotions.d.ts

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

package/dist/tools/list-promotions.js

@@ -0,0 +1,6 @@
+export function registerListPromotionsTool(server, client) {
+    server.tool('capivv_list_promotions', 'List every promotion in the workspace with its campaign type, status, schedule, discount, and redemption count. Use this to find a promotion_id before calling capivv_update_promotion or capivv_delete_promotion.', async () => {
+        const promotions = await client.listPromotions();
+        return { content: [{ type: 'text', text: JSON.stringify(promotions, null, 2) }] };
+    });
+}

package/dist/tools/list-rescue-flows.d.ts

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

package/dist/tools/list-rescue-flows.js

@@ -0,0 +1,6 @@
+export function registerListRescueFlowsTool(server, client) {
+    server.tool('capivv_list_rescue_flows', 'List every cancellation rescue flow in the workspace with its status, priority, conditions, and steps. Use this to find a rescue_flow_id before calling update / delete.', async () => {
+        const flows = await client.listRescueFlows();
+        return { content: [{ type: 'text', text: JSON.stringify(flows, null, 2) }] };
+    });
+}

package/dist/tools/list-rule-versions.d.ts

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

package/dist/tools/list-rule-versions.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerListRuleVersionsTool(server, client) {
+    server.tool('capivv_list_rule_versions', 'List every saved version of a rule (history). Use capivv_rollback_rule with a version number to revert.', {
+        rule_id: z.string().describe('Rule ID'),
+    }, async ({ rule_id }) => {
+        const versions = await client.listRuleVersions(rule_id);
+        return { content: [{ type: 'text', text: JSON.stringify(versions, null, 2) }] };
+    });
+}

package/dist/tools/next-step.js

@@ -43,11 +43,11 @@ function buildSteps(state) {
         total_steps: total,
         title: 'Create products',
         status: state.products > 0 ? 'done' : 'needed',
-        what: 'Create your subscription or in-app purchase products, linked to entitlements.',
+        what: 'Create your subscription or in-app purchase products, linked to entitlements. With a connected store integration, Capivv creates the product in Capivv AND in App Store Connect / Google Play in one call.',
         how: state.apps > 0
-            ? 'Use capivv_create_product with app_id, external_id (must match your store product ID exactly), product_type, and entitlement_ids. Or use capivv_import_products to auto-import from a connected store.'
+            ? 'Use capivv_create_product with app_id, external_id (the store product ID you want — Capivv will create it in the store too), product_type, prices, and entitlement_ids. Or use capivv_import_products to pull existing store products into Capivv.'
             : 'First complete Step 1 (create an app), then use capivv_create_product.',
-        why: 'Products map to real App Store / Google Play items. The external_id must match exactly or purchase verification will fail.',
+        why: 'Products are end-to-end: Capivv writes to its database AND to the connected store(s) at the price you specify. Tier snapping is automatic and the response shows both the requested and the snapped price.',
     });
     // Step 5: Offerings
     steps.push({

package/dist/tools/preview-pricing.d.ts

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

package/dist/tools/preview-pricing.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerPreviewPricingTool(server, client) {
+    server.tool('capivv_preview_pricing', 'Preview the prices a pricing strategy would compute for a product, without applying them. Returns proposed prices per country, the factor breakdown (FX / PPP / Big Mac contributions), and which countries would trigger the guardrails.', {
+        product_id: z.string().describe('Product to preview pricing for'),
+        strategy_id: z
+            .string()
+            .optional()
+            .describe('Strategy to use. Defaults to the product\'s assigned strategy.'),
+    }, async ({ product_id, strategy_id }) => {
+        const result = await client.previewPricing(product_id, strategy_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/push-prices-to-stores.d.ts

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

package/dist/tools/push-prices-to-stores.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerPushPricesToStoresTool(server, client) {
+    server.tool('capivv_push_prices_to_stores', 'Push the current Capivv prices for a product to the connected stores (App Store Connect / Google Play). Snaps each price to the nearest store tier as needed. Returns counts of pushed / failed / skipped (skipped = no integration connected for that platform).', {
+        product_id: z.string().describe('Product whose Capivv prices should be pushed to stores'),
+    }, async ({ product_id }) => {
+        const result = await client.pushPricesToStores(product_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/recompute-prices.d.ts

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

package/dist/tools/recompute-prices.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+export function registerRecomputePricesTool(server, client) {
+    server.tool('capivv_recompute_prices', [
+        'Recompute prices and apply them to Capivv. Pass `product_id` to recompute one product, or `strategy_id` to recompute every product tied to that strategy.',
+        'Changes within the strategy\'s guardrails are auto-applied. Changes that exceed `max_auto_change_pct` / `max_auto_decrease_pct` are queued as change requests for human approval (use capivv_list_change_requests + capivv_approve_change_request).',
+        'This does NOT push to the stores — call capivv_push_prices_to_stores afterwards.',
+    ].join(' '), {
+        product_id: z
+            .string()
+            .optional()
+            .describe('Product to recompute. Mutually exclusive with strategy_id.'),
+        strategy_id: z
+            .string()
+            .optional()
+            .describe('Strategy to recompute (applies to every product on it). Mutually exclusive with product_id.'),
+        reason: z
+            .string()
+            .optional()
+            .describe('Free-form reason for the recompute (logged on every change request). Defaults to "manual".'),
+    }, async (args) => {
+        const result = await client.recomputePrices(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/resolve-drift.d.ts

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

package/dist/tools/resolve-drift.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export function registerResolveDriftTool(server, client) {
+    server.tool('capivv_resolve_drift', [
+        'Resolve a drift suggestion by ID. `accept` applies the store-side change to Capivv (e.g., imports the new product, updates the local price); `dismiss` marks the suggestion as ignored without changing anything.',
+        'For "Capivv has it but the store does not" cases, use capivv_create_product instead — that path re-creates the store-side record from Capivv via the Phase A helpers.',
+    ].join(' '), {
+        suggestion_id: z.string().describe('Sync suggestion ID (returned by capivv_check_drift)'),
+        action: z
+            .enum(['accept', 'dismiss'])
+            .describe('"accept" applies the change to Capivv; "dismiss" ignores it.'),
+    }, async ({ suggestion_id, action }) => {
+        const suggestion = await client.resolveSyncSuggestion(suggestion_id, action);
+        return { content: [{ type: 'text', text: JSON.stringify(suggestion, null, 2) }] };
+    });
+}

package/dist/tools/restore-app.d.ts

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

package/dist/tools/restore-app.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerRestoreAppTool(server, client) {
+    server.tool('capivv_restore_app', 'Restore a previously archived app. Inverse of capivv_archive_app.', {
+        app_id: z.string().describe('App ID to restore'),
+    }, async ({ app_id }) => {
+        const app = await client.restoreApp(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(app, null, 2) }] };
+    });
+}

package/dist/tools/revert-app-autopilot.d.ts

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