@capivv/mcp-server 0.1.3 → 0.5.0

package/dist/tools/create-experiment.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export function registerCreateExperimentTool(server, client) {
+    server.tool('capivv_create_experiment', [
+        'Create an A/B experiment with variants. Variants split traffic by `traffic_percent` (must sum to 100). Exactly one variant should have `is_control: true`.',
+        'Common metrics: "paywall_conversion", "trial_to_paid", "arpu". `entity_type` + `entity_id` scope the experiment to a specific paywall, product, or pricing strategy.',
+        'New experiments start in `draft` status — call capivv_start_experiment to enroll users.',
+    ].join(' '), {
+        name: z.string().describe('Display name'),
+        description: z.string().optional().describe('Optional description'),
+        target_metric: z
+            .string()
+            .describe('Metric to optimize (e.g. "paywall_conversion", "trial_to_paid", "arpu")'),
+        entity_type: z
+            .string()
+            .optional()
+            .describe('Scope: "paywall", "product", "pricing_strategy", etc.'),
+        entity_id: z.string().optional().describe('ID of the scoped entity'),
+        start_date: z.string().optional().describe('ISO 8601 start timestamp'),
+        end_date: z.string().optional().describe('ISO 8601 end timestamp'),
+        sample_size_target: z
+            .number()
+            .optional()
+            .describe('Target sample size before considering the experiment conclusive'),
+        confidence_level: z.number().optional().describe('Confidence level (e.g. 95). Defaults to 95.'),
+        metadata: z.record(z.string(), z.unknown()).optional().describe('Free-form metadata'),
+        variants: z
+            .array(z.object({
+            name: z.string().describe('Variant name (e.g. "Control", "Variant A")'),
+            is_control: z.boolean().describe('Exactly one variant should be the control.'),
+            traffic_percent: z
+                .number()
+                .describe('Traffic allocation percentage (0-100). Sum across variants must be 100.'),
+            config: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe('Variant-specific overrides (paywall config, price, etc.)'),
+        }))
+            .describe('Variants to create with the experiment'),
+    }, async (args) => {
+        const exp = await client.createExperiment(args);
+        return { content: [{ type: 'text', text: JSON.stringify(exp, null, 2) }] };
+    });
+}

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

package/dist/tools/create-paywall.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export function registerCreatePaywallTool(server, client) {
+    server.tool('capivv_create_paywall', [
+        'Create a new paywall on a Capivv app.',
+        'paywall_type controls behavior: "hard" (block until purchase), "soft" (skippable), "upsell" (offer to existing users), or "promo" (limited-time offer).',
+        'Use capivv_update_paywall after creation to attach a template, configure the layout, or schedule A/B variants — those are not part of the create call.',
+    ].join(' '), {
+        app_id: z.string().describe('App ID this paywall belongs to'),
+        name: z.string().describe('Display name shown in the dashboard (e.g. "Onboarding paywall")'),
+        identifier: z
+            .string()
+            .describe('Stable identifier the SDK uses to fetch this paywall (e.g. "onboarding_v2")'),
+        paywall_type: z.string().describe('One of: hard, soft, upsell, promo'),
+    }, async (args) => {
+        const paywall = await client.createPaywall(args);
+        return { content: [{ type: 'text', text: JSON.stringify(paywall, null, 2) }] };
+    });
+}

package/dist/tools/create-pricing-strategy.d.ts

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

