@capivv/mcp-server 0.1.3 → 0.5.0

package/dist/tools/index.js

@@ -1,22 +1,164 @@
 import { registerStatusTool } from './status.js';
 import { registerListAppsTool } from './list-apps.js';
+import { registerCreateAppTool } from './create-app.js';
+import { registerListEntitlementsTool } from './list-entitlements.js';
+import { registerCreateEntitlementTool } from './create-entitlement.js';
 import { registerListProductsTool } from './list-products.js';
+import { registerCreateProductTool } from './create-product.js';
+import { registerUpdateProductTool } from './update-product.js';
+import { registerDeleteProductTool } from './delete-product.js';
 import { registerImportProductsTool } from './import-products.js';
 import { registerListOfferingsTool } from './list-offerings.js';
 import { registerCreateOfferingTool } from './create-offering.js';
 import { registerListRulesTool } from './list-rules.js';
 import { registerApplyRuleTool } from './apply-rule.js';
+import { registerActivateRuleTool } from './activate-rule.js';
+import { registerDeleteRuleTool } from './delete-rule.js';
 import { registerListExperimentsTool } from './list-experiments.js';
 import { registerGetAnalyticsTool } from './get-analytics.js';
+import { registerNextStepTool } from './next-step.js';
+import { registerSetupWizardTool } from './setup-wizard.js';
+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';
 export function registerAllTools(server, client) {
+    // Identity — call this first to verify which workspace you're connected to
+    registerWhoamiTool(server, client);
+    // Autopilot diagnostics — what did autopilot do for a given app?
+    registerAutopilotStatusTool(server, client);
+    // SDK telemetry — investigate suspected key leaks inline.
+    registerApiKeyUsageTool(server, client);
+    // Onboarding & guidance
+    registerNextStepTool(server, client);
+    registerSetupWizardTool(server, client);
+    registerVerifySetupTool(server, client);
+    // Status & analytics
     registerStatusTool(server, client);
+    registerGetAnalyticsTool(server, client);
+    // Apps
     registerListAppsTool(server, client);
+    registerCreateAppTool(server, client);
+    // Entitlements
+    registerListEntitlementsTool(server, client);
+    registerCreateEntitlementTool(server, client);
+    // Products
     registerListProductsTool(server, client);
+    registerCreateProductTool(server, client);
+    registerUpdateProductTool(server, client);
+    registerDeleteProductTool(server, client);
     registerImportProductsTool(server, client);
+    // Offerings
     registerListOfferingsTool(server, client);
     registerCreateOfferingTool(server, client);
+    // Rules
     registerListRulesTool(server, client);
     registerApplyRuleTool(server, client);
+    registerActivateRuleTool(server, client);
+    registerDeleteRuleTool(server, client);
+    // Experiments
     registerListExperimentsTool(server, client);
-    registerGetAnalyticsTool(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);
 }

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-entitlements.d.ts

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

package/dist/tools/list-entitlements.js

