conduyt-mcp 4.51.0 → 4.52.0

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}, 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: 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);
     });
@@ -22,7 +22,8 @@ export function registerMessagingTools(server, client) {
         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.51.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-11T22:38:09.066Z",
-  "toolCount": 256,
-  "totalEndpoints": 965,
+  "generatedAt": "2026-09-14T15:23:41.003Z",
+  "toolCount": 260,
+  "totalEndpoints": 972,
   "counts": {
-    "covered": 239,
-    "excluded": 285,
+    "covered": 245,
+    "excluded": 286,
     "planned": 441,
     "uncategorized": 0
   },
@@ -3623,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"
@@ -4246,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"