@capivv/mcp-server 0.2.0 → 0.5.1

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from './config.js';
-import type { App, Product, Entitlement, Offering, Rule, Experiment, ExperimentSummary, AnalyticsOverview, OnboardingResponse, ImportPreviewResponse, CreateAppRequest, CreateEntitlementRequest, CreateProductRequest, CreateOfferingRequest, CreateRuleRequest, ValidateRuleRequest, ValidateRuleResponse, WhoamiResponse, ApiKeyUsageResponse } from './types.js';
+import type { App, Product, Entitlement, Offering, Rule, Experiment, ExperimentSummary, AnalyticsOverview, OnboardingResponse, ImportPreviewResponse, CreateAppRequest, CreateEntitlementRequest, CreateProductRequest, CreateOfferingRequest, CreateRuleRequest, ValidateRuleRequest, ValidateRuleResponse, WhoamiResponse, ApiKeyUsageResponse, Paywall, CreatePaywallRequest, UpdatePaywallRequest, PaywallStats, Promotion, CreatePromotionRequest, UpdatePromotionRequest, RescueFlow, CreateRescueFlowRequest, UpdateRescueFlowRequest, RescueStats, PricingStrategy, CreatePricingStrategyRequest, PricingPreviewResult, PricingRecomputeRequest, PricingRecomputeResult, PricingPushResult, PricingChangeRequest, SetCountryPriceOverrideRequest, ExperimentWithVariants, CreateExperimentRequest, UpdateExperimentRequest, UpdateAppRequest, UpdateEntitlementRequest, UpdateOfferingRequest, AutopilotRunResult, SyncSuggestion, SyncSuggestionsCount, TriggerSyncResult, IntegrationSummary, ConnectAppleIntegrationRequest, ConnectAppleIntegrationResult, ConnectGoogleIntegrationRequest, ConnectGoogleIntegrationResult } from './types.js';
 export declare class ApiError extends Error {
     status: number;
     code: string;
@@ -40,4 +40,55 @@ export declare class CapivvClient {
     deleteRule(id: string): Promise<void>;
     activateRule(id: string): Promise<Rule>;
     deactivateRule(id: string): Promise<Rule>;
+    listPaywalls(): Promise<Paywall[]>;
+    createPaywall(data: CreatePaywallRequest): Promise<Paywall>;
+    updatePaywall(id: string, data: UpdatePaywallRequest): Promise<Paywall>;
+    deletePaywall(id: string): Promise<void>;
+    getPaywallStats(): Promise<PaywallStats>;
+    listPromotions(): Promise<Promotion[]>;
+    createPromotion(data: CreatePromotionRequest): Promise<Promotion>;
+    updatePromotion(id: string, data: UpdatePromotionRequest): Promise<Promotion>;
+    deletePromotion(id: string): Promise<void>;
+    listRescueFlows(): Promise<RescueFlow[]>;
+    createRescueFlow(data: CreateRescueFlowRequest): Promise<RescueFlow>;
+    updateRescueFlow(id: string, data: UpdateRescueFlowRequest): Promise<RescueFlow>;
+    deleteRescueFlow(id: string): Promise<void>;
+    getRescueStats(days?: number): Promise<RescueStats>;
+    listPricingStrategies(): Promise<PricingStrategy[]>;
+    createPricingStrategy(data: CreatePricingStrategyRequest): Promise<PricingStrategy>;
+    previewPricing(productId: string, strategyId?: string): Promise<PricingPreviewResult>;
+    recomputePrices(data: PricingRecomputeRequest): Promise<PricingRecomputeResult>;
+    pushPricesToStores(productId: string): Promise<PricingPushResult>;
+    listPricingChangeRequests(appId: string, status?: string, productId?: string): Promise<PricingChangeRequest[]>;
+    approvePricingChangeRequest(id: string): Promise<void>;
+    setCountryPriceOverride(data: SetCountryPriceOverrideRequest): Promise<unknown>;
+    createExperiment(data: CreateExperimentRequest): Promise<ExperimentWithVariants>;
+    getExperiment(id: string): Promise<ExperimentWithVariants>;
+    updateExperiment(id: string, data: UpdateExperimentRequest): Promise<ExperimentWithVariants>;
+    startExperiment(id: string): Promise<ExperimentWithVariants>;
+    stopExperiment(id: string): Promise<ExperimentWithVariants>;
+    getApp(id: string): Promise<App>;
+    updateApp(id: string, data: UpdateAppRequest): Promise<App>;
+    deleteApp(id: string): Promise<void>;
+    archiveApp(id: string): Promise<App>;
+    restoreApp(id: string): Promise<App>;
+    runAppAutopilot(id: string): Promise<AutopilotRunResult>;
+    revertAppAutopilot(id: string): Promise<AutopilotRunResult>;
+    getEntitlement(id: string): Promise<Entitlement>;
+    updateEntitlement(id: string, data: UpdateEntitlementRequest): Promise<Entitlement>;
+    deleteEntitlement(id: string): Promise<void>;
+    getProduct(id: string): Promise<Product>;
+    getRuleById(id: string): Promise<Rule>;
+    listRuleVersions(id: string): Promise<unknown>;
+    rollbackRule(id: string, version: number): Promise<Rule>;
+    getOffering(id: string): Promise<Offering>;
+    updateOffering(id: string, data: UpdateOfferingRequest): Promise<Offering>;
+    listSyncSuggestions(appId?: string, status?: string): Promise<SyncSuggestion[]>;
+    getSyncSuggestionsCount(): Promise<SyncSuggestionsCount>;
+    resolveSyncSuggestion(id: string, action: 'accept' | 'dismiss'): Promise<SyncSuggestion>;
+    triggerSync(): Promise<TriggerSyncResult>;
+    listIntegrations(): Promise<IntegrationSummary[]>;
+    connectAppleIntegration(data: ConnectAppleIntegrationRequest): Promise<ConnectAppleIntegrationResult>;
+    connectGoogleIntegration(data: ConnectGoogleIntegrationRequest): Promise<ConnectGoogleIntegrationResult>;
+    disconnectIntegration(provider: string): Promise<void>;
 }

package/dist/client.js

@@ -150,4 +150,193 @@ export class CapivvClient {
     async deactivateRule(id) {
         return this.post(`/dashboard/rules/${encodeURIComponent(id)}/deactivate`);
     }
+    // ---- Paywalls (V8 Phase B.1) ----
+    async listPaywalls() {
+        const resp = await this.get('/dashboard/paywalls');
+        return resp.paywalls;
+    }
+    async createPaywall(data) {
+        return this.post('/dashboard/paywalls', data);
+    }
+    async updatePaywall(id, data) {
+        return this.patch(`/dashboard/paywalls/${encodeURIComponent(id)}`, data);
+    }
+    async deletePaywall(id) {
+        await this.delete(`/dashboard/paywalls/${encodeURIComponent(id)}`);
+    }
+    async getPaywallStats() {
+        return this.get('/dashboard/paywalls/stats');
+    }
+    // ---- Promotions (V8 Phase B.2) ----
+    async listPromotions() {
+        const resp = await this.get('/dashboard/promotions');
+        return resp.promotions;
+    }
+    async createPromotion(data) {
+        return this.post('/dashboard/promotions', data);
+    }
+    async updatePromotion(id, data) {
+        return this.patch(`/dashboard/promotions/${encodeURIComponent(id)}`, data);
+    }
+    async deletePromotion(id) {
+        await this.delete(`/dashboard/promotions/${encodeURIComponent(id)}`);
+    }
+    // ---- Rescue Flows (V8 Phase B.3) ----
+    async listRescueFlows() {
+        const resp = await this.get('/dashboard/rescue-flows');
+        return resp.flows;
+    }
+    async createRescueFlow(data) {
+        return this.post('/dashboard/rescue-flows', data);
+    }
+    async updateRescueFlow(id, data) {
+        return this.patch(`/dashboard/rescue-flows/${encodeURIComponent(id)}`, data);
+    }
+    async deleteRescueFlow(id) {
+        await this.delete(`/dashboard/rescue-flows/${encodeURIComponent(id)}`);
+    }
+    async getRescueStats(days = 30) {
+        return this.get(`/dashboard/rescue-flows/stats?days=${days}`);
+    }
+    // ---- Pricing (V8 Phase B.4) ----
+    async listPricingStrategies() {
+        const resp = await this.get('/dashboard/pricing/strategies');
+        return resp.strategies;
+    }
+    async createPricingStrategy(data) {
+        const resp = await this.post('/dashboard/pricing/strategies', data);
+        return resp.strategy;
+    }
+    async previewPricing(productId, strategyId) {
+        return this.post('/dashboard/pricing/preview', {
+            product_id: productId,
+            strategy_id: strategyId,
+        });
+    }
+    async recomputePrices(data) {
+        return this.post('/dashboard/pricing/recompute', data);
+    }
+    async pushPricesToStores(productId) {
+        return this.post('/dashboard/pricing/push', { product_id: productId });
+    }
+    async listPricingChangeRequests(appId, status, productId) {
+        const params = new URLSearchParams({ app_id: appId });
+        if (status)
+            params.set('status', status);
+        if (productId)
+            params.set('product_id', productId);
+        const resp = await this.get(`/dashboard/pricing/change-requests?${params.toString()}`);
+        return resp.change_requests;
+    }
+    async approvePricingChangeRequest(id) {
+        await this.post(`/dashboard/pricing/change-requests/${encodeURIComponent(id)}/approve`);
+    }
+    async setCountryPriceOverride(data) {
+        const { product_id, country_code, ...body } = data;
+        return this.request('PUT', `/dashboard/products/${encodeURIComponent(product_id)}/prices/${encodeURIComponent(country_code)}`, body);
+    }
+    // ---- Experiment writes (V8 Phase B.5) ----
+    async createExperiment(data) {
+        return this.post('/dashboard/experiments', data);
+    }
+    async getExperiment(id) {
+        return this.get(`/dashboard/experiments/${encodeURIComponent(id)}`);
+    }
+    async updateExperiment(id, data) {
+        return this.patch(`/dashboard/experiments/${encodeURIComponent(id)}`, data);
+    }
+    async startExperiment(id) {
+        return this.post(`/dashboard/experiments/${encodeURIComponent(id)}/start`);
+    }
+    async stopExperiment(id) {
+        return this.post(`/dashboard/experiments/${encodeURIComponent(id)}/stop`);
+    }
+    // ---- Apps gap-fillers (V8 Phase B.6) ----
+    async getApp(id) {
+        return this.get(`/dashboard/apps/${encodeURIComponent(id)}`);
+    }
+    async updateApp(id, data) {
+        return this.patch(`/dashboard/apps/${encodeURIComponent(id)}`, data);
+    }
+    async deleteApp(id) {
+        await this.delete(`/dashboard/apps/${encodeURIComponent(id)}`);
+    }
+    async archiveApp(id) {
+        return this.post(`/dashboard/apps/${encodeURIComponent(id)}/archive`);
+    }
+    async restoreApp(id) {
+        return this.post(`/dashboard/apps/${encodeURIComponent(id)}/restore`);
+    }
+    async runAppAutopilot(id) {
+        return this.post(`/dashboard/apps/${encodeURIComponent(id)}/autopilot/run`);
+    }
+    async revertAppAutopilot(id) {
+        return this.post(`/dashboard/apps/${encodeURIComponent(id)}/autopilot/revert`);
+    }
+    // ---- Entitlements gap-fillers (V8 Phase B.7) ----
+    async getEntitlement(id) {
+        return this.get(`/dashboard/entitlements/${encodeURIComponent(id)}`);
+    }
+    async updateEntitlement(id, data) {
+        return this.patch(`/dashboard/entitlements/${encodeURIComponent(id)}`, data);
+    }
+    async deleteEntitlement(id) {
+        await this.delete(`/dashboard/entitlements/${encodeURIComponent(id)}`);
+    }
+    // ---- Products gap-filler (V8 Phase B.8) ----
+    async getProduct(id) {
+        return this.get(`/dashboard/products/${encodeURIComponent(id)}`);
+    }
+    // ---- Rules gap-fillers (V8 Phase B.9) ----
+    async getRuleById(id) {
+        return this.get(`/dashboard/rules/${encodeURIComponent(id)}`);
+    }
+    async listRuleVersions(id) {
+        return this.get(`/dashboard/rules/${encodeURIComponent(id)}/versions`);
+    }
+    async rollbackRule(id, version) {
+        return this.post(`/dashboard/rules/${encodeURIComponent(id)}/rollback`, { version });
+    }
+    // ---- Offerings gap-fillers (V8 Phase B.10) ----
+    async getOffering(id) {
+        return this.get(`/dashboard/offerings/${encodeURIComponent(id)}`);
+    }
+    async updateOffering(id, data) {
+        return this.patch(`/dashboard/offerings/${encodeURIComponent(id)}`, data);
+    }
+    // ---- Drift detection (V8 Phase C) ----
+    async listSyncSuggestions(appId, status) {
+        const params = new URLSearchParams();
+        if (appId)
+            params.set('app_id', appId);
+        if (status)
+            params.set('status', status);
+        const qs = params.toString();
+        return this.get(`/dashboard/sync/suggestions${qs ? `?${qs}` : ''}`);
+    }
+    async getSyncSuggestionsCount() {
+        return this.get('/dashboard/sync/suggestions/count');
+    }
+    async resolveSyncSuggestion(id, action) {
+        return this.post(`/dashboard/sync/suggestions/${encodeURIComponent(id)}/resolve`, {
+            action,
+        });
+    }
+    async triggerSync() {
+        return this.post('/dashboard/sync/trigger');
+    }
+    // ---- Integrations (V8.1) ----
+    async listIntegrations() {
+        const resp = await this.get('/dashboard/integrations');
+        return resp.integrations;
+    }
+    async connectAppleIntegration(data) {
+        return this.post('/dashboard/integrations/apple/connect', data);
+    }
+    async connectGoogleIntegration(data) {
+        return this.post('/dashboard/integrations/google/connect', data);
+    }
+    async disconnectIntegration(provider) {
+        await this.post(`/dashboard/integrations/${encodeURIComponent(provider)}/disconnect`);
+    }
 }

package/dist/tools/approve-change-request.d.ts

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

package/dist/tools/approve-change-request.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export function registerApproveChangeRequestTool(server, client) {
+    server.tool('capivv_approve_change_request', 'Approve a pending pricing change request. The new price is applied to Capivv immediately. Use capivv_push_prices_to_stores afterwards to propagate to App Store Connect / Google Play.', {
+        change_request_id: z.string().describe('Change request ID to approve'),
+    }, async ({ change_request_id }) => {
+        await client.approvePricingChangeRequest(change_request_id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Change request ${change_request_id} approved. The new price is now in Capivv. Call capivv_push_prices_to_stores to propagate to the stores.`,
+                },
+            ],
+        };
+    });
+}

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

package/dist/tools/archive-app.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerArchiveAppTool(server, client) {
+    server.tool('capivv_archive_app', 'Archive an app (soft delete). The app stops serving new traffic but its data is preserved. Use capivv_restore_app to bring it back. Prefer this over capivv_delete_app unless permanent removal is required.', {
+        app_id: z.string().describe('App ID to archive'),
+    }, async ({ app_id }) => {
+        const app = await client.archiveApp(app_id);
+        return { content: [{ type: 'text', text: JSON.stringify(app, null, 2) }] };
+    });
+}

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

package/dist/tools/check-drift.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export function registerCheckDriftTool(server, client) {
+    server.tool('capivv_check_drift', [
+        'List drift between Capivv and the connected store(s) — products that exist in the store but not in Capivv, prices that differ, metadata that changed, products deleted from the store.',
+        'Each entry has a `suggestion_type` (new_product | price_changed | metadata_changed | product_deleted) and a `diff_details` payload describing the mismatch.',
+        'Use capivv_resolve_drift to accept (apply the change) or dismiss (ignore) each one.',
+        'Drift is detected continuously by the background sync worker; call capivv_trigger_sync to force an immediate scan if you suspect the listing is stale.',
+    ].join(' '), {
+        app_id: z
+            .string()
+            .optional()
+            .describe('Filter by app. When omitted, the API returns drift for the first app in the workspace.'),
+        status: z
+            .string()
+            .optional()
+            .describe('Filter by status: pending (default), accepted, dismissed, auto_resolved'),
+    }, async ({ app_id, status }) => {
+        const suggestions = await client.listSyncSuggestions(app_id, status);
+        return { content: [{ type: 'text', text: JSON.stringify(suggestions, null, 2) }] };
+    });
+}

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

package/dist/tools/connect-apple-integration.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export function registerConnectAppleIntegrationTool(server, client) {
+    server.tool('capivv_connect_apple_integration', [
+        'Connect an App Store Connect API key to the workspace. After this succeeds, capivv_create_product can write subscriptions / IAPs to App Store Connect on the customer\'s behalf.',
+        '',
+        'WARNING — the .p8 private key is sensitive. Make sure the key has at least App Manager role (Developer is not sufficient for write operations). The credentials are encrypted at rest.',
+        '',
+        'You can find issuer_id, key_id, and download the .p8 in App Store Connect → Users and Access → Integrations → App Store Connect API.',
+    ].join(' '), {
+        issuer_id: z
+            .string()
+            .describe('Issuer ID (UUID) shown in App Store Connect → Integrations'),
+        key_id: z
+            .string()
+            .describe('Key ID (10-character string) shown next to the key in App Store Connect'),
+        private_key: z
+            .string()
+            .describe('Full PEM contents of the .p8 file: starts with "-----BEGIN PRIVATE KEY-----" and ends with "-----END PRIVATE KEY-----".'),
+        shared_secret: z
+            .string()
+            .optional()
+            .describe('Optional legacy shared secret for verifyReceipt fallback (rarely needed for new integrations).'),
+    }, async (args) => {
+        const result = await client.connectAppleIntegration(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

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

package/dist/tools/connect-google-integration.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export function registerConnectGoogleIntegrationTool(server, client) {
+    server.tool('capivv_connect_google_integration', [
+        'Connect a Google Play service account key to the workspace. After this succeeds, capivv_create_product can write subscriptions / IAPs to Google Play on the customer\'s behalf.',
+        '',
+        'WARNING — service account JSON contains a private key and is sensitive. The service account needs the "Financial data" + "Manage orders and subscriptions" permissions in Google Play Console. The credentials are encrypted at rest.',
+        '',
+        'Each package_name is validated against the Play Developer API; invalid ones are returned in `errors` so the customer can fix them and retry.',
+    ].join(' '), {
+        service_account_json: z
+            .string()
+            .describe('Raw JSON contents of the service account key file (the whole {...} blob).'),
+        package_names: z
+            .array(z.string())
+            .describe('Bundle IDs (Android package names) the service account should be able to manage, e.g. ["com.example.app"].'),
+    }, async (args) => {
+        const result = await client.connectGoogleIntegration(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

package/dist/tools/create-experiment.d.ts

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

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.js

@@ -1,13 +1,12 @@
 import { z } from 'zod';
 export function registerCreateProductTool(server, client) {
     server.tool('capivv_create_product', [
-        'Create a Capivv-side product record (subscription, consumable, or non-consumable).',
-        'Sets pricing, subscription config, and entitlement links in one call.',
+        '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).',
         '',
-        'IMPORTANT: this creates the record inside Capivv only. Capivv does not write to App Store Connect or Google Play.',
-        'For purchases to validate, a product with the SAME `external_id` must also exist in App Store Connect (and/or Google Play) at the same price you set here.',
-        'Typical flow: create or confirm the product in App Store Connect at $X.XX, then call this tool with `external_id` matching the App Store Connect product ID.',
-        'Skip-to-import path: if products already exist in App Store Connect and your tenant has store credentials connected, use capivv_import_products instead — it pulls them in automatically.',
+        '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")'),
@@ -35,8 +34,44 @@ export function registerCreateProductTool(server, client) {
         }))
             .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 product = await client.createProduct(args);
-        return { content: [{ type: 'text', text: JSON.stringify(product, null, 2) }] };
+        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;