conduyt-mcp 4.57.0 → 4.58.0

package/dist/index.js

@@ -44,6 +44,8 @@ import { registerCallFlowTools } from "./tools/call-flows.js";
 import { registerProjectBlueTools } from "./tools/project-blue.js";
 import { registerWhatsappTools } from "./tools/whatsapp.js";
 import { registerFromkTools } from "./tools/fromk.js";
+import { registerZoomTools } from "./tools/zoom.js";
+import { registerBookingPageTools } from "./tools/booking-pages.js";
 import { registerReportTools } from "./tools/reports.js";
 import { registerReportDashboardTools } from "./tools/dashboards.js";
 const apiUrl = process.env.CONDUYT_API_URL;
@@ -112,6 +114,8 @@ registerCallFlowTools(server, client);
 registerProjectBlueTools(server, client);
 registerWhatsappTools(server, client);
 registerFromkTools(server, client);
+registerZoomTools(server, client);
+registerBookingPageTools(server, client);
 registerReportTools(server, client);
 registerReportDashboardTools(server, client);
 const transport = new StdioServerTransport();

package/dist/tools/booking-pages.d.ts

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

package/dist/tools/booking-pages.js

@@ -0,0 +1,47 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+/**
+ * Booking pages (Conduyt #72, 2026-09-15): the public scheduling pages. Until now an AI operator could read appointments
+ * but not the pages that create them; these tools cover the page itself and its video option (videoProvider "zoom" =
+ * one Zoom meeting per booking, see conduyt_zoom_connect).
+ */
+const availabilityWindow = z.object({
+    dayOfWeek: z.number().int().min(0).max(6).describe("0 = Sunday … 6 = Saturday"),
+    startTime: z.string().regex(/^\d{2}:\d{2}$/).describe("HH:MM in the booking timezone"),
+    endTime: z.string().regex(/^\d{2}:\d{2}$/).describe("HH:MM in the booking timezone"),
+});
+const pageFields = {
+    title: z.string().min(1).max(200).optional().describe("page title"),
+    slug: z.string().min(1).max(100).optional().describe("public slug (conduyt.app/book/<slug>)"),
+    description: z.string().max(2000).nullable().optional(),
+    userId: z.string().uuid().optional().describe("host user UUID (the page owner)"),
+    durationMinutes: z.number().int().min(5).max(480).optional(),
+    minimumNotice: z.number().int().min(0).optional().describe("earliest booking, minutes from now"),
+    maxAdvanceDays: z.number().int().min(0).optional().describe("how far ahead visitors may book"),
+    location: z.string().max(500).nullable().optional().describe("written location (link, phone, address); with videoProvider zoom it is the fallback when Zoom is down"),
+    videoProvider: z.enum(["zoom"]).nullable().optional().describe("'zoom' = a new Zoom meeting for every booking (needs conduyt_zoom_connect); null = the written location only"),
+    videoHostEmail: z.string().email().nullable().optional().describe("the Zoom user the meeting is created under (a user of the connected Zoom account); null = the app's own user"),
+    leadSource: z.string().max(100).nullable().optional().describe("lead source stamped on contacts the page creates"),
+    brandName: z.string().max(100).nullable().optional().describe("white-label name shown on the page and in Zoom meeting names"),
+    embedAllowedOrigins: z.array(z.string().url()).nullable().optional().describe("origins allowed to embed/call the page; null or empty = any"),
+    availabilityRules: z.array(availabilityWindow).nullable().optional().describe("availability override; null = the host's own rules"),
+    isActive: z.boolean().optional(),
+};
+export function registerBookingPageTools(server, client) {
+    server.tool("conduyt_list_booking_pages", "List the account's booking pages (GET /api/v1/booking-pages): slug, title, host, duration, active, video option. Requires calendar:view.", { activeOnly: z.boolean().optional().describe("only pages accepting bookings") }, async ({ activeOnly }) => {
+        const result = await client.get(`/api/v1/booking-pages?${activeOnly ? "is_active=true" : ""}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_get_booking_page", "One booking page with every setting (GET /api/v1/booking-pages/{id}). Requires calendar:view.", { id: z.string().uuid().describe("booking page UUID") }, async ({ id }) => {
+        const result = await client.get(`/api/v1/booking-pages/${id}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_create_booking_page", "Create a booking page (POST /api/v1/booking-pages): title, slug, userId (host) and durationMinutes at least; optional written location, videoProvider 'zoom' + videoHostEmail for one Zoom meeting per booking, availabilityRules override, embedAllowedOrigins, leadSource, brandName. Requires calendar:edit (admin/owner).", { ...pageFields, title: z.string().min(1).max(200), slug: z.string().min(1).max(100), userId: z.string().uuid(), durationMinutes: z.number().int().min(5).max(480) }, async (params) => {
+        const result = await client.post("/api/v1/booking-pages", params);
+        return formatResult(result);
+    });
+    server.tool("conduyt_update_booking_page", "Update a booking page (PATCH /api/v1/booking-pages/{id}): only the fields given change. videoProvider 'zoom' turns on one Zoom meeting per booking (null turns it off and clears the host); videoHostEmail must be a user of the connected Zoom account (null = the app's own user). Requires calendar:edit (admin/owner).", { id: z.string().uuid().describe("booking page UUID"), ...pageFields }, async ({ id, ...updates }) => {
+        const result = await client.patch(`/api/v1/booking-pages/${id}`, updates);
+        return formatResult(result);
+    });
+}

package/dist/tools/zoom.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+/**
+ * Zoom (Conduyt #72, 2026-09-15): the tenant's Zoom Server-to-Server OAuth app as a Conduyt connection. Booking pages
+ * with videoProvider "zoom" create one Zoom meeting per booking (the join link is the appointment's location, rides the
+ * confirmation email and the host's calendar; cancellations delete it, reschedules move it). These tools cover what an
+ * AI operator needs: is it connected, connect/replace/disconnect the app, and prove it (plus a chosen host) works.
+ */
+export declare function registerZoomTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/zoom.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+/**
+ * Zoom (Conduyt #72, 2026-09-15): the tenant's Zoom Server-to-Server OAuth app as a Conduyt connection. Booking pages
+ * with videoProvider "zoom" create one Zoom meeting per booking (the join link is the appointment's location, rides the
+ * confirmation email and the host's calendar; cancellations delete it, reschedules move it). These tools cover what an
+ * AI operator needs: is it connected, connect/replace/disconnect the app, and prove it (plus a chosen host) works.
+ */
+export function registerZoomTools(server, client) {
+    server.tool("conduyt_zoom_status", "Zoom connection for this account (GET /api/v1/settings/zoom): status connected | not_configured, the Zoom account id and client id masked (the client secret is never returned). Requires settings:view.", {}, async () => {
+        const result = await client.get("/api/v1/settings/zoom");
+        return formatResult(result);
+    });
+    server.tool("conduyt_zoom_connect", "Connect or replace the account's Zoom Server-to-Server OAuth app (PUT /api/v1/settings/zoom): accountId, clientId, clientSecret from the Zoom App Marketplace app with scopes meeting:write/read/update/delete:meeting:admin + user:read:user:admin. Verified with Zoom before it is stored (a token must be issued and the app's own user readable: 422 credentials_rejected / scope_missing, 502 vendor_unavailable, nothing stored). Answers the app's user = the default meeting host. Pass disconnect: true to forget the app instead (DELETE): booking pages set to Zoom fall back to their written location. Requires settings:edit.", {
+        accountId: z.string().min(8).max(64).optional().describe("Zoom account id of the S2S app; required unless disconnect is true"),
+        clientId: z.string().min(8).max(64).optional().describe("Zoom client id; required unless disconnect is true"),
+        clientSecret: z.string().min(16).max(200).optional().describe("Zoom client secret; required unless disconnect is true"),
+        disconnect: z.boolean().optional().describe("true = forget the stored app (DELETE)"),
+        force: z.boolean().optional().describe("replace or disconnect although upcoming bookings still hold Zoom meetings the current app created (409 zoom_meetings_active otherwise); those meetings then stay on the old Zoom account and cancellations record zoom_orphaned"),
+    }, async ({ accountId, clientId, clientSecret, disconnect, force }) => {
+        if (disconnect) {
+            const result = await client.del(`/api/v1/settings/zoom?${force ? "force=1" : ""}`);
+            return formatResult(result);
+        }
+        if (!accountId || !clientId || !clientSecret)
+            throw new Error("accountId, clientId and clientSecret are required unless disconnect is true");
+        const result = await client.put("/api/v1/settings/zoom", { accountId, clientId, clientSecret, ...(force ? { force: true } : {}) });
+        return formatResult(result);
+    });
+    server.tool("conduyt_zoom_test", "Prove the stored Zoom app still works (POST /api/v1/settings/zoom/test): a token is issued and the app's own user answers; pass hostEmail to also prove that user belongs to the Zoom account (the value a booking page's videoHostEmail must be). Read-only on Zoom, nothing is created. 200 with ok:false + code host_not_found | credentials_rejected | scope_missing | vendor_unavailable when it does not; 409 zoom_not_configured before connect. Requires settings:view.", {
+        hostEmail: z.string().email().optional().describe("a Zoom user of the connected account to verify as a meeting host"),
+    }, async ({ hostEmail }) => {
+        const result = await client.post("/api/v1/settings/zoom/test", { hostEmail: hostEmail ?? undefined });
+        return formatResult(result);
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.57.0",
+  "version": "4.58.0",
   "description": "MCP server for Conduyt CRM — expose CRM operations as AI-accessible tools",
   "type": "module",
   "main": "dist/index.js",

package/scripts/coverage-matrix.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-09-15T16:44:24.985Z",
-  "toolCount": 268,
-  "totalEndpoints": 979,
+  "generatedAt": "2026-09-16T02:16:31.092Z",
+  "toolCount": 275,
+  "totalEndpoints": 983,
   "counts": {
-    "covered": 249,
+    "covered": 257,
     "excluded": 291,
-    "planned": 439,
+    "planned": 435,
     "uncategorized": 0
   },
   "matrix": {
@@ -791,20 +791,28 @@
       "reason": "the API itself rejects key-based billing management (interactive session required)"
     },
     "GET /api/v1/booking-pages": {
-      "status": "planned",
-      "reason": "booking page management"
+      "status": "covered",
+      "tools": [
+        "conduyt_list_booking_pages"
+      ]
     },
     "POST /api/v1/booking-pages": {
-      "status": "planned",
-      "reason": "booking page management"
+      "status": "covered",
+      "tools": [
+        "conduyt_create_booking_page"
+      ]
     },
     "GET /api/v1/booking-pages/:id": {
-      "status": "planned",
-      "reason": "booking page management"
+      "status": "covered",
+      "tools": [
+        "conduyt_get_booking_page"
+      ]
     },
     "PATCH /api/v1/booking-pages/:id": {
-      "status": "planned",
-      "reason": "booking page management"
+      "status": "covered",
+      "tools": [
+        "conduyt_update_booking_page"
+      ]
     },
     "DELETE /api/v1/booking-pages/:id": {
       "status": "planned",
@@ -3840,6 +3848,30 @@
         "conduyt_whatsapp_senders"
       ]
     },
+    "GET /api/v1/settings/zoom": {
+      "status": "covered",
+      "tools": [
+        "conduyt_zoom_status"
+      ]
+    },
+    "PUT /api/v1/settings/zoom": {
+      "status": "covered",
+      "tools": [
+        "conduyt_zoom_connect"
+      ]
+    },
+    "DELETE /api/v1/settings/zoom": {
+      "status": "covered",
+      "tools": [
+        "conduyt_zoom_connect"
+      ]
+    },
+    "POST /api/v1/settings/zoom/test": {
+      "status": "covered",
+      "tools": [
+        "conduyt_zoom_test"
+      ]
+    },
     "GET /api/v1/smart-lists": {
       "status": "covered",
       "tools": [