conduyt-mcp 4.13.0 → 4.14.0

package/dist/index.js

@@ -35,6 +35,7 @@ import { registerDashboardTools } from "./tools/dashboard.js";
 import { registerAiExtendedTools } from "./tools/ai-extended.js";
 import { registerWorkflowSandboxTools } from "./tools/workflow-sandbox.js";
 import { registerPrivacyTools } from "./tools/privacy.js";
+import { registerAccountExportTools } from "./tools/account-exports.js";
 const apiUrl = process.env.CONDUYT_API_URL;
 const apiKey = process.env.CONDUYT_API_KEY;
 if (!apiUrl || !apiKey) {
@@ -92,5 +93,6 @@ registerDashboardTools(server, client);
 registerAiExtendedTools(server, client);
 registerWorkflowSandboxTools(server, client);
 registerPrivacyTools(server, client);
+registerAccountExportTools(server, client);
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/tools/account-exports.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+/**
+ * Scheduled account exports (Enterprise): settings + run history.
+ *
+ * Listing/downloading full-account export files is account-wide PII egress,
+ * so the /account-exports endpoints require the EXPLICIT 'account-exports'
+ * API-key scope (same posture as 'dnc' — an admin must grant it per key; an
+ * unrestricted key does NOT imply it). The settings endpoints ride the
+ * normal 'settings' scope. File BYTES are not fetched through MCP (a 50k-row
+ * CSV does not belong in a tool result) — tools return metadata plus the
+ * authed downloadPath for the API/CLI to retrieve.
+ */
+export declare function registerAccountExportTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/account-exports.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+/**
+ * Scheduled account exports (Enterprise): settings + run history.
+ *
+ * Listing/downloading full-account export files is account-wide PII egress,
+ * so the /account-exports endpoints require the EXPLICIT 'account-exports'
+ * API-key scope (same posture as 'dnc' — an admin must grant it per key; an
+ * unrestricted key does NOT imply it). The settings endpoints ride the
+ * normal 'settings' scope. File BYTES are not fetched through MCP (a 50k-row
+ * CSV does not belong in a tool result) — tools return metadata plus the
+ * authed downloadPath for the API/CLI to retrieve.
+ */
+export function registerAccountExportTools(server, client) {
+    server.tool("conduyt_scheduled_export_get_settings", "Get the account's scheduled-export configuration (enabled, frequency, entities) and whether the Enterprise feature is available on the current plan.", {}, async () => {
+        const result = await client.get("/api/v1/settings/scheduled-export");
+        return formatResult(result);
+    });
+    server.tool("conduyt_scheduled_export_update_settings", "Update scheduled-export settings. Enabling requires an Enterprise plan (403 upsell otherwise). Omitted fields keep their current values. Weekly exports run on Mondays; all exports run in the morning of the account timezone and files are kept 14 days.", {
+        enabled: z.boolean().optional().describe("Turn scheduled exports on/off"),
+        frequency: z.enum(["daily", "weekly"]).optional().describe("How often to export (weekly = Mondays)"),
+        entities: z
+            .array(z.enum(["contacts", "deals", "companies"]))
+            .min(1)
+            .optional()
+            .describe("Which entities to include"),
+    }, async (params) => {
+        const result = await client.patch("/api/v1/settings/scheduled-export", params);
+        return formatResult(result);
+    });
+    server.tool("conduyt_account_exports_list", "List recent scheduled account-export runs with per-file metadata (rows, truncation, size, expiry) and authed downloadPath for each completed file. Requires the explicit 'account-exports' API-key scope. Download the CSV bytes via the API or CLI using downloadPath — not through MCP.", {}, async () => {
+        const result = await client.get("/api/v1/account-exports");
+        return formatResult(result);
+    });
+}

package/package.json

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

package/scripts/coverage-manifest.json

@@ -15,6 +15,11 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    {
+      "match": "GET /api/v1/account-exports/:id/files/:entity/download",
+      "status": "excluded",
+      "reason": "raw CSV bytes (up to 50k rows) do not belong in a tool result; conduyt_account_exports_list returns the authed downloadPath for API/CLI retrieval"
+    },
     {
       "match": "/api/v1/auth/",
       "status": "excluded",

package/scripts/coverage-matrix.json

@@ -1,11 +1,11 @@
 {
-  "generatedAt": "2026-07-11T13:24:45.586Z",
-  "toolCount": 162,
-  "totalEndpoints": 814,
+  "generatedAt": "2026-07-23T16:00:26.290Z",
+  "toolCount": 165,
+  "totalEndpoints": 827,
   "counts": {
-    "covered": 151,
-    "excluded": 232,
-    "planned": 431,
+    "covered": 154,
+    "excluded": 240,
+    "planned": 433,
     "uncategorized": 0
   },
   "matrix": {
@@ -211,6 +211,16 @@
       "status": "excluded",
       "reason": "email open/click tracking pixels and redirects — recipient-facing"
     },
+    "GET /api/v1/account-exports": {
+      "status": "covered",
+      "tools": [
+        "conduyt_account_exports_list"
+      ]
+    },
+    "GET /api/v1/account-exports/:id/files/:entity/download": {
+      "status": "excluded",
+      "reason": "raw CSV bytes (up to 50k rows) do not belong in a tool result; conduyt_account_exports_list returns the authed downloadPath for API/CLI retrieval"
+    },
     "GET /api/v1/account/readiness": {
       "status": "planned",
       "reason": "account readiness/onboarding surfaces"
@@ -1177,6 +1187,10 @@
         "conduyt_export_contact_data"
       ]
     },
+    "GET /api/v1/contacts/:id/gdpr-export/files/:fileId/download": {
+      "status": "planned",
+      "reason": "contact subroutes beyond the core CRUD/search tools"
+    },
     "POST /api/v1/contacts/:id/gdpr-forget": {
       "status": "covered",
       "tools": [
@@ -1399,6 +1413,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/process-external-deletions": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/process-import-side-effects": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1407,6 +1425,10 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/process-outbox": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/process-playbook-steps": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1443,6 +1465,14 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/reconcile-document-sends": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
+    "POST /api/v1/cron/reconcile-document-sends": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/recurring-tasks": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -1479,6 +1509,18 @@
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
     },
+    "GET /api/v1/cron/scheduled-account-exports": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
+    "POST /api/v1/cron/scheduled-account-exports": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
+    "GET /api/v1/cron/seat-threshold-alerts": {
+      "status": "excluded",
+      "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
+    },
     "GET /api/v1/cron/send-scheduled-emails": {
       "status": "excluded",
       "reason": "CRON_SECRET-gated infrastructure jobs; never key-callable"
@@ -2249,6 +2291,10 @@
       "status": "planned",
       "reason": "import job monitoring/resubmission (ai-import tool covers creation)"
     },
+    "POST /api/v1/imports/upload-url": {
+      "status": "planned",
+      "reason": "import job monitoring/resubmission (ai-import tool covers creation)"
+    },
     "GET /api/v1/imports/users": {
       "status": "planned",
       "reason": "import job monitoring/resubmission (ai-import tool covers creation)"
@@ -2997,6 +3043,18 @@
       "status": "planned",
       "reason": "account settings read/update surfaces"
     },
+    "GET /api/v1/settings/scheduled-export": {
+      "status": "covered",
+      "tools": [
+        "conduyt_scheduled_export_get_settings"
+      ]
+    },
+    "PATCH /api/v1/settings/scheduled-export": {
+      "status": "covered",
+      "tools": [
+        "conduyt_scheduled_export_update_settings"
+      ]
+    },
     "GET /api/v1/settings/sms": {
       "status": "planned",
       "reason": "account settings read/update surfaces"