package/dist/tools/create-pricing-strategy.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+export function registerCreatePricingStrategyTool(server, client) {
+    server.tool('capivv_create_pricing_strategy', [
+        'Create a localized pricing strategy for an app.',
+        'Combines three signals — Purchasing Power Parity (PPP), Big Mac index, and FX-neutral conversion — using configurable weights to derive a country price.',
+        'Affordability is then clamped per income tier (1–4) so emerging markets don\'t collapse to pennies and rich markets don\'t inflate above the base price.',
+        'Guardrails (`max_auto_change_pct`, `max_auto_decrease_pct`) block changes that exceed the threshold; those go to a change-request queue instead of auto-applying.',
+        'Defaults work fine for most cases — start with just `app_id` and `name`.',
+    ].join(' '), {
+        app_id: z.string().describe('App ID this strategy applies to'),
+        name: z.string().describe('Display name (e.g. "Worldwide PPP-blended pricing")'),
+        w_ppp: z.number().optional().describe('PPP weight (0-1). Default 0.6.'),
+        w_bigmac: z.number().optional().describe('Big Mac index weight (0-1). Default 0.2.'),
+        w_fx_neutral: z
+            .number()
+            .optional()
+            .describe('FX-neutral weight (0-1). Default 0.2. The three weights should sum to ~1.0.'),
+        tier1_min_aff: z
+            .number()
+            .optional()
+            .describe('Minimum affordability for tier 1 (lowest income). Default 0.25.'),
+        tier1_max_aff: z.number().optional().describe('Maximum affordability for tier 1.'),
+        tier2_min_aff: z.number().optional().describe('Minimum affordability for tier 2.'),
+        tier2_max_aff: z.number().optional().describe('Maximum affordability for tier 2.'),
+        tier3_min_aff: z.number().optional().describe('Minimum affordability for tier 3.'),
+        tier3_max_aff: z.number().optional().describe('Maximum affordability for tier 3.'),
+        tier4_min_aff: z.number().optional().describe('Minimum affordability for tier 4.'),
+        tier4_max_aff: z.number().optional().describe('Maximum affordability for tier 4.'),
+        anti_arbitrage_floor_factor: z
+            .number()
+            .optional()
+            .describe('Floor multiplier (e.g. 0.5 means prices can\'t go below 50% of base).'),
+        max_auto_change_pct: z
+            .number()
+            .optional()
+            .describe('Max % change auto-applied without approval. Larger changes go to change requests.'),
+        max_auto_decrease_pct: z
+            .number()
+            .optional()
+            .describe('Max % decrease auto-applied (prevents accidental fire-sale pricing).'),
+        excluded_countries: z
+            .array(z.string())
+            .optional()
+            .describe('ISO country codes to skip (manual pricing only).'),
+    }, async (args) => {
+        const strategy = await client.createPricingStrategy(args);
+        return { content: [{ type: 'text', text: JSON.stringify(strategy, null, 2) }] };
+    });
+}

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

package/dist/tools/create-product.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+export function registerCreateProductTool(server, client) {
+    server.tool('capivv_create_product', [
+        'Create a subscription, consumable, or non-consumable product end-to-end.',
+        'By default this creates the Capivv-side product record AND the matching subscription / IAP in App Store Connect or Google Play (whichever store is connected for the app).',
+        'If the requested price does not match a store tier exactly, Capivv snaps to the nearest valid tier and returns both the requested and the actual price so you can show the customer the delta.',
+        '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.',
+    ].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")'),
+        product_type: z.string().describe('One of: subscription, consumable, non_consumable'),
+        display_name: z.string().describe('Human-readable product name'),
+        description: z.string().optional().describe('Optional product description'),
+        entitlement_ids: z
+            .array(z.string())
+            .optional()
+            .describe('Entitlement IDs this product grants upon purchase'),
+        subscription: z
+            .object({
+            billing_period: z
+                .string()
+                .describe('Billing period: week, month, three_months, six_months, or year'),
+            grace_period_enabled: z.boolean().optional().describe('Enable grace period for failed renewals'),
+        })
+            .optional()
+            .describe('Subscription configuration (required for subscription products)'),
+        prices: z
+            .array(z.object({
+            currency: z.string().describe('ISO 4217 currency code (e.g., "USD")'),
+            amount_cents: z.number().describe('Price in cents (e.g., 1099 for $10.99)'),
+            is_default: z.boolean().optional().describe('Whether this is the default price'),
+        }))
+            .optional()
+            .describe('Product prices'),
+        skip_store_write: z
+            .boolean()
+            .optional()
+            .describe('When true, only creates the Capivv-side record and skips writing to App Store Connect / Google Play. Use only when migrating an existing store-side product.'),
+        default_locale: z
+            .string()
+            .optional()
+            .describe('Locale used for store-side product localization. Defaults to "en-US".'),
+    }, async (args) => {
+        const { skip_store_write, ...rest } = args;
+        const product = await client.createProduct({
+            ...rest,
+            also_create_in_store: skip_store_write !== true,
+        });
+        const summary = formatStoreCreateSummary(product);
+        const text = summary
+            ? `${summary}\n\n${JSON.stringify(product, null, 2)}`
+            : JSON.stringify(product, null, 2);
+        return { content: [{ type: 'text', text }] };
+    });
+}
+function formatStoreCreateSummary(product) {
+    const sc = product.store_create;
+    if (!sc)
+        return null;
+    const lines = [];
+    lines.push(`Created ${product.display_name} on ${sc.store === 'apple' ? 'App Store Connect' : 'Google Play'} (id: ${sc.store_product_id}).`);
+    for (const sp of sc.snapped_prices) {
+        if (sp.requested_cents === sp.actual_cents) {
+            lines.push(`  ${sp.currency}: ${formatCents(sp.actual_cents, sp.currency)} (matches your request exactly).`);
+        }
+        else {
+            lines.push(`  ${sp.currency}: used ${formatCents(sp.actual_cents, sp.currency)} — closest store tier to your ${formatCents(sp.requested_cents, sp.currency)} request.`);
+        }
+    }
+    return lines.join('\n');
+}
+function formatCents(cents, currency) {
+    const major = (cents / 100).toFixed(2);
+    return `${major} ${currency}`;
+}

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

