@capivv/mcp-server 0.5.17 → 0.5.19

package/dist/tools/index.js

@@ -25,6 +25,7 @@ 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 { registerPublishPaywallTool } from './publish-paywall.js';
 import { registerDeletePaywallTool } from './delete-paywall.js';
 import { registerGetPaywallStatsTool } from './get-paywall-stats.js';
 import { registerListPromotionsTool } from './list-promotions.js';
@@ -123,6 +124,7 @@ export function registerAllTools(server, client) {
     registerListPaywallsTool(server, client);
     registerCreatePaywallTool(server, client);
     registerUpdatePaywallTool(server, client);
+    registerPublishPaywallTool(server, client);
     registerDeletePaywallTool(server, client);
     registerGetPaywallStatsTool(server, client);
     // Promotions (V8 Phase B.2)

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

package/dist/tools/publish-paywall.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export function registerPublishPaywallTool(server, client) {
+    server.tool('capivv_publish_paywall', [
+        'Publish a draft paywall so it becomes readable to mobile SDKs via publishable (pk_*) keys.',
+        '',
+        'Until you publish, capivv_create_paywall leaves the paywall at status="draft" and the SDK\'s `Capivv.getPaywall({ identifier })` returns `template: null` (the backend hides drafts from publishable keys to avoid leaking unfinished work). Calling this tool flips the status to "active" so the SDK\'s next call returns the real template.',
+        '',
+        'Equivalent to `capivv_update_paywall(paywall_id, { status: "active" })` — kept as its own tool because publishing is the canonical "draft → live" transition and merits a clearly named action.',
+        '',
+        'Get `paywall_id` from capivv_list_paywalls or capivv_create_paywall.',
+    ].join(' '), {
+        paywall_id: z.string().describe('Paywall ID to publish.'),
+    }, async ({ paywall_id }) => {
+        const paywall = await client.updatePaywall(paywall_id, { status: 'active' });
+        return { content: [{ type: 'text', text: JSON.stringify(paywall, null, 2) }] };
+    });
+}

package/dist/tools/update-paywall.js

@@ -1,6 +1,6 @@
 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.', {
+    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, update metadata, OR change lifecycle status (e.g. publish a draft via status="active"). Use capivv_list_paywalls to discover the paywall_id. capivv_publish_paywall is a sugar wrapper for the common "draft → active" transition.', {
         paywall_id: z.string().describe('Paywall ID to update'),
         name: z.string().optional().describe('New display name'),
         template: z
@@ -15,6 +15,10 @@ export function registerUpdatePaywallTool(server, client) {
             .record(z.string(), z.unknown())
             .optional()
             .describe('Free-form metadata stored alongside the paywall'),
+        status: z
+            .enum(['draft', 'active', 'paused', 'scheduled', 'archived'])
+            .optional()
+            .describe('Lifecycle status. Set to "active" to publish so SDKs can read the paywall via publishable keys (Capivv.getPaywall reads only active paywalls when called with pk_test_* / pk_live_*). "draft" hides it from the public surface; "paused" / "archived" deactivate it temporarily / permanently.'),
     }, async (args) => {
         const { paywall_id, ...rest } = args;
         const paywall = await client.updatePaywall(paywall_id, rest);

package/dist/types.d.ts

@@ -283,11 +283,19 @@ export interface CreatePaywallRequest {
     identifier: string;
     paywall_type: string;
 }
+/** Paywall lifecycle states recognised by the backend. */
+export type PaywallStatus = 'draft' | 'active' | 'paused' | 'scheduled' | 'archived';
 export interface UpdatePaywallRequest {
     name?: string;
     template?: string;
     config?: Record<string, unknown>;
     metadata?: Record<string, unknown>;
+    /**
+     * Lifecycle status. Set to "active" to publish a draft paywall so
+     * SDK calls (`Capivv.getPaywall(...)`) can read it via publishable
+     * keys. Backend filters publishable-key reads to status=active only.
+     */
+    status?: PaywallStatus;
 }
 export interface PaywallStats {
     total_views: number;

package/package.json

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