conduyt-mcp 4.42.0 → 4.44.0

package/dist/tools/messaging.js

@@ -128,6 +128,27 @@ export function registerMessagingTools(server, client) {
         const result = await client.get(`/api/v1/reports/speed-to-lead?${params}`);
         return formatResult(result);
     });
+    server.tool("conduyt_appointment_report", "Appointment report: every appointment whose time (basis=start, default) or booking (basis=booked) falls in the window: booked, by status (scheduled, confirmed, completed, cancelled, no-show), the outcome of the ones already in the past (held or no-show, show rate), cancellations, reschedules and upcoming; overall and by assigned user, by calendar or booking page, by lead source, by the channel it came in on (booking page, call disposition, created in Conduyt, calendar) and by day. Reschedules count moves by the attendee, by a person in Conduyt, or synced from a connected calendar. Spans clamp to 366 days; the definition comes back as `definition`.", {
+        from: z.string().optional().describe("ISO start (omit both for the last 366 days)"),
+        to: z.string().optional().describe("ISO end"),
+        basis: z.enum(["start", "booked"]).optional().describe("start (default): appointments by their time; booked: by when they were booked"),
+        assignedTo: z.string().uuid().optional().describe("Only appointments assigned to this user"),
+        sources: z.array(z.string()).max(50).optional().describe("Exact contact source values of the appointment's contact; '__none__' adds appointments with no source or no contact"),
+    }, async ({ from, to, basis, assignedTo, sources }) => {
+        const params = new URLSearchParams();
+        if (from)
+            params.set("from", from);
+        if (to)
+            params.set("to", to);
+        if (basis)
+            params.set("basis", basis);
+        if (assignedTo)
+            params.set("assignedTo", assignedTo);
+        if (sources && sources.length > 0)
+            params.set("sources", sources.join(","));
+        const result = await client.get(`/api/v1/reports/appointments?${params}`);
+        return formatResult(result);
+    });
     server.tool("conduyt_funnel_report", "Stage funnel for ONE pipeline: every deal that entered each stage in the window (created in it, or moved into it) and what happened to that presence so far (advanced to a later stage, lost, moved back, handed off to another pipeline, still there; the five add up to the entries), with the median days a settled stay lasted, plus the pipeline cohort (deals created in the window by where they sit now: won / lost / open). Built from recorded stage moves, never from where deals sit now. Windows clamp to 90 days. GET /api/v1/reports/funnel", {
         pipelineId: z.string().uuid().describe("The pipeline to report on"),
         from: z.string().optional().describe("ISO start (omit both for the last 90 days; spans clamp to 90d)"),

package/dist/tools/reports.js

@@ -42,8 +42,9 @@ export function registerReportTools(server, client) {
         chartType: z.enum(["bar", "line", "pie", "table", "funnel", "number"]).optional(),
         population: z.object({ smartViewId: z.string().uuid().nullable().optional() }).optional().describe("contacts/deals only: { smartViewId } runs the report over the contacts in that Smart View"),
         isShared: z.boolean().optional().describe("Visible to the whole account (default false = only you and admins)"),
+        isPrivate: z.boolean().optional().describe("Only the creator and admins can open it, even when shared to a dashboard (default false)"),
         pivot: pivotSchema.optional(),
-    }, async ({ name, description, entity, columns, filters, sortBy, sortDir, groupBy, groupBy2, timeGrain, aggregate, measureField, chartType, population, isShared, pivot }) => {
+    }, async ({ name, description, entity, columns, filters, sortBy, sortDir, groupBy, groupBy2, timeGrain, aggregate, measureField, chartType, population, isShared, isPrivate, pivot }) => {
         // Inline body (undefined fields drop out in JSON) — readable by the contract verifier's static parser.
         const result = await client.post("/api/v1/reports/custom", {
             name,
@@ -61,6 +62,7 @@ export function registerReportTools(server, client) {
             chartType,
             population,
             isShared,
+            isPrivate,
             pivot,
         });
         return formatResult(result);
@@ -124,8 +126,9 @@ export function registerReportTools(server, client) {
         chartType: z.enum(["bar", "line", "pie", "table", "funnel", "number"]).optional(),
         population: z.object({ smartViewId: z.string().uuid().nullable().optional() }).nullable().optional(),
         isShared: z.boolean().optional(),
+        isPrivate: z.boolean().optional().describe("Only the creator and admins can open it, even when shared"),
         pivot: pivotSchema.nullable().optional().describe("A pivot definition, or null to remove the pivot"),
-    }, async ({ id, name, description, columns, filters, sortBy, sortDir, groupBy, groupBy2, timeGrain, aggregate, measureField, chartType, population, isShared, pivot }) => {
+    }, async ({ id, name, description, columns, filters, sortBy, sortDir, groupBy, groupBy2, timeGrain, aggregate, measureField, chartType, population, isShared, isPrivate, pivot }) => {
         const result = await client.patch(`/api/v1/reports/custom/${encodeURIComponent(id)}`, {
             name,
             description,
@@ -141,6 +144,7 @@ export function registerReportTools(server, client) {
             chartType,
             population,
             isShared,
+            isPrivate,
             pivot,
         });
         return formatResult(result);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.42.0",
+  "version": "4.44.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-11T07:55:35.252Z",
-  "toolCount": 244,
-  "totalEndpoints": 951,
+  "generatedAt": "2026-09-11T10:14:55.350Z",
+  "toolCount": 245,
+  "totalEndpoints": 950,
   "counts": {
-    "covered": 226,
+    "covered": 227,
     "excluded": 283,
-    "planned": 442,
+    "planned": 440,
     "uncategorized": 0
   },
   "matrix": {
@@ -2933,10 +2933,6 @@
       "status": "planned",
       "reason": "notification surfaces"
     },
-    "GET /api/v1/ops/capacity": {
-      "status": "planned",
-      "reason": "operator capacity dashboard (#51, shipped 2026-09) — read-only queue/park telemetry; a typed conduyt_capacity_snapshot tool is agent-relevant for throughput questions"
-    },
     "GET /api/v1/phone-numbers": {
       "status": "planned",
       "reason": "phone number inventory"
@@ -3215,9 +3211,11 @@
       "status": "planned",
       "reason": "additional report surfaces beyond ai/insights"
     },
-    "GET /api/v1/reports/bda": {
-      "status": "planned",
-      "reason": "additional report surfaces beyond ai/insights"
+    "GET /api/v1/reports/appointments": {
+      "status": "covered",
+      "tools": [
+        "conduyt_appointment_report"
+      ]
     },
     "GET /api/v1/reports/calls": {
       "status": "planned",