package/dist/tools/create-promotion.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export function registerCreatePromotionTool(server, client) {
+    server.tool('capivv_create_promotion', [
+        'Create a promotion (flash sale, bundle, segmented offer, or referral campaign).',
+        'campaign_type controls behavior: "flash_sale" (time-bound discount), "bundle" (multi-product offer), "segment" (target a user segment), "referral" (reward referrers).',
+        'When starts_at / ends_at are omitted, the promotion runs for 30 days starting now.',
+    ].join(' '), {
+        name: z.string().describe('Display name (e.g. "Summer 20% off")'),
+        identifier: z
+            .string()
+            .optional()
+            .describe('Stable identifier the SDK can target (e.g. "summer_2026")'),
+        description: z.string().optional().describe('Free-form description'),
+        campaign_type: z.string().describe('One of: flash_sale, bundle, segment, referral'),
+        discount_percent: z
+            .number()
+            .optional()
+            .describe('Percentage discount (0-100). Omit for non-discount campaigns.'),
+        starts_at: z
+            .string()
+            .optional()
+            .describe('ISO 8601 start timestamp. Defaults to now.'),
+        ends_at: z
+            .string()
+            .optional()
+            .describe('ISO 8601 end timestamp. Defaults to now + 30 days.'),
+        max_redemptions: z
+            .number()
+            .optional()
+            .describe('Redemption cap across the workspace. Omit for unlimited.'),
+    }, async (args) => {
+        const promotion = await client.createPromotion(args);
+        return { content: [{ type: 'text', text: JSON.stringify(promotion, null, 2) }] };
+    });
+}

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

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-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 registerDeleteProductTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/delete-product.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerDeleteProductTool(server, client) {
+    server.tool('capivv_delete_product', 'Delete a product by ID. This is irreversible.', {
+        product_id: z.string().describe('Product ID to delete'),
+    }, async ({ product_id }) => {
+        await client.deleteProduct(product_id);
+        return { content: [{ type: 'text', text: `Product ${product_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/delete-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 registerDeleteRuleTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/delete-rule.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerDeleteRuleTool(server, client) {
+    server.tool('capivv_delete_rule', 'Delete a business rule by ID. This is irreversible.', {
+        rule_id: z.string().describe('Rule ID to delete'),
+    }, async ({ rule_id }) => {
+        await client.deleteRule(rule_id);
+        return { content: [{ type: 'text', text: `Rule ${rule_id} deleted.` }] };
+    });
+}

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/import-products.js

@@ -1,17 +1,19 @@
 import { z } from 'zod';
 export function registerImportProductsTool(server, client) {
     server.tool('capivv_import_products', 'Import products from connected App Store Connect or Google Play Console into Capivv. Returns a preview of what will be imported including suggested products, entitlements, and offerings.', { app_id: z.string().describe('App ID to import products for') }, async ({ app_id }) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const preview = await client.getImportPreview(app_id);
-        const newProducts = preview.suggestion.products.filter((p) => !p.already_exists);
-        const newEntitlements = preview.suggestion.entitlements.filter((e) => !e.already_exists);
+        const suggestion = preview.suggestion ?? {};
+        const newProducts = (suggestion.products ?? []).filter((p) => !p.already_exists);
+        const newEntitlements = (suggestion.entitlements ?? []).filter((e) => !e.already_exists);
         const summary = {
             new_products: newProducts.length,
             new_entitlements: newEntitlements.length,
-            new_offerings: preview.suggestion.offerings.length,
+            new_offerings: (suggestion.offerings ?? []).length,
             existing_counts: preview.existing_counts,
-            warnings: preview.suggestion.warnings,
+            warnings: suggestion.warnings,
             store_errors: preview.store_errors,
-            details: preview.suggestion,
+            details: suggestion,
         };
         return { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] };
     });