@capivv/mcp-server 0.5.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, 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 } 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;
@@ -87,4 +87,8 @@ export declare class CapivvClient {
     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

@@ -325,4 +325,18 @@ export class CapivvClient {
     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/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/disconnect-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 registerDisconnectIntegrationTool(server: McpServer, client: CapivvClient): void;

package/dist/tools/disconnect-integration.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export function registerDisconnectIntegrationTool(server, client) {
+    server.tool('capivv_disconnect_integration', 'Disconnect a store integration. Removes stored credentials and stops syncing. Useful when rotating an Apple .p8 or Google service account — call this, then capivv_connect_apple_integration / capivv_connect_google_integration with the new credentials.', {
+        provider: z
+            .enum(['apple_app_store', 'google_play', 'stripe'])
+            .describe('Which provider to disconnect.'),
+    }, async ({ provider }) => {
+        await client.disconnectIntegration(provider);
+        return {
+            content: [{ type: 'text', text: `Disconnected ${provider}.` }],
+        };
+    });
+}

package/dist/tools/index.js

@@ -68,6 +68,10 @@ 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';
+import { registerListIntegrationsTool } from './list-integrations.js';
+import { registerConnectAppleIntegrationTool } from './connect-apple-integration.js';
+import { registerConnectGoogleIntegrationTool } from './connect-google-integration.js';
+import { registerDisconnectIntegrationTool } from './disconnect-integration.js';
 export function registerAllTools(server, client) {
     // Identity — call this first to verify which workspace you're connected to
     registerWhoamiTool(server, client);
@@ -161,4 +165,12 @@ export function registerAllTools(server, client) {
     registerResolveDriftTool(server, client);
     registerSyncSuggestionsCountTool(server, client);
     registerTriggerSyncTool(server, client);
+    // Integrations management (V8.1 — added after the Interrupt customer
+    // hit a blocked-store-write because their integration was in a stale
+    // error state. The agent can now diagnose and fix integrations
+    // without bouncing the customer to the dashboard.)
+    registerListIntegrationsTool(server, client);
+    registerConnectAppleIntegrationTool(server, client);
+    registerConnectGoogleIntegrationTool(server, client);
+    registerDisconnectIntegrationTool(server, client);
 }

package/dist/tools/list-integrations.d.ts

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

package/dist/tools/list-integrations.js

@@ -0,0 +1,6 @@
+export function registerListIntegrationsTool(server, client) {
+    server.tool('capivv_list_integrations', 'List every store integration (Apple App Store, Google Play, Stripe) for the workspace with its status, last sync, and any error message. Useful for diagnosing why capivv_create_product failed — if the integration shows "error", the credentials are likely stale or revoked.', async () => {
+        const integrations = await client.listIntegrations();
+        return { content: [{ type: 'text', text: JSON.stringify(integrations, null, 2) }] };
+    });
+}

package/dist/types.d.ts

@@ -520,3 +520,37 @@ export interface TriggerSyncResult {
     triggered: number;
     message: string;
 }
+export interface IntegrationSummary {
+    provider: string;
+    provider_name: string;
+    status: string;
+    is_connected: boolean;
+    last_sync_at?: string | null;
+    has_error: boolean;
+    error_message?: string | null;
+}
+export interface ConnectAppleIntegrationRequest {
+    issuer_id: string;
+    key_id: string;
+    /** PEM-encoded App Store Connect API private key (.p8 contents). */
+    private_key: string;
+    /** Optional legacy shared secret for verifyReceipt fallback. */
+    shared_secret?: string;
+}
+export interface ConnectAppleIntegrationResult {
+    status: string;
+    app_count: number;
+}
+export interface ConnectGoogleIntegrationRequest {
+    /** Service account JSON key (raw contents, not a file path). */
+    service_account_json: string;
+    package_names: string[];
+}
+export interface ConnectGoogleIntegrationResult {
+    status: string;
+    validated_packages: string[];
+    errors: Array<{
+        package_name: string;
+        error: string;
+    }>;
+}

package/package.json

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