@capivv/mcp-server 0.2.0 → 0.5.0

package/dist/tools/trigger-sync.js

@@ -0,0 +1,6 @@
+export function registerTriggerSyncTool(server, client) {
+    server.tool('capivv_trigger_sync', 'Force an immediate sync run for every connected store integration in the workspace. Useful right after creating products in App Store Connect or Google Play to surface them as drift suggestions without waiting for the worker\'s scheduled interval.', async () => {
+        const result = await client.triggerSync();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}

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

package/dist/tools/update-app.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export function registerUpdateAppTool(server, client) {
+    server.tool('capivv_update_app', 'Update an app by ID. Provide only the fields you want to change. Common uses: rename, fix a placeholder bundle_id, edit settings.', {
+        app_id: z.string().describe('App ID'),
+        name: z.string().optional().describe('New display name'),
+        bundle_id: z
+            .string()
+            .optional()
+            .describe('New bundle ID (use to fix a placeholder like com.example.myapp)'),
+        settings: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Free-form settings JSON (merged into existing)'),
+    }, async (args) => {
+        const { app_id, ...rest } = args;
+        const app = await client.updateApp(app_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(app, null, 2) }] };
+    });
+}

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

package/dist/tools/update-entitlement.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerUpdateEntitlementTool(server, client) {
+    server.tool('capivv_update_entitlement', 'Update an entitlement by ID. Provide only the fields you want to change.', {
+        entitlement_id: z.string().describe('Entitlement ID'),
+        identifier: z.string().optional().describe('New stable identifier'),
+        display_name: z.string().optional().describe('New display name'),
+        description: z.string().optional().describe('New description'),
+    }, async (args) => {
+        const { entitlement_id, ...rest } = args;
+        const ent = await client.updateEntitlement(entitlement_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(ent, null, 2) }] };
+    });
+}

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

package/dist/tools/update-experiment.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+export function registerUpdateExperimentTool(server, client) {
+    server.tool('capivv_update_experiment', 'Update an experiment by ID. Provide only the fields you want to change. Use capivv_start_experiment / capivv_stop_experiment for status flips so audit logs and assignment freezing fire correctly.', {
+        experiment_id: z.string().describe('Experiment ID to update'),
+        name: z.string().optional().describe('New display name'),
+        description: z.string().optional().describe('New description'),
+        status: z
+            .string()
+            .optional()
+            .describe('New status (draft / running / paused / completed). Prefer start/stop tools.'),
+        target_metric: z.string().optional().describe('New target metric'),
+        start_date: z.string().optional().describe('New start timestamp (ISO 8601)'),
+        end_date: z.string().optional().describe('New end timestamp (ISO 8601)'),
+        sample_size_target: z.number().optional().describe('New sample size target'),
+        confidence_level: z.number().optional().describe('New confidence level'),
+        metadata: z.record(z.string(), z.unknown()).optional().describe('Free-form metadata'),
+    }, async (args) => {
+        const { experiment_id, ...rest } = args;
+        const exp = await client.updateExperiment(experiment_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(exp, null, 2) }] };
+    });
+}

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

package/dist/tools/update-offering.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export function registerUpdateOfferingTool(server, client) {
+    server.tool('capivv_update_offering', 'Update an offering by ID. Provide only the fields you want to change. Pass `packages` to replace the package list (full replacement, not merge — include every package you want to keep).', {
+        offering_id: z.string().describe('Offering ID'),
+        display_name: z.string().optional().describe('New display name'),
+        description: z.string().optional().describe('New description'),
+        is_default: z
+            .boolean()
+            .optional()
+            .describe('Whether this is the default offering for its app'),
+        packages: z
+            .array(z.object({
+            identifier: z.string(),
+            product_id: z.string(),
+            display_name: z.string(),
+            description: z.string().optional(),
+            package_type: z.string().describe('monthly | annual | weekly | lifetime | custom'),
+            position: z.number(),
+        }))
+            .optional()
+            .describe('Replacement package list (full replacement, not merge)'),
+        metadata: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Free-form metadata (replaces existing)'),
+    }, async (args) => {
+        const { offering_id, ...rest } = args;
+        const offering = await client.updateOffering(offering_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(offering, null, 2) }] };
+    });
+}

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

package/dist/tools/update-paywall.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export function registerUpdatePaywallTool(server, client) {
+    server.tool('capivv_update_paywall', 'Update a paywall by ID. Provide only the fields you want to change. Use this to attach a template, swap the config blob, or update metadata. Use capivv_list_paywalls to discover the paywall_id.', {
+        paywall_id: z.string().describe('Paywall ID to update'),
+        name: z.string().optional().describe('New display name'),
+        template: z
+            .string()
+            .optional()
+            .describe('Template identifier (e.g. "default", "minimal", "image_first")'),
+        config: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Paywall configuration JSON (layout, copy, products to display, etc.)'),
+        metadata: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Free-form metadata stored alongside the paywall'),
+    }, async (args) => {
+        const { paywall_id, ...rest } = args;
+        const paywall = await client.updatePaywall(paywall_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(paywall, null, 2) }] };
+    });
+}

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