@@ -0,0 +1,6 @@
+export function registerListEntitlementsTool(server, client) {
+    server.tool('capivv_list_entitlements', 'List all entitlements (feature access identifiers) configured in your Capivv account.', async () => {
+        const entitlements = await client.listEntitlements();
+        return { content: [{ type: 'text', text: JSON.stringify(entitlements, 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/list-rules.js

@@ -1,11 +1,13 @@
 export function registerListRulesTool(server, client) {
-    server.tool('capivv_list_rules', 'List all YAML-based business rules with their status, priority, and last update time.', async () => {
+    server.tool('capivv_list_rules', 'List all business rules with their status, priority, and last update time.', async () => {
         const rules = await client.listRules();
         const summary = rules.map((r) => ({
             id: r.id,
+            identifier: r.identifier,
             name: r.name,
             priority: r.priority,
-            is_enabled: r.is_enabled,
+            status: r.status,
+            version: r.version,
             updated_at: r.updated_at,
         }));
         return { content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }] };

package/dist/tools/next-step.d.ts

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

package/dist/tools/next-step.js

@@ -0,0 +1,123 @@
+function buildSteps(state) {
+    const steps = [];
+    let stepNum = 1;
+    const total = 6;
+    // Step 1: App
+    steps.push({
+        step: stepNum++,
+        total_steps: total,
+        title: 'Register your app',
+        status: state.apps > 0 ? 'done' : 'needed',
+        what: 'Register your app with its platform and bundle ID.',
+        how: 'Use capivv_create_app with name, platform (ios/android/web), and bundle_id (e.g., "com.yourcompany.app").',
+        why: 'Every product and offering belongs to an app. This is the foundation of your setup.',
+    });
+    // Step 2: Entitlements
+    steps.push({
+        step: stepNum++,
+        total_steps: total,
+        title: 'Create entitlements',
+        status: state.entitlements > 0 ? 'done' : 'needed',
+        what: 'Define what features users unlock when they purchase (e.g., "pro", "premium").',
+        how: 'Use capivv_create_entitlement with identifier (e.g., "pro") and display_name (e.g., "Pro Access").',
+        why: 'Entitlements are how your app checks "does this user have access?" They decouple features from specific products.',
+    });
+    // Step 3: Store credentials (can't be done via MCP)
+    const storeStep = state.nextOnboardingStep === 'store_credentials_configured' || state.nextOnboardingStep === 'store_connected'
+        ? 'needed'
+        : state.products > 0
+            ? 'done'
+            : 'optional';
+    steps.push({
+        step: stepNum++,
+        total_steps: total,
+        title: 'Connect store credentials',
+        status: storeStep,
+        what: 'Connect your App Store Connect / Google Play credentials so Capivv can validate receipts and import products.',
+        how: 'Go to the Capivv dashboard → Settings → Developer → Integrations. For iOS: upload your App Store Connect API key (p8 file). For Android: upload your Google Play service account JSON.',
+        why: 'Without store credentials, Capivv cannot verify purchases or automatically sync subscription status changes.',
+    });
+    // Step 4: Products
+    steps.push({
+        step: stepNum++,
+        total_steps: total,
+        title: 'Create products',
+        status: state.products > 0 ? 'done' : 'needed',
+        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 (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 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({
+        step: stepNum++,
+        total_steps: total,
+        title: 'Create an offering',
+        status: state.offerings > 0 ? 'done' : 'needed',
+        what: 'Bundle your products into an offering that your paywall will display.',
+        how: state.products > 0
+            ? 'Use capivv_create_offering with your app_id, an identifier (e.g., "default"), and packages that reference your product IDs.'
+            : 'First complete Step 4 (create products), then use capivv_create_offering.',
+        why: 'The SDK fetches offerings to populate your paywall. Without an offering, your app has nothing to show users.',
+    });
+    // Step 6: SDK integration
+    steps.push({
+        step: stepNum++,
+        total_steps: total,
+        title: 'Integrate the SDK',
+        status: state.onboardingComplete ? 'done' : 'needed',
+        what: 'Add the Capivv SDK to your app, configure it with your public API key, and implement the paywall.',
+        how: 'Get your public key from the Capivv dashboard (Settings → Developer → API Keys). Read capivv://docs/quickstart for code examples, or capivv://docs/guides/ios for a detailed iOS walkthrough.',
+        why: 'The SDK handles user identification, entitlement checking, purchase processing, and receipt validation.',
+    });
+    return steps;
+}
+export function registerNextStepTool(server, client) {
+    server.tool('capivv_next_step', 'Analyze your current Capivv setup and tell you exactly what to do next. Returns a prioritized checklist with clear instructions for each step.', async () => {
+        const [apps, products, entitlements, offerings, rules, onboarding] = await Promise.allSettled([
+            client.listApps(),
+            client.listProducts(),
+            client.listEntitlements(),
+            client.listOfferings(),
+            client.listRules(),
+            client.getOnboarding(),
+        ]);
+        const count = (r) => r.status === 'fulfilled' ? r.value.length : 0;
+        const state = {
+            apps: count(apps),
+            entitlements: count(entitlements),
+            products: count(products),
+            offerings: count(offerings),
+            rules: count(rules),
+            onboardingComplete: onboarding.status === 'fulfilled' && onboarding.value.is_complete,
+            nextOnboardingStep: onboarding.status === 'fulfilled' ? onboarding.value.next_step : null,
+        };
+        const steps = buildSteps(state);
+        const completed = steps.filter((s) => s.status === 'done').length;
+        const needed = steps.filter((s) => s.status === 'needed');
+        const nextStep = needed[0] ?? null;
+        const result = {
+            progress: `${completed}/${steps.length} steps completed`,
+            setup_complete: needed.length === 0,
+            steps,
+        };
+        if (nextStep) {
+            result.next_action = {
+                summary: `Step ${nextStep.step}/${nextStep.total_steps}: ${nextStep.title}`,
+                what: nextStep.what,
+                how: nextStep.how,
+                why: nextStep.why,
+            };
+        }
+        else {
+            result.next_action = {
+                summary: 'Setup complete! Your Capivv integration is ready.',
+                what: 'Your app, entitlements, products, and offerings are all configured.',
+                how: 'Use capivv_get_analytics to monitor your subscription metrics, or capivv_apply_rule to add business rules like trial offers or churn recovery.',
+                why: 'You can now focus on optimizing conversions and reducing churn.',
+            };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

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;

package/dist/tools/revert-app-autopilot.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerRevertAppAutopilotTool(server, client) {
+    server.tool('capivv_revert_app_autopilot', 'Revert autopilot-generated artifacts for an app. Removes entitlements, products, offerings, and rules that were auto-created by capivv_run_app_autopilot. Manually-created records are preserved.', {
+        app_id: z.string().describe('App ID to revert autopilot on'),
+    }, async ({ app_id }) => {
+        const result = await client.revertAppAutopilot(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

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

package/dist/tools/rollback-rule.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export function registerRollbackRuleTool(server, client) {
+    server.tool('capivv_rollback_rule', 'Roll a rule back to a previous version. Use capivv_list_rule_versions to find the target version number.', {
+        rule_id: z.string().describe('Rule ID'),
+        version: z.number().describe('Version number to roll back to'),
+    }, async ({ rule_id, version }) => {
+        const rule = await client.rollbackRule(rule_id, version);
+        return { content: [{ type: 'text', text: JSON.stringify(rule, null, 2) }] };
+    });
+}

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

package/dist/tools/run-app-autopilot.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerRunAppAutopilotTool(server, client) {
+    server.tool('capivv_run_app_autopilot', 'Run autopilot for an app: idempotent re-seeding of entitlements, products, offerings, and rules from the connected store data. Safe to call repeatedly. Use capivv_revert_app_autopilot to undo.', {
+        app_id: z.string().describe('App ID to run autopilot on'),
+    }, async ({ app_id }) => {
+        const result = await client.runAppAutopilot(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/set-country-price-override.d.ts

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

package/dist/tools/set-country-price-override.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerSetCountryPriceOverrideTool(server, client) {
+    server.tool('capivv_set_country_price_override', 'Set a manual price override for a product in a specific country. Overridden prices are NOT touched by capivv_recompute_prices — they hold the value the user set until cleared. Use capivv_push_prices_to_stores to propagate the override to App Store Connect / Google Play.', {
+        product_id: z.string().describe('Product ID'),
+        country_code: z.string().describe('ISO 3166-1 alpha-2 country code (e.g. "US", "DE", "JP")'),
+        store: z.string().describe('Which store this price targets: "apple", "google", or "both"'),
+        currency: z.string().describe('ISO 4217 currency code (e.g. "USD", "EUR")'),
+        amount_cents: z.number().describe('Price in cents (e.g. 999 for $9.99)'),
+    }, async (args) => {
+        const result = await client.setCountryPriceOverride(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/setup-wizard.d.ts

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