conduyt-mcp 4.9.0 → 4.10.0

package/dist/tools/bulk.js

@@ -127,4 +127,24 @@ export function registerBulkTools(server, client) {
         const result = await client.post("/api/v1/bulk/deals/update", params);
         return formatResult(result);
     });
+    server.tool("conduyt_import_preflight", "Pre-check a contact import BEFORE running it — returns criticalWarnings (phone-less list bound for SMS, heavy create-only duplicate skips, double-mapped columns), duplicate/existing-match estimates, invalid emails, DNC/litigator hits, SMS-provider readiness, and plan-limit impact. Same engine the import wizard uses; call this before conduyt_ai_import_contacts on any sizeable list.", {
+        objectType: z.enum(["contacts", "opportunities", "companies"]).default("contacts").describe("What the import creates"),
+        importMode: z.enum(["create_and_update", "create_only", "update_only"]).optional().describe("Duplicate handling mode the import will use"),
+        totalRows: z.number().describe("Total rows in the file/payload"),
+        emails: z.array(z.string()).optional().describe("All email values from the file (order-free)"),
+        phones: z.array(z.string()).optional().describe("All phone values from the file (order-free)"),
+        mappedFields: z.array(z.string()).optional().describe("The Conduyt field names your columns map to, e.g. ['firstName','phone']"),
+        removeDuplicates: z.boolean().optional().describe("Whether explicit dedupe is on"),
+        duplicateCheckFields: z.array(z.enum(["email", "phone"])).optional().describe("Identifiers explicit dedupe checks"),
+        rowIdentifiers: z.array(z.object({
+            email: z.string().nullable().optional(),
+            phone: z.string().nullable().optional(),
+            country: z.string().nullable().optional(),
+            firstName: z.string().nullable().optional(),
+            lastName: z.string().nullable().optional(),
+        })).optional().describe("Per-row {email, phone, country, firstName, lastName} for the exact name-aware skip estimate (recommended; falls back to a conservative estimate without it)"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/imports/preflight", params);
+        return formatResult(result);
+    });
 }

package/dist/tools/contacts.js

@@ -100,4 +100,11 @@ export function registerContactTools(server, client) {
         const result = await client.post(`/api/v1/deals/${dealId}/contacts`, { contactId, role });
         return formatResult(result);
     });
+    server.tool("conduyt_verify_line_type", "Verify contacts' phone LINE TYPE (mobile/landline/VoIP) + carrier + validity via the tenant's own Twilio Lookup, stamping the results on each contact (Phone Verification custom fields). OPT-IN + TENANT-PAID (~$0.008/number on their Twilio): requires the account's lineTypeVerificationEnabled Twilio setting, configured Twilio credentials, and org-wide contact access (owner/admin/view_all). BATCHED + idempotent: each call verifies up to 50 not-yet-stamped contacts and returns { verified, remaining, done, byLineType } — CALL REPEATEDLY until done=true. Provide exactly ONE scope: smartListId or contactIds.", {
+        smartListId: z.string().uuid().optional().describe("Verify the unstamped members of this smart list"),
+        contactIds: z.array(z.string().uuid()).max(50000).optional().describe("Explicit contact UUIDs to verify (max 50,000)"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/contacts/verify-line-type", params);
+        return formatResult(result);
+    });
 }

package/dist/tools/messaging.js

@@ -66,4 +66,22 @@ export function registerMessagingTools(server, client) {
         const result = await client.get(`/api/v1/messages?${params}`);
         return formatResult(result);
     });
+    server.tool("conduyt_sms_delivery_report", "SMS provider delivery-outcome report for external-workflow SMS drips: per-automation entered vs delivered / rejected (invalid, litigator, DNC) / provider-error / workflow dead-end, plus a send-attempt 'why rejected' reason breakdown (line_type = 'not mobile' often WRONGLY rejected; landline_skipped / no_phone_skipped = Conduyt's own recorded skips). Use to answer 'what did the SMS provider do with our drips?'", {
+        from: z.string().optional().describe("ISO start (omit both for the last 180 days; spans clamp to 180d)"),
+        to: z.string().optional().describe("ISO end"),
+        automationId: z.string().uuid().optional().describe("Scope to one automation"),
+        smartListId: z.string().uuid().optional().describe("Scope to contacts in this smart list"),
+    }, async ({ from, to, automationId, smartListId }) => {
+        const params = new URLSearchParams();
+        if (from)
+            params.set("from", from);
+        if (to)
+            params.set("to", to);
+        if (automationId)
+            params.set("automationId", automationId);
+        if (smartListId)
+            params.set("smartListId", smartListId);
+        const result = await client.get(`/api/v1/reports/sms-delivery?${params}`);
+        return formatResult(result);
+    });
 }

package/package.json

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