conduyt-mcp 4.87.0 → 4.88.0

package/dist/tools/contacts.d.ts

@@ -9,4 +9,5 @@ export declare const MERGE_TIMEOUT_MS = 75000;
 export declare const LOSER_ORDER_NOTE = "losers are merged in the order given: for each field the survivor lacks, the first loser in this order with a value wins; reorder to change precedence; the dry run's filledFields shows which fields will be filled";
 export declare const MERGE_PREVIEW_MAX = 50;
 export declare const MERGE_PREVIEW_TTL_MS: number;
+export declare const EMAIL_LOOKUP_NOTE = "Exact email lookup: one address, or up to 20 distinct addresses in an array. Each is trimmed and lower-cased and matches the contact's primary email OR any secondary email slot (email_2 and up); it is an exact match, not a substring search (use `search` for partial text). Combines with every other filter (AND) inside your account and visibility. An empty or invalid address, or more than 20 distinct addresses, is a 400. On a workspace whose identifier index is still being built, the lookup answers 422 when the stored spellings of the requested addresses exceed its stored-spelling bind budget (a count of spellings, not of contacts; other filters do not help); ask support to complete the identifier backfill. Send addresses once; duplicates collapse.";
 export declare function registerContactTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/contacts.js

@@ -52,10 +52,14 @@ function createMergePreviewStore() {
         drop(key) { rows.delete(key); },
     };
 }
+/** (API ?email=, app main 318adf38d) exact lookup of one address; the API trims and lower-cases, so a stray space is harmless */
+const EMAIL_LOOKUP_ONE = z.string().trim().min(1).max(254);
+export const EMAIL_LOOKUP_NOTE = "Exact email lookup: one address, or up to 20 distinct addresses in an array. Each is trimmed and lower-cased and matches the contact's primary email OR any secondary email slot (email_2 and up); it is an exact match, not a substring search (use `search` for partial text). Combines with every other filter (AND) inside your account and visibility. An empty or invalid address, or more than 20 distinct addresses, is a 400. On a workspace whose identifier index is still being built, the lookup answers 422 when the stored spellings of the requested addresses exceed its stored-spelling bind budget (a count of spellings, not of contacts; other filters do not help); ask support to complete the identifier backfill. Send addresses once; duplicates collapse.";
 export function registerContactTools(server, client) {
     const mergePreviews = createMergePreviewStore();
-    server.tool("conduyt_list_contacts", "List and search contacts with filtering. Returns paginated results with name, email, phone, tags, source, and assignee. Each row carries `revision` (integer save revision; pass it back as expectedRevision on conduyt_update_contact or the collaborator tools).", {
+    server.tool("conduyt_list_contacts", "List and search contacts with filtering. To find the contact(s) holding a known email address, pass `email` (exact match on the primary or any secondary email); `search` is a substring search. Returns paginated results with name, email, phone, tags, source, and assignee. Each row carries `revision` (integer save revision; pass it back as expectedRevision on conduyt_update_contact or the collaborator tools).", {
         search: z.string().optional().describe("Search by name, email, or phone number"),
+        email: z.union([EMAIL_LOOKUP_ONE, z.array(EMAIL_LOOKUP_ONE).min(1).max(20)]).optional().describe(EMAIL_LOOKUP_NOTE),
         tag: z.string().optional().describe("Filter by tag name"),
         source: z.string().optional().describe("Filter by source (e.g. 'signup', 'import', 'manual')"),
         assignedTo: z.string().optional().describe("Filter by assigned user ID"),
@@ -63,10 +67,13 @@ export function registerContactTools(server, client) {
         excludeMasterStatus: z.array(z.string().trim().min(1).max(40)).max(20).optional().describe("Hide contacts whose lead status is one of these — e.g. ['won','lost','abandoned','disqualified'] is the 'Active' view. Naming a status in both lists is a 400."),
         page: z.number().optional().describe("Page number (default 1)"),
         per_page: z.number().optional().describe("Results per page (default 25, max 100)"),
-    }, async ({ search, tag, source, assignedTo, masterStatus, excludeMasterStatus, page, per_page }) => {
+    }, async ({ search, email, tag, source, assignedTo, masterStatus, excludeMasterStatus, page, per_page }) => {
         const params = new URLSearchParams();
         if (search)
             params.set("search", search);
+        // repeated `email` params, one per address (the API reads every occurrence); an omitted or empty array sends none
+        for (const address of email === undefined ? [] : Array.isArray(email) ? email : [email])
+            params.append("email", address);
         if (tag)
             params.set("tag", tag);
         if (source)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.87.0",
+  "version": "4.88.0",
   "mcpName": "com.conduyt/mcp",
   "description": "MCP server for Conduyt CRM — expose CRM operations as AI-accessible tools",
   "type": "module",

package/scripts/coverage-matrix.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-10-13T14:36:32.489Z",
+  "generatedAt": "2026-10-15T02:16:36.008Z",
   "toolCount": 350,
-  "totalEndpoints": 1080,
+  "totalEndpoints": 1084,
   "counts": {
     "covered": 309,
-    "excluded": 321,
-    "planned": 450,
+    "excluded": 323,
+    "planned": 452,
     "uncategorized": 0
   },
   "matrix": {
@@ -1941,6 +1941,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/recover-attachment-ledgers": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/recover-booking-side-effects": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1957,6 +1961,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/release-google-grants": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/reply-capture-drain": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -3227,10 +3235,18 @@
       "status": "planned",
       "reason": "lead routing rule management"
     },
+    "GET /api/v1/mailbox/callback/google": {
+      "status": "planned",
+      "reason": "mailbox sync surfaces"
+    },
     "GET /api/v1/mailbox/callback/microsoft": {
       "status": "planned",
       "reason": "mailbox sync surfaces"
     },
+    "POST /api/v1/mailbox/connect/google": {
+      "status": "planned",
+      "reason": "mailbox sync surfaces"
+    },
     "POST /api/v1/mailbox/connect/microsoft": {
       "status": "planned",
       "reason": "mailbox sync surfaces"