conduyt-mcp 4.56.0 → 4.58.0

package/dist/index.js

@@ -25,6 +25,7 @@ import { registerCustomFieldTools } from "./tools/custom-fields.js";
 import { registerSmartListTools } from "./tools/smart-lists.js";
 import { registerUserTools } from "./tools/users.js";
 import { registerBulkTools } from "./tools/bulk.js";
+import { registerBatchOperationTools } from "./tools/batch-operations.js";
 import { registerDncTools } from "./tools/dnc.js";
 import { registerSavedFilterTools } from "./tools/saved-filters.js";
 import { registerDripCampaignTools } from "./tools/drip-campaigns.js";
@@ -43,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;
@@ -92,6 +95,7 @@ registerCustomFieldTools(server, client);
 registerSmartListTools(server, client);
 registerUserTools(server, client);
 registerBulkTools(server, client);
+registerBatchOperationTools(server, client);
 registerDncTools(server, client);
 registerSavedFilterTools(server, client);
 registerDripCampaignTools(server, client);
@@ -110,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/batch-operations.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+/**
+ * Run Batch (Conduyt #80, 2026-09-15): one logged task on many contacts — the contacts page's "Select all N
+ * matching → Run Batch" action and the Run Batch page. Admins and owners only.
+ */
+export declare function registerBatchOperationTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/batch-operations.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+/**
+ * Run Batch (Conduyt #80, 2026-09-15): one logged task on many contacts — the contacts page's "Select all N
+ * matching → Run Batch" action and the Run Batch page. Admins and owners only.
+ */
+export function registerBatchOperationTools(server, client) {
+    server.tool("conduyt_create_batch_operation", "Queue a Run Batch: ONE task applied to many contacts, logged with progress and cancel (no undo). Tasks: enroll (automationId of a published workflow), delete (the #73 engine: cleanup runs, contacts with an upcoming appointment are kept), add_tag / remove_tag (params.tagId), assign (params.userId — one rep) or a round-robin pool (params.userIds, 2–50 reps rotated in order; a rep who is no longer an active member is skipped), set_source (params.source — OVERWRITES the lead source), set_status (params.status — one of the account's lead statuses; a lead with a won deal keeps its status). Pick the contacts ONE way: contactIds (up to 50,000), filterPayload (universal filters), or filter + expectedTotal — the same filter you would give conduyt_list_contacts plus the meta.total it returned; the server re-counts and refuses with 409 expected_total_mismatch when the set moved, then freezes the matching ids (max 50,000). The run is processed in the background; poll conduyt_get_batch_operation. Requires the admin or owner role and an active subscription.", {
+        name: z.string().min(1).max(256).describe("A name for the run (shown on the Run Batch page)"),
+        operation: z.enum(["enroll", "delete", "add_tag", "remove_tag", "assign", "set_source", "set_status"]).describe("The task"),
+        automationId: z.string().uuid().optional().describe("enroll only: the published workflow"),
+        params: z.record(z.string(), z.unknown()).optional().describe("Task arguments: { tagId } | { userId } | { userIds: [...] } | { source } | { status }; none for enroll and delete"),
+        comment: z.string().max(2000).optional().describe("Why this run (stored with it)"),
+        contactIds: z.array(z.string().uuid()).min(1).max(50_000).optional().describe("Explicit contacts"),
+        filterPayload: z.array(z.record(z.string(), z.unknown())).min(1).optional().describe("Universal filter rules (the Smart View filter shape)"),
+        filter: z.record(z.string(), z.union([z.string(), z.array(z.string())])).optional().describe("The contact list filter parameters, exactly as for conduyt_list_contacts; at least one non-empty value"),
+        expectedTotal: z.number().int().positive().optional().describe("With filter: the total the list showed for it (meta.total)"),
+    }, async (params) => {
+        const body = { name: params.name, operation: params.operation };
+        if (params.automationId)
+            body.automationId = params.automationId;
+        if (params.params)
+            body.params = params.params;
+        if (params.comment)
+            body.comment = params.comment;
+        if (params.contactIds)
+            body.contactIds = params.contactIds;
+        else if (params.filterPayload)
+            body.filterPayload = params.filterPayload;
+        else {
+            body.filter = params.filter;
+            body.expectedTotal = params.expectedTotal;
+        }
+        const result = await client.post("/api/v1/batch-operations", body);
+        return formatResult(result);
+    });
+    server.tool("conduyt_list_batch_operations", "List Run Batch runs (newest first): task (operation + params with the display names), status (queued | running | completed | cancelled | failed), totals and progress, creator, comment.", {
+        status: z.enum(["queued", "running", "completed", "cancelled", "failed"]).optional().describe("Only runs in this status"),
+        createdBy: z.string().uuid().optional().describe("Only runs created by this user"),
+        page: z.number().int().positive().optional().describe("Page (default 1)"),
+        limit: z.number().int().positive().max(50).optional().describe("Rows per page (default 20, max 50)"),
+    }, async (params) => {
+        const qp = new URLSearchParams();
+        if (params.status)
+            qp.set("status", params.status);
+        if (params.createdBy)
+            qp.set("createdBy", params.createdBy);
+        if (params.page)
+            qp.set("page", String(params.page));
+        if (params.limit)
+            qp.set("limit", String(params.limit));
+        const qs = qp.toString();
+        const result = await client.get(`/api/v1/batch-operations${qs ? `?${qs}` : ""}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_get_batch_operation", "One Run Batch run with its per-contact items: status per contact (pending | success | error | skipped) with the reason (e.g. 'kept: upcoming appointment', 'tag already applied', 'a lead a deal has won keeps its status').", {
+        id: z.string().uuid().describe("The run id"),
+        itemStatus: z.enum(["all", "pending", "success", "error", "skipped"]).optional().describe("Only items in this status (default all)"),
+        page: z.number().int().positive().optional().describe("Item page (default 1)"),
+        limit: z.number().int().positive().max(50).optional().describe("Items per page (default 20, max 50)"),
+    }, async (params) => {
+        const qp = new URLSearchParams();
+        if (params.itemStatus)
+            qp.set("itemStatus", params.itemStatus);
+        if (params.page)
+            qp.set("page", String(params.page));
+        if (params.limit)
+            qp.set("limit", String(params.limit));
+        const qs = qp.toString();
+        const result = await client.get(`/api/v1/batch-operations/${params.id}${qs ? `?${qs}` : ""}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_cancel_batch_operation", "Stop a queued or running Run Batch. Contacts already processed stay as they are (there is no undo); claimed-but-unprocessed contacts go back to pending and are not touched.", {
+        id: z.string().uuid().describe("The run id"),
+    }, async (params) => {
+        const result = await client.post(`/api/v1/batch-operations/${params.id}/cancel`, {});
+        return formatResult(result);
+    });
+}

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.56.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": 264,
-  "totalEndpoints": 979,
+  "generatedAt": "2026-09-16T02:16:31.092Z",
+  "toolCount": 275,
+  "totalEndpoints": 983,
   "counts": {
-    "covered": 247,
+    "covered": 257,
     "excluded": 291,
-    "planned": 441,
+    "planned": 435,
     "uncategorized": 0
   },
   "matrix": {
@@ -739,16 +739,20 @@
       "reason": "batch operation monitoring"
     },
     "POST /api/v1/batch-operations": {
-      "status": "planned",
-      "reason": "batch operation monitoring"
+      "status": "covered",
+      "tools": [
+        "conduyt_create_batch_operation"
+      ]
     },
     "GET /api/v1/batch-operations/:id": {
       "status": "planned",
       "reason": "batch operation monitoring"
     },
     "POST /api/v1/batch-operations/:id/cancel": {
-      "status": "planned",
-      "reason": "batch operation monitoring"
+      "status": "covered",
+      "tools": [
+        "conduyt_cancel_batch_operation"
+      ]
     },
     "GET /api/v1/billing/addons": {
       "status": "excluded",
@@ -787,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",
@@ -3836,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": [