conduyt-mcp 4.50.0 → 4.52.0

package/README.md

@@ -86,7 +86,8 @@ MCP server for [Conduyt CRM](https://conduyt.app) — expose your CRM as AI-acce
 ### Messaging
 | Tool | Description |
 |------|-------------|
-| `conduyt_sms_transports` | What a workflow Send SMS step can speak through today: Twilio numbers, Project Blue lines held by active reps, the WhatsApp sender, webhook provider count, FromK.ai coming soon |
+| `conduyt_sms_transports` | What a workflow Send SMS step can speak through today: Twilio numbers, Project Blue lines held by active reps, the WhatsApp sender, the Voicemail Drop recordings, webhook provider count, FromK.ai coming soon |
+| `conduyt_voice_drop` | Place a voice drop to a contact: an outbound Twilio call with answering-machine detection that plays a Voicemail Drop recording to a machine (hangs up on a person unless onHuman is play); governed like a call (calls-tier consent, calling hours, one live call per lead) |
 | `conduyt_whatsapp_templates` | The account's WhatsApp templates (Twilio Content) with Meta's approval verdict: sid, text with {{n}} placeholders, variables, approval |
 | `conduyt_send_sms` | Send SMS to a contact (max 1600 chars); transport twilio, project_blue, or whatsapp (an approved template by Content SID, or free-form within the 24-hour window) |
 | `conduyt_send_email` | Send a single email to a contact |

package/dist/index.js

@@ -42,6 +42,7 @@ import { registerReplyCaptureTools } from "./tools/reply-capture.js";
 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 { registerReportTools } from "./tools/reports.js";
 import { registerReportDashboardTools } from "./tools/dashboards.js";
 const apiUrl = process.env.CONDUYT_API_URL;
@@ -108,6 +109,7 @@ registerReplyCaptureTools(server, client);
 registerCallFlowTools(server, client);
 registerProjectBlueTools(server, client);
 registerWhatsappTools(server, client);
+registerFromkTools(server, client);
 registerReportTools(server, client);
 registerReportDashboardTools(server, client);
 const transport = new StdioServerTransport();

package/dist/tools/fromk.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+/**
+ * FromK.ai (2026-09-14): Conduyt's own texting platform as a native SMS transport. The tenant's FromK.ai workspace
+ * texts (its lines, its credits, its consent and STOP rules); Conduyt drives it with the workspace's API key. These
+ * tools cover what an AI operator needs: is it connected, which lines are send-ready (the fromkPhoneNumberId a step or
+ * conduyt_send_sms picks), refreshing that list, connecting or replacing the key, storing the webhook signing secret,
+ * and disconnecting.
+ */
+export declare function registerFromkTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/fromk.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+/**
+ * FromK.ai (2026-09-14): Conduyt's own texting platform as a native SMS transport. The tenant's FromK.ai workspace
+ * texts (its lines, its credits, its consent and STOP rules); Conduyt drives it with the workspace's API key. These
+ * tools cover what an AI operator needs: is it connected, which lines are send-ready (the fromkPhoneNumberId a step or
+ * conduyt_send_sms picks), refreshing that list, connecting or replacing the key, storing the webhook signing secret,
+ * and disconnecting.
+ */
+export function registerFromkTools(server, client) {
+    server.tool("conduyt_fromk_status", "FromK.ai connection for this account (GET /api/v1/settings/fromk): status connected | not_configured, the API key masked, the lines snapshot (phoneNumberId, phoneE164, status, provider, sendReady) and the webhook setup (the URL the tenant pastes into FromK.ai → Developers → Webhooks, whether the signing secret is stored, the events to subscribe). Requires settings:view.", {}, async () => {
+        const result = await client.get("/api/v1/settings/fromk");
+        return formatResult(result);
+    });
+    server.tool("conduyt_fromk_lines", "Refresh the FromK.ai line list from the workspace with the stored key and store it as the new snapshot (GET /api/v1/settings/fromk/lines): every line with sendReady (assigned, ownership verified, SMS-capable, on a real carrier). A send-ready phoneNumberId is a valid send_sms config.fromkPhoneNumberId / conduyt_send_sms fromkPhoneNumberId. 409 fromk_not_configured, 422 key_revoked, 502 vendor_unavailable (the old snapshot is kept). Requires settings:view.", {}, async () => {
+        const result = await client.get("/api/v1/settings/fromk/lines");
+        return formatResult(result);
+    });
+    server.tool("conduyt_fromk_connect", "Connect or replace the account's FromK.ai workspace API key (PUT /api/v1/settings/fromk): fk_… with numbers:read, contacts:write and messages:send. Verified with FromK.ai before it is stored (it must list the workspace's lines: 422 key_rejected / key_scope, 502 vendor_unavailable, nothing stored). Pass disconnect: true to forget the key, the signing secret, the lines and every contact link instead (DELETE): workflow steps on the FromK.ai channel stop sending. Requires settings:edit.", {
+        apiKey: z.string().min(24).max(200).optional().describe("FromK.ai workspace API key (fk_…); required unless disconnect is true"),
+        disconnect: z.boolean().optional().describe("true = forget everything FromK.ai (DELETE)"),
+    }, async ({ apiKey, disconnect }) => {
+        if (disconnect) {
+            const result = await client.del("/api/v1/settings/fromk");
+            return formatResult(result);
+        }
+        if (!apiKey)
+            throw new Error("apiKey is required unless disconnect is true");
+        const result = await client.put("/api/v1/settings/fromk", { apiKey });
+        return formatResult(result);
+    });
+    server.tool("conduyt_fromk_webhook_secret", "Store (PUT /api/v1/settings/fromk/webhook) or forget (DELETE, clear: true) the signing secret of the FromK.ai webhook endpoint the tenant pointed at Conduyt (whsec_…, shown once by FromK.ai when the endpoint is created). Until it is stored, FromK.ai replies and delivery reports are refused. 409 fromk_not_configured before the key is connected. Requires settings:edit.", {
+        secret: z.string().regex(/^whsec_[A-Za-z0-9_-]{16,}$/).optional().describe("the endpoint's signing secret; required unless clear is true"),
+        clear: z.boolean().optional().describe("true = forget the stored secret (DELETE)"),
+    }, async ({ secret, clear }) => {
+        if (clear) {
+            const result = await client.del("/api/v1/settings/fromk/webhook");
+            return formatResult(result);
+        }
+        if (!secret)
+            throw new Error("secret is required unless clear is true");
+        const result = await client.put("/api/v1/settings/fromk/webhook", { secret });
+        return formatResult(result);
+    });
+}

package/dist/tools/messaging.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { formatResult } from "../client.js";
 export function registerMessagingTools(server, client) {
-    server.tool("conduyt_sms_transports", "What a workflow Send SMS step can speak through TODAY (GET /api/v1/sms/transports): twilio {connected, numbers[] = the account number + every active rep's assigned line, each a valid send_sms config.fromNumber}, projectBlue {connected, lines[] = Project Blue iPhone lines held by active reps, each lineId a valid config.projectBlueLineId for smsMode project_blue}, whatsapp {connected, sender = the account's WhatsApp sender for smsMode whatsapp; templates come from conduyt_whatsapp_templates}, webhook {providers = active webhook providers for smsMode webhook}, fromk {status: coming_soon}. Use it before building or editing a send_sms step so you never configure a transport that is not connected. Requires automations:view.", {}, async () => {
+    server.tool("conduyt_sms_transports", "What a workflow Send SMS step can speak through TODAY (GET /api/v1/sms/transports): twilio {connected, numbers[] = the account number + every active rep's assigned line, each a valid send_sms config.fromNumber}, projectBlue {connected, lines[] = Project Blue iPhone lines held by active reps, each lineId a valid config.projectBlueLineId for smsMode project_blue}, whatsapp {connected, sender = the account's WhatsApp sender for smsMode whatsapp; templates come from conduyt_whatsapp_templates}, voiceDrop {connected = Twilio is connected, recordings {hasDefault, templates[] = names valid as config.voiceDropRecording for smsMode voice_drop}}, webhook {providers = active webhook providers for smsMode webhook}, fromk {status connected | setup, connected, lines[] = the FromK.ai workspace's send-ready lines, each phoneNumberId a valid config.fromkPhoneNumberId for smsMode fromk}. Use it before building or editing a send_sms step so you never configure a transport that is not connected. Requires automations:view.", {}, async () => {
         const result = await client.get("/api/v1/sms/transports");
         return formatResult(result);
     });
@@ -9,11 +9,21 @@ export function registerMessagingTools(server, client) {
         const result = await client.get("/api/v1/sms/whatsapp/templates");
         return formatResult(result);
     });
+    server.tool("conduyt_voice_drop", "Place a voice drop to a contact (POST /api/v1/calls/voice-drop): an outbound Twilio call with answering-machine detection that plays one of the account's Voicemail Drop recordings (Settings → Twilio → Voicemail Drop; names from conduyt_sms_transports voiceDrop.recordings) when a machine answers, and hangs up quietly when a person answers unless onHuman is play. Governed like a call: calls-tier consent (a texting STOP does not block it, a DNC or litigator row does), the account's calling hours, one live call per lead. Placed from your own Twilio line (else the account number) unless fromNumber names a number the account owns. Returns 202 with the Call row; the outcome lands on it through the voice webhooks (disposition voicemail_drop = played to a machine, voice_drop_human = a person answered, voice_drop_live = played to a person, voice_drop_fax; status no-answer/busy when nobody picked up). Refusals carry a code (dnc, litigator, calling_window, active_call, missing_phone, voice_drop_recording_missing, voice_drop_not_configured); 429 and 502 are safe to retry. Requires dialer:create.", {
+        contactId: z.string().uuid().describe("Contact UUID — the drop calls the contact's primary number"),
+        recording: z.string().min(1).max(100).optional().describe("A Voicemail Drop template name (see conduyt_sms_transports voiceDrop.recordings.templates); omit for the default recording"),
+        fromNumber: z.string().regex(/^\+[1-9]\d{6,14}$/).optional().describe("Caller ID the account owns (the account number or an active rep's line, E.164); omit for your own line"),
+        onHuman: z.enum(["hang_up", "play"]).optional().describe("When a person answers: hang_up (default) ends the call quietly; play plays the recording anyway"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/calls/voice-drop", params);
+        return formatResult(result);
+    });
     server.tool("conduyt_send_sms", "Send an SMS message to a contact. Contact must have a phone number and not have opted out. Max 1600 characters.", {
         contactId: z.string().describe("Contact UUID — must have a phone number on file"),
         body: z.string().max(1600).optional().describe("Message text (max 1600 characters). Required unless a WhatsApp template is sent (transport whatsapp + whatsappContentSid): then the template Twilio renders is the text, and a media-only template has none."),
         fromNumber: z.string().optional().describe("Sender phone number (defaults to account's primary number)"),
-        transport: z.enum(["twilio", "project_blue", "whatsapp"]).optional().describe("'project_blue' sends from the acting user's own Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise; the user must have a line assigned in Settings → Project Blue). 'whatsapp' sends from the account's WhatsApp sender (Settings → WhatsApp): free-form text only within 24 hours of the contact's last WhatsApp message (422 whatsapp_window_closed otherwise), or an approved template via whatsappContentSid. Default: Twilio."),
+        transport: z.enum(["twilio", "project_blue", "whatsapp", "fromk"]).optional().describe("'project_blue' sends from the acting user's own Project Blue iPhone line (iMessage when the lead is on Apple, SMS otherwise; the user must have a line assigned in Settings → Project Blue). 'whatsapp' sends from the account's WhatsApp sender (Settings → WhatsApp): free-form text only within 24 hours of the contact's last WhatsApp message (422 whatsapp_window_closed otherwise), or an approved template via whatsappContentSid. 'fromk' sends through the account's FromK.ai workspace (Settings → FromK.ai) from fromkPhoneNumberId, else the workspace's single send-ready line (422 fromk_line_required with several). Default: Twilio."),
+        fromkPhoneNumberId: z.string().uuid().optional().describe("transport fromk: the FromK.ai line to send from (a send-ready phoneNumberId from conduyt_fromk_status / conduyt_sms_transports fromk.lines); omit when the workspace has one send-ready line"),
         whatsappContentSid: z.string().regex(/^HX[0-9a-fA-F]{32}$/).optional().describe("transport whatsapp: an APPROVED WhatsApp template (Twilio Content SID from conduyt_whatsapp_templates); Conduyt reads the template from Twilio at send time, records its text with the variables in place, and refuses an unlisted (whatsapp_template_invalid) or unapproved (whatsapp_template_not_approved) one. body is still required but the template's text is what is sent and recorded."),
         whatsappContentVariables: z.record(z.string().regex(/^\d+$/), z.string().max(1024)).optional().describe("transport whatsapp with a template: placeholder number → value, e.g. { \"1\": \"Alex\" }"),
         idempotencyKey: z.string().min(8).max(200).optional().describe("Operation key for at-most-once sends: reuse the SAME key when retrying a send whose outcome you did not see; a settled key answers with the original message and never sends twice."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "conduyt-mcp",
-  "version": "4.50.0",
+  "version": "4.52.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,10 +1,10 @@
 {
-  "generatedAt": "2026-09-11T21:39:51.508Z",
-  "toolCount": 255,
-  "totalEndpoints": 963,
+  "generatedAt": "2026-09-14T15:23:41.003Z",
+  "toolCount": 260,
+  "totalEndpoints": 972,
   "counts": {
-    "covered": 238,
-    "excluded": 284,
+    "covered": 245,
+    "excluded": 286,
     "planned": 441,
     "uncategorized": 0
   },
@@ -1154,6 +1154,12 @@
       "status": "planned",
       "reason": "call subroutes beyond list/log"
     },
+    "POST /api/v1/calls/voice-drop": {
+      "status": "covered",
+      "tools": [
+        "conduyt_voice_drop"
+      ]
+    },
     "GET /api/v1/chat/channels": {
       "status": "planned",
       "reason": "team chat read/post for agents"
@@ -3617,6 +3623,42 @@
       "status": "planned",
       "reason": "account settings read/update surfaces"
     },
+    "GET /api/v1/settings/fromk": {
+      "status": "covered",
+      "tools": [
+        "conduyt_fromk_status"
+      ]
+    },
+    "PUT /api/v1/settings/fromk": {
+      "status": "covered",
+      "tools": [
+        "conduyt_fromk_connect"
+      ]
+    },
+    "DELETE /api/v1/settings/fromk": {
+      "status": "covered",
+      "tools": [
+        "conduyt_fromk_connect"
+      ]
+    },
+    "GET /api/v1/settings/fromk/lines": {
+      "status": "covered",
+      "tools": [
+        "conduyt_fromk_lines"
+      ]
+    },
+    "PUT /api/v1/settings/fromk/webhook": {
+      "status": "covered",
+      "tools": [
+        "conduyt_fromk_webhook_secret"
+      ]
+    },
+    "DELETE /api/v1/settings/fromk/webhook": {
+      "status": "covered",
+      "tools": [
+        "conduyt_fromk_webhook_secret"
+      ]
+    },
     "POST /api/v1/settings/integrations/:id/test": {
       "status": "planned",
       "reason": "account settings read/update surfaces"
@@ -4240,6 +4282,10 @@
       "status": "planned",
       "reason": "outbound webhook delivery replay — agent-relevant"
     },
+    "POST /api/v1/webhooks/sms/fromk/:accountId": {
+      "status": "excluded",
+      "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
+    },
     "POST /api/v1/webhooks/sms/inbound": {
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
@@ -4300,6 +4346,10 @@
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
     },
+    "POST /api/v1/webhooks/voice/voice-drop": {
+      "status": "excluded",
+      "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"
+    },
     "POST /api/v1/webhooks/voice/voicemail": {
       "status": "excluded",
       "reason": "inbound provider callback receivers (Twilio/Resend/etc.), not client-callable"