@capivv/mcp-server 0.2.0 → 0.5.1

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

@@ -38,7 +38,7 @@ Example:
             name: z.string().describe('Product display name (e.g., "Monthly Plan")'),
             external_id: z
                 .string()
-                .describe('Store product ID — must match App Store Connect / Google Play exactly'),
+                .describe('Store product ID. With a connected store integration, Capivv creates this product in App Store Connect / Google Play too — pass the ID you want it to have there.'),
             billing_period: z
                 .string()
                 .describe('Billing period: week, month, three_months, six_months, or year'),

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

package/dist/tools/start-experiment.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerStartExperimentTool(server, client) {
+    server.tool('capivv_start_experiment', 'Flip an experiment from draft to running. New users now get assigned to variants based on traffic_percent. Use capivv_get_experiment_summary to monitor progress.', {
+        experiment_id: z.string().describe('Experiment ID to start'),
+    }, async ({ experiment_id }) => {
+        const exp = await client.startExperiment(experiment_id);
+        return { content: [{ type: 'text', text: JSON.stringify(exp, null, 2) }] };
+    });
+}

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

package/dist/tools/stop-experiment.js

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export function registerStopExperimentTool(server, client) {
+    server.tool('capivv_stop_experiment', 'Mark an experiment as completed. New users stop being assigned to variants; existing assignments are preserved for analysis. Use capivv_get_experiment_summary to read final results.', {
+        experiment_id: z.string().describe('Experiment ID to stop'),
+    }, async ({ experiment_id }) => {
+        const exp = await client.stopExperiment(experiment_id);
+        return { content: [{ type: 'text', text: JSON.stringify(exp, null, 2) }] };
+    });
+}

package/dist/tools/sync-suggestions-count.d.ts

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

package/dist/tools/sync-suggestions-count.js

@@ -0,0 +1,6 @@
+export function registerSyncSuggestionsCountTool(server, client) {
+    server.tool('capivv_sync_suggestions_count', 'Get the count of pending drift suggestions across the workspace. A quick health check before deciding whether to call capivv_check_drift for full details.', async () => {
+        const count = await client.getSyncSuggestionsCount();
+        return { content: [{ type: 'text', text: JSON.stringify(count, null, 2) }] };
+    });
+}

package/dist/tools/trigger-sync.d.ts

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

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) }] };
+    });
+}