package/dist/tools/update-promotion.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export function registerUpdatePromotionTool(server, client) {
+    server.tool('capivv_update_promotion', 'Update a promotion by ID. Provide only the fields you want to change. Use capivv_list_promotions to discover the promotion_id.', {
+        promotion_id: z.string().describe('Promotion ID to update'),
+        name: z.string().optional().describe('New display name'),
+        description: z.string().optional().describe('New description'),
+        discount_percent: z
+            .number()
+            .optional()
+            .describe('New percentage discount (0-100)'),
+        max_redemptions: z
+            .number()
+            .optional()
+            .describe('New redemption cap. Reduce only — increasing past current_redemptions is a no-op.'),
+    }, async (args) => {
+        const { promotion_id, ...rest } = args;
+        const promotion = await client.updatePromotion(promotion_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(promotion, null, 2) }] };
+    });
+}

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

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

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export function registerUpdateRescueFlowTool(server, client) {
+    server.tool('capivv_update_rescue_flow', [
+        'Update a rescue flow by ID. Provide only the fields you want to change.',
+        '`conditions` is an eligibility filter object (e.g. { product_ids: [...], min_tenure_days: 30 }).',
+        '`steps` is the offer ladder shown to the user during cancellation (e.g. [{ type: "discount", percent: 50 }, { type: "pause", months: 1 }]).',
+        'Use capivv_list_rescue_flows to discover the rescue_flow_id.',
+    ].join(' '), {
+        rescue_flow_id: z.string().describe('Rescue flow ID to update'),
+        name: z.string().optional().describe('New display name'),
+        description: z.string().optional().describe('New description'),
+        priority: z.number().optional().describe('New priority'),
+        conditions: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Eligibility filter object'),
+        steps: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe('Offer ladder configuration'),
+        metadata: z.record(z.string(), z.unknown()).optional().describe('Free-form metadata'),
+    }, async (args) => {
+        const { rescue_flow_id, ...rest } = args;
+        const flow = await client.updateRescueFlow(rescue_flow_id, rest);
+        return { content: [{ type: 'text', text: JSON.stringify(flow, null, 2) }] };
+    });
+}

package/dist/types.d.ts

@@ -52,6 +52,22 @@ export interface Product {
     metadata: Record<string, unknown>;
     created_at: string;
     updated_at: string;
+    /**
+     * Present only when the create call also wrote to the connected store
+     * (App Store Connect / Google Play). Carries the store-side product ID
+     * and the snapped-price audit so the AI can communicate tier deltas.
+     */
+    store_create?: StoreCreateSummary;
+}
+export interface StoreCreateSummary {
+    store: 'apple' | 'google';
+    store_product_id: string;
+    snapped_prices: Array<{
+        currency: string;
+        requested_cents: number;
+        actual_cents: number;
+        price_point_id?: string;
+    }>;
 }
 export interface Entitlement {
     id: string;
@@ -217,4 +233,290 @@ export interface CreateProductRequest {
         amount_cents: number;
         is_default?: boolean;
     }>;
+    /**
+     * V8 Phase A: when true (default) and a store integration is connected
+     * for the app's platform, the API also creates the matching product in
+     * App Store Connect / Google Play. Send false to opt out.
+     */
+    also_create_in_store?: boolean;
+    /** Default product locale for store-side localizations. Defaults to "en-US". */
+    default_locale?: string;
+}
+export interface Paywall {
+    id: string;
+    name: string;
+    identifier: string;
+    paywall_type: string;
+    status: string;
+    template: string | null;
+    total_views: number;
+    total_conversions: number;
+    conversion_rate: number;
+    config: Record<string, unknown>;
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface CreatePaywallRequest {
+    app_id: string;
+    name: string;
+    identifier: string;
+    paywall_type: string;
+}
+export interface UpdatePaywallRequest {
+    name?: string;
+    template?: string;
+    config?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface PaywallStats {
+    total_views: number;
+    total_conversions: number;
+    average_conversion_rate: number;
+}
+export interface Promotion {
+    id: string;
+    name: string;
+    description: string | null;
+    campaign_type: string;
+    status: string;
+    discount_percent: number;
+    starts_at: string;
+    ends_at: string;
+    max_redemptions: number | null;
+    current_redemptions: number;
+    revenue_micros: number;
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface CreatePromotionRequest {
+    name: string;
+    identifier?: string;
+    description?: string;
+    campaign_type: string;
+    discount_percent?: number;
+    starts_at?: string;
+    ends_at?: string;
+    max_redemptions?: number;
+}
+export interface UpdatePromotionRequest {
+    name?: string;
+    description?: string;
+    discount_percent?: number;
+    max_redemptions?: number;
+}
+export interface RescueFlow {
+    id: string;
+    name: string;
+    identifier: string;
+    description: string | null;
+    status: string;
+    priority: number;
+    conditions: Record<string, unknown>;
+    steps: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface CreateRescueFlowRequest {
+    name: string;
+    identifier: string;
+    description?: string;
+    priority?: number;
+}
+export interface UpdateRescueFlowRequest {
+    name?: string;
+    description?: string;
+    priority?: number;
+    conditions?: Record<string, unknown>;
+    steps?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface RescueStats {
+    total_rescue_attempts: number;
+    successful_rescues: number;
+    rescue_rate: number;
+    total_recovered_revenue_micros: number;
+    total_recovered_revenue_formatted: string;
+}
+export interface PricingStrategy {
+    id: string;
+    app_id: string;
+    name: string;
+    w_ppp?: number;
+    w_bigmac?: number;
+    w_fx_neutral?: number;
+    max_auto_change_pct?: number;
+    max_auto_decrease_pct?: number;
+    excluded_countries?: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface CreatePricingStrategyRequest {
+    app_id: string;
+    name: string;
+    w_ppp?: number;
+    w_bigmac?: number;
+    w_fx_neutral?: number;
+    tier1_min_aff?: number;
+    tier1_max_aff?: number;
+    tier2_min_aff?: number;
+    tier2_max_aff?: number;
+    tier3_min_aff?: number;
+    tier3_max_aff?: number;
+    tier4_min_aff?: number;
+    tier4_max_aff?: number;
+    anti_arbitrage_floor_factor?: number;
+    max_auto_change_pct?: number;
+    max_auto_decrease_pct?: number;
+    excluded_countries?: string[];
+}
+export interface PricingPreviewResult {
+    [key: string]: unknown;
+}
+export interface PricingRecomputeRequest {
+    product_id?: string;
+    strategy_id?: string;
+    reason?: string;
+}
+export interface PricingRecomputeResult {
+    prices_applied?: number;
+    approval_required?: number;
+    change_request_ids?: string[];
+    skipped?: number;
+    products_processed?: number;
+}
+export interface PricingPushResult {
+    pushed: number;
+    failed: number;
+    skipped: number;
+}
+export interface PricingChangeRequest {
+    id: string;
+    product_id: string;
+    app_id: string;
+    status: string;
+    country_code: string;
+    store: string;
+    currency: string;
+    old_amount_cents: number | null;
+    new_amount_cents: number;
+    delta_pct: number;
+    reason: string;
+    created_at: string;
+}
+export interface SetCountryPriceOverrideRequest {
+    product_id: string;
+    country_code: string;
+    store: string;
+    currency: string;
+    amount_cents: number;
+}
+export interface ExperimentWithVariants {
+    id: string;
+    name: string;
+    description: string | null;
+    status: string;
+    target_metric: string;
+    start_date: string | null;
+    end_date: string | null;
+    confidence_level: number;
+    variants: ExperimentVariant[];
+    generated_by?: string | null;
+    created_at: string;
+}
+export interface ExperimentVariant {
+    id: string;
+    name: string;
+    is_control: boolean;
+    traffic_percent: number;
+    sample_size: number;
+    conversion_count: number;
+    conversion_rate: number | null;
+    uplift_percent: number | null;
+    status: string;
+    p_value: number | null;
+    confidence_level: number | null;
+    confidence_interval_low: number | null;
+    confidence_interval_high: number | null;
+    is_statistically_significant: boolean;
+    recommendation: string | null;
+    z_score: number | null;
+}
+export interface CreateExperimentRequest {
+    name: string;
+    description?: string;
+    target_metric: string;
+    entity_type?: string;
+    entity_id?: string;
+    start_date?: string;
+    end_date?: string;
+    sample_size_target?: number;
+    confidence_level?: number;
+    metadata?: Record<string, unknown>;
+    variants: Array<{
+        name: string;
+        is_control: boolean;
+        traffic_percent: number;
+        config?: Record<string, unknown>;
+    }>;
+}
+export interface UpdateExperimentRequest {
+    name?: string;
+    description?: string;
+    status?: string;
+    target_metric?: string;
+    start_date?: string;
+    end_date?: string;
+    sample_size_target?: number;
+    confidence_level?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateAppRequest {
+    name?: string;
+    bundle_id?: string;
+    settings?: Record<string, unknown>;
+}
+export interface UpdateEntitlementRequest {
+    identifier?: string;
+    display_name?: string;
+    description?: string;
+}
+export interface UpdateOfferingRequest {
+    display_name?: string;
+    description?: string;
+    is_default?: boolean;
+    packages?: Array<{
+        identifier: string;
+        product_id: string;
+        display_name: string;
+        description?: string;
+        package_type: string;
+        position: number;
+    }>;
+    metadata?: Record<string, unknown>;
+}
+export interface AutopilotRunResult {
+    [key: string]: unknown;
+}
+export interface SyncSuggestion {
+    id: string;
+    suggestion_type: string;
+    status: string;
+    store_product_id: string;
+    store_product_name?: string | null;
+    store_product_type?: string | null;
+    store_price?: string | null;
+    store_group_name?: string | null;
+    store_source: string;
+    product_id?: string | null;
+    diff_details: Record<string, unknown>;
+    resolved_at?: string | null;
+    created_at: string;
+}
+export interface SyncSuggestionsCount {
+    pending: number;
+}
+export interface TriggerSyncResult {
+    triggered: number;
+    message: string;
 }

package/package.json

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