conduyt-mcp 4.82.0 → 4.83.0

package/README.md

@@ -112,6 +112,8 @@ MCP server for [Conduyt CRM](https://conduyt.app) — expose your CRM as AI-acce
 | `conduyt_send_email` | Send a single email to a contact |
 | `conduyt_check_message` | Grade a draft text or email before sending (`POST /messages/check`): score, grade, verdict, flagged words with safer alternatives (Unicode code-point offsets), checks, a text's segment count. Educates, never blocks; nothing stored or sent. `context` template / first / conversation (pick from `hasOutboundSms`); `provider: "twilio"` (text only; the notices in Twilio's wording; an email with a provider is a 400) and `clean: true` (adds the cleaner's proposal); the answer carries `breakdown`, `notices`, `unicodeCulprits` and `engine.version` (2.1.2); 20 per minute per account; 400 / 403 / 413 / 429 surfaced verbatim, never retried |
 | `conduyt_list_sms_provider_options` | The workspace's active SMS providers, redacted (`GET /sms-providers/template-options`): `{ data: [{ id, name, color }] }`, nothing else. Needs `email_templates.view` or `settings.view` (scopes emails / sms / messages / settings); read-only |
+| `conduyt_get_message_check_minimum_grade` | The admin's Message check minimum grade to send (`settings.messageCheck.minimumGrade`): `enabled`, per-channel `sms` / `email` minimum (letter A-F, score 0-100 or null) and `adminOverride`. Groundwork: stored and read back, not enforced yet. Owner / admin only (anyone else gets `visible: false`); settings scope |
+| `conduyt_update_message_check_minimum_grade` | Change it (`PATCH /settings`): `enabled`, `smsMinimum`, `emailMinimum`, `adminOverride`; sends the whole block with the settings revision it read. `enabled: true` is refused 400 `minimum_grade_not_available_yet`; a non-owner / non-admin gets 403 `forbidden`; 422 for E, fractions, out-of-range scores; all verbatim, never retried |
 | `conduyt_log_message` | Record a message on a contact's timeline; an inbound SMS STOP or START records the number's opt-out or opt-in and answers smsConsent |
 
 ### Calendly

package/dist/index.js

@@ -13,6 +13,7 @@ import { registerAiTools } from "./tools/ai.js";
 import { registerAutomationTools } from "./tools/automations.js";
 import { registerSequenceTools } from "./tools/sequences.js";
 import { registerMessagingTools } from "./tools/messaging.js";
+import { registerMessageCheckSettingsTools } from "./tools/message-check-settings.js";
 import { registerCallTools } from "./tools/calls.js";
 import { registerDialerSettingsTools } from "./tools/dialer-settings.js";
 import { registerCompanyTools } from "./tools/companies.js";
@@ -91,6 +92,7 @@ registerAiTools(server, client);
 registerAutomationTools(server, client);
 registerSequenceTools(server, client);
 registerMessagingTools(server, client);
+registerMessageCheckSettingsTools(server, client);
 registerCallTools(server, client);
 registerDialerSettingsTools(server, client);
 registerCompanyTools(server, client);

package/dist/tools/bulk.d.ts

@@ -1,3 +1,5 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ConduytClient } from "../client.js";
+/** (#136, Codex r1 m2) POST /bulk/contacts/update is NOT atomic and answers per row: an impossible phone is a per-row success:false inside HTTP 200 (no code) while other rows commit; the route takes no country */
+export declare const BULK_UPDATE_REFUSALS = " Results are PER ROW inside an HTTP 200 (not atomic: some rows can be saved while others fail): read data.summary { total, succeeded, failed } and data.results, each { id, success, error? }. An impossible US/Canada number (area code or exchange starting 0 or 1) fails only that row, success: false with the error text (no phone_invalid code, no top-level 400), and nothing is saved for that row. This route does not take country: a country-only row fails as a row, and a country sent beside another field is ignored while that field is applied (use conduyt_bulk_edit_contacts for a country; it refuses a null or blank country 400 country_invalid).";
 export declare function registerBulkTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/bulk.js

@@ -1,5 +1,8 @@
 import { z } from "zod";
 import { formatResult } from "../client.js";
+import { INVALID_NUMBER_REFUSALS } from "./contacts.js";
+/** (#136, Codex r1 m2) POST /bulk/contacts/update is NOT atomic and answers per row: an impossible phone is a per-row success:false inside HTTP 200 (no code) while other rows commit; the route takes no country */
+export const BULK_UPDATE_REFUSALS = " Results are PER ROW inside an HTTP 200 (not atomic: some rows can be saved while others fail): read data.summary { total, succeeded, failed } and data.results, each { id, success, error? }. An impossible US/Canada number (area code or exchange starting 0 or 1) fails only that row, success: false with the error text (no phone_invalid code, no top-level 400), and nothing is saved for that row. This route does not take country: a country-only row fails as a row, and a country sent beside another field is ignored while that field is applied (use conduyt_bulk_edit_contacts for a country; it refuses a null or blank country 400 country_invalid).";
 export function registerBulkTools(server, client) {
     server.tool("conduyt_ai_import_contacts", "AI-powered bulk contact import. Accepts up to 1000 contacts with optional auto-tagging, smart list creation, and automation enrollment. Deduplicates by email, phone, or both.", {
         contacts: z.array(z.object({
@@ -94,14 +97,14 @@ export function registerBulkTools(server, client) {
         const result = await client.post("/api/v1/bulk/contacts/untag", params);
         return formatResult(result);
     });
-    server.tool("conduyt_bulk_edit_contacts", "Apply the SAME field changes to many contacts at once (one updates object → all ids). For different values per contact, use conduyt_bulk_update_contacts. Requires contacts:edit.", {
+    server.tool("conduyt_bulk_edit_contacts", "Apply the SAME field changes to many contacts at once (one updates object → all ids). For different values per contact, use conduyt_bulk_update_contacts. Requires contacts:edit." + INVALID_NUMBER_REFUSALS, {
         ids: z.array(z.string()).describe("Contact UUIDs to edit"),
         updates: z.record(z.any()).describe("Fields to set on every listed contact, e.g. { assignedTo: '<uuid>', source: 'webinar', customFields: { tier: 'gold' } }. customFields merge into existing values."),
     }, async (params) => {
         const result = await client.post("/api/v1/bulk/contacts/edit", params);
         return formatResult(result);
     });
-    server.tool("conduyt_bulk_update_contacts", "Apply DIFFERENT field changes per contact in one call (each row carries its own id + fields). For the same change across many, use conduyt_bulk_edit_contacts. Requires contacts:edit.", {
+    server.tool("conduyt_bulk_update_contacts", "Apply DIFFERENT field changes per contact in one call (each row carries its own id + fields). For the same change across many, use conduyt_bulk_edit_contacts. Requires contacts:edit." + BULK_UPDATE_REFUSALS, {
         updates: z
             .array(z.record(z.any()))
             .describe("Array of per-contact update objects; each MUST include 'id' plus the fields to change, e.g. [{ id: '<uuid>', firstName: 'Ada' }, …]"),

package/dist/tools/contacts.d.ts

@@ -2,4 +2,6 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { ConduytClient } from "../client.js";
 /** The contact save revision pin (catalog bounds: integer 0..2147483647). */
 export declare const CONTACT_REVISION_MAX = 2147483647;
+/** (#136, app 10-10) the refusals the contact writes answer for a number or a country the API cannot accept: surfaced verbatim, never retried */
+export declare const INVALID_NUMBER_REFUSALS = " An impossible US/Canada number (area code or exchange starting 0 or 1) is refused 400 phone_invalid and nothing is saved; a country is never null or blank (400 country_invalid on an update, 2-letter code, min 1 character). Both are surfaced verbatim and never retried.";
 export declare function registerContactTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/contacts.js

@@ -20,6 +20,8 @@ function resolveCustomFields(camel, snake) {
     }
     return camel !== undefined ? camel : snake;
 }
+/** (#136, app 10-10) the refusals the contact writes answer for a number or a country the API cannot accept: surfaced verbatim, never retried */
+export const INVALID_NUMBER_REFUSALS = " An impossible US/Canada number (area code or exchange starting 0 or 1) is refused 400 phone_invalid and nothing is saved; a country is never null or blank (400 country_invalid on an update, 2-letter code, min 1 character). Both are surfaced verbatim and never retried.";
 export function registerContactTools(server, client) {
     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).", {
         search: z.string().optional().describe("Search by name, email, or phone number"),
@@ -57,7 +59,7 @@ export function registerContactTools(server, client) {
         const result = await client.get(`/api/v1/contacts/${id}`);
         return formatResult(result);
     });
-    server.tool("conduyt_create_contact", "Create a new contact in the CRM. Email or phone is recommended but not strictly required.", {
+    server.tool("conduyt_create_contact", "Create a new contact in the CRM. Email or phone is recommended but not strictly required." + INVALID_NUMBER_REFUSALS, {
         email: z.string().optional().describe("Contact email address"),
         firstName: z.string().optional().describe("First name"),
         lastName: z.string().optional().describe("Last name"),
@@ -75,7 +77,7 @@ export function registerContactTools(server, client) {
         const result = await client.post("/api/v1/contacts", body);
         return formatResult(result);
     });
-    strictInput(server.tool("conduyt_update_contact", "Update an existing contact's fields — name, email, phone, company, custom fields. customFields merge into existing values (omit a key to leave it unchanged). Pass expectedRevision (the contact's `revision` as you read it) to refuse the save when the contact changed since. " + CONTACT_CHANGED, {
+    strictInput(server.tool("conduyt_update_contact", "Update an existing contact's fields — name, email, phone, company, custom fields. customFields merge into existing values (omit a key to leave it unchanged). Pass expectedRevision (the contact's `revision` as you read it) to refuse the save when the contact changed since." + INVALID_NUMBER_REFUSALS + " " + CONTACT_CHANGED, {
         id: z.string().describe("Contact UUID"),
         email: z.string().optional().describe("Updated email"),
         firstName: z.string().optional().describe("Updated first name"),

package/dist/tools/message-check-settings.d.ts

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ConduytClient } from "../client.js";
+/**
+ * Message check minimum grade, #134 groundwork (app 10-10, LIVE 9:19 AM): the admin's lowest acceptable Message check result per
+ * channel, stored in the account settings as settings.messageCheck.minimumGrade. NOTHING enforces it yet (Send stays enabled for
+ * everyone); enabled: true is refused 400 minimum_grade_not_available_yet until the feature is switched on. Owner / admin only:
+ * GET /settings leaves the block out for anyone else and PATCH answers 403 forbidden. No new scope: the existing `settings` scope.
+ */
+export declare const MINIMUM_GRADE_NOTE = "Groundwork only: the minimum is stored and read back but NOT enforced yet (Send stays enabled for everyone), and enabled: true is refused 400 minimum_grade_not_available_yet until the feature is switched on.";
+export declare const MinimumGradeChannelValue: z.ZodUnion<[z.ZodEnum<["A", "B", "C", "D", "F"]>, z.ZodNumber, z.ZodNull]>;
+type Block = {
+    enabled: boolean;
+    channel: {
+        sms: unknown;
+        email: unknown;
+    };
+    adminOverride: boolean;
+};
+/** the stored block with the defaults laid under it field by field (never throws); null when the key's member is not an owner / admin (the API leaves the block out) */
+export declare function minimumGradeOf(settings: Record<string, unknown> | undefined): Block | null;
+export declare function registerMessageCheckSettingsTools(server: McpServer, client: ConduytClient): void;
+export {};

package/dist/tools/message-check-settings.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+import { patchGeneralSettingsMerged } from "./lifecycle.js";
+import { strictInput } from "./strict.js";
+/**
+ * Message check minimum grade, #134 groundwork (app 10-10, LIVE 9:19 AM): the admin's lowest acceptable Message check result per
+ * channel, stored in the account settings as settings.messageCheck.minimumGrade. NOTHING enforces it yet (Send stays enabled for
+ * everyone); enabled: true is refused 400 minimum_grade_not_available_yet until the feature is switched on. Owner / admin only:
+ * GET /settings leaves the block out for anyone else and PATCH answers 403 forbidden. No new scope: the existing `settings` scope.
+ */
+export const MINIMUM_GRADE_NOTE = "Groundwork only: the minimum is stored and read back but NOT enforced yet (Send stays enabled for everyone), and enabled: true is refused 400 minimum_grade_not_available_yet until the feature is switched on.";
+export const MinimumGradeChannelValue = z
+    .union([z.enum(["A", "B", "C", "D", "F"]), z.number().int().min(0).max(100), z.null()])
+    .describe("Lowest acceptable result: a grade letter (A, B, C, D, F), a whole score 0-100, or null for no minimum (E, fractions and out-of-range scores are refused 422)");
+const DEFAULT_BLOCK = { enabled: false, channel: { sms: null, email: null }, adminOverride: true };
+/** the stored block with the defaults laid under it field by field (never throws); null when the key's member is not an owner / admin (the API leaves the block out) */
+export function minimumGradeOf(settings) {
+    const mc = settings?.messageCheck;
+    if (!mc || typeof mc !== "object" || Array.isArray(mc))
+        return null;
+    const mg = mc.minimumGrade;
+    const s = mg && typeof mg === "object" && !Array.isArray(mg) ? mg : {};
+    const ch = s.channel && typeof s.channel === "object" && !Array.isArray(s.channel) ? s.channel : {};
+    return {
+        enabled: s.enabled === true,
+        channel: { sms: ch.sms ?? null, email: ch.email ?? null },
+        adminOverride: s.adminOverride === false ? false : true,
+    };
+}
+export function registerMessageCheckSettingsTools(server, client) {
+    server.tool("conduyt_get_message_check_minimum_grade", `Read the admin's Message check minimum grade to send (GET /api/v1/settings, settings.messageCheck.minimumGrade): { data: { minimumGrade: { enabled, channel: { sms, email }, adminOverride } | null, visible, note } }. enabled is the master switch (default false); channel.sms / channel.email is the lowest acceptable result for that channel (a letter A-F, a score 0-100 or null = no minimum); adminOverride says whether an owner or admin may send below it (default true). ${MINIMUM_GRADE_NOTE} Owner / admin only: for any other member the API leaves the block out, so minimumGrade is null and visible false (that is a redaction, not an unset minimum). Requires the settings scope.`, {}, async () => {
+        const result = (await client.get("/api/v1/settings"));
+        const block = minimumGradeOf(result?.data);
+        return formatResult({ data: { minimumGrade: block, visible: block !== null, note: MINIMUM_GRADE_NOTE } });
+    });
+    strictInput(server.tool("conduyt_update_message_check_minimum_grade", `Change the Message check minimum grade to send (PATCH /api/v1/settings, settings.messageCheck.minimumGrade). Pass only what changes; the tool reads the stored block and sends the WHOLE block (the API replaces it) with the settings revision it read; a 409 (another save landed first) re-reads once, then hands back the current settings. smsMinimum / emailMinimum: a letter A-F, a whole score 0-100, or null for no minimum; adminOverride: whether an owner or admin may send below the minimum; enabled: the master switch. ${MINIMUM_GRADE_NOTE} Owner / admin only: a 403 forbidden ('Only an owner or admin can change the Message check minimum grade') is surfaced verbatim, as are 400 minimum_grade_not_available_yet and 422 invalid_body (a partial block, an unknown key, E, a fraction, a score outside 0-100). Requires settings:edit on the key's member AND the owner or admin role. No new scope: the existing settings scope.`, {
+        enabled: z.boolean().optional().describe("Master switch. true is refused 400 minimum_grade_not_available_yet until the feature is switched on"),
+        smsMinimum: MinimumGradeChannelValue.optional().describe("SMS minimum: A-F, 0-100, or null for none"),
+        emailMinimum: MinimumGradeChannelValue.optional().describe("Email minimum: A-F, 0-100, or null for none"),
+        adminOverride: z.boolean().optional().describe("Whether an owner or admin may send below the minimum (default true)"),
+    }, async (params) => {
+        if (params.enabled === undefined && params.smsMinimum === undefined && params.emailMinimum === undefined && params.adminOverride === undefined) {
+            throw new Error("nothing to change: pass at least one of enabled, smsMinimum, emailMinimum, adminOverride");
+        }
+        return patchGeneralSettingsMerged(client, (settings) => {
+            // a member who cannot see the block gets the defaults laid under the change; the API then answers 403 forbidden verbatim
+            const stored = minimumGradeOf(settings) ?? DEFAULT_BLOCK;
+            return {
+                messageCheck: {
+                    minimumGrade: {
+                        enabled: params.enabled ?? stored.enabled,
+                        channel: {
+                            sms: params.smsMinimum === undefined ? stored.channel.sms : params.smsMinimum,
+                            email: params.emailMinimum === undefined ? stored.channel.email : params.emailMinimum,
+                        },
+                        adminOverride: params.adminOverride ?? stored.adminOverride,
+                    },
+                },
+            };
+        });
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.82.0",
+  "version": "4.83.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,6 +1,6 @@
 {
-  "generatedAt": "2026-10-10T01:13:48.576Z",
-  "toolCount": 347,
+  "generatedAt": "2026-10-10T17:00:26.027Z",
+  "toolCount": 349,
   "totalEndpoints": 1077,
   "counts": {
     "covered": 308,
@@ -4031,7 +4031,8 @@
         "conduyt_get_lead_pool_settings",
         "conduyt_update_lead_pool_settings",
         "conduyt_get_lifecycle_settings",
-        "conduyt_update_agent_statuses"
+        "conduyt_update_agent_statuses",
+        "conduyt_get_message_check_minimum_grade"
       ]
     },
     "PATCH /api/v1/settings": {