conduyt-mcp 4.1.0

package/.env.example

@@ -0,0 +1,2 @@
+CONDUYT_API_URL=https://conduyt.app
+CONDUYT_API_KEY=cdy_your_key_here

package/README.md

@@ -0,0 +1,286 @@
+# Conduyt MCP Server
+
+MCP server for [Conduyt CRM](https://conduyt.app) — expose your entire CRM as AI-accessible tools.
+
+## 107 Tools
+
+### Discovery
+| Tool | Description |
+|------|-------------|
+| `conduyt_api_catalog` | Discover all 409 API endpoints |
+| `conduyt_check_permissions` | Introspect current API key permissions |
+| `conduyt_search` | Global search across contacts, deals, companies, tasks |
+
+### Contacts
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_contacts` | List and search contacts with filters |
+| `conduyt_get_contact` | Get full contact details with timeline |
+| `conduyt_create_contact` | Create a new contact |
+| `conduyt_update_contact` | Update contact fields |
+| `conduyt_add_tags` | Add tags to a contact |
+
+### Deals
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_deals` | List deals by pipeline, stage, or assignee |
+| `conduyt_get_deal` | Get deal details with history |
+| `conduyt_create_deal` | Create a deal in a pipeline |
+| `conduyt_update_deal` | Move stage, change value, mark won/lost |
+
+### Tasks
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_tasks` | List tasks by assignee, status, due date |
+| `conduyt_create_task` | Create and assign a task |
+
+### Pipelines
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_pipelines` | List pipelines with stages |
+
+### Activities
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_activities` | List recent CRM activities |
+| `conduyt_create_activity` | Log a call, meeting, or note |
+
+### AI
+| Tool | Description |
+|------|-------------|
+| `conduyt_ai_insights` | AI-powered CRM analytics (8 query types) |
+
+### Automations
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_automations` | List all automations with status |
+| `conduyt_get_automation` | Get automation with full action graph |
+| `conduyt_create_automation` | Create a new automation with triggers and actions |
+| `conduyt_update_automation` | Update trigger, actions, or activation status |
+| `conduyt_publish_automation` | Push draft actions to live |
+| `conduyt_resolve_names` | Convert tag/pipeline/user names to UUIDs |
+
+### Workflow Sandbox
+| Tool | Description |
+|------|-------------|
+| `conduyt_workflow_validate` | Validate a workflow graph without saving — returns errors and warnings |
+| `conduyt_workflow_simulate` | Dry-run a workflow against a real or stub contact — step-by-step trace with compliance and provider checks |
+| `conduyt_workflow_promote` | Safely publish a workflow — validates first, refuses if errors exist |
+
+### Email Sequences
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_sequences` | List email sequences with enrollment stats |
+| `conduyt_get_sequence` | Get sequence with steps and stats |
+| `conduyt_create_sequence` | Create a new email sequence with steps |
+| `conduyt_enroll_in_sequence` | Enroll contacts into a sequence |
+| `conduyt_unenroll_from_sequence` | Remove a contact from a sequence |
+
+### Messaging
+| Tool | Description |
+|------|-------------|
+| `conduyt_send_sms` | Send SMS to a contact (max 1600 chars) |
+| `conduyt_send_email` | Send a single email to a contact |
+
+### Companies
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_companies` | List and search companies |
+| `conduyt_get_company` | Get company with contacts and deals |
+| `conduyt_create_company` | Create a new company record |
+| `conduyt_update_company` | Update company details |
+
+### Tags
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_tags` | List all tags with contact counts |
+| `conduyt_create_tag` | Create a new tag |
+| `conduyt_update_tag` | Rename or recolor a tag |
+| `conduyt_delete_tag` | Delete a tag |
+| `conduyt_merge_tags` | Merge two tags (deduplicate) |
+
+### Calendar & Appointments
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_calendars` | List calendars with appointment counts |
+| `conduyt_list_appointments` | List appointments by date, calendar, contact, assignee |
+| `conduyt_get_appointment` | Get appointment with contact and assignee details |
+| `conduyt_create_appointment` | Create an appointment (times require timezone) |
+| `conduyt_update_appointment` | Reschedule, reassign, or cancel |
+
+### Forms
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_forms` | List web forms with submission counts |
+| `conduyt_get_form` | Get form with fields and settings |
+| `conduyt_create_form` | Create a new web form |
+| `conduyt_list_form_submissions` | List submissions for a form |
+
+### Invoices
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_invoices` | List invoices by status, contact, or date |
+| `conduyt_get_invoice` | Get invoice with line items and payments |
+| `conduyt_create_invoice` | Create invoice with line items (auto-calculates totals) |
+| `conduyt_update_invoice` | Update draft invoice items or details |
+| `conduyt_send_invoice` | Send invoice via email with PDF and Stripe payment link |
+
+### Webhooks
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_webhooks` | List registered webhooks |
+| `conduyt_create_webhook` | Register a new webhook (returns signing secret) |
+| `conduyt_update_webhook` | Update URL, events, or enable/disable |
+| `conduyt_delete_webhook` | Delete a webhook endpoint |
+
+### Notifications
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_notifications` | List notifications for current user |
+| `conduyt_create_notification` | Send in-app + push notification to a team member |
+
+### Custom Fields
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_custom_fields` | List custom field definitions (contact/deal) |
+| `conduyt_create_custom_field` | Create a custom field (text, number, date, select, etc.) |
+| `conduyt_update_custom_field` | Update label, options, or required status |
+| `conduyt_delete_custom_field` | Delete a custom field |
+
+### Smart Lists
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_smart_lists` | List all segments with contact counts |
+| `conduyt_get_smart_list` | Get smart list with filters |
+| `conduyt_create_smart_list` | Create static or dynamic smart list |
+| `conduyt_update_smart_list` | Update name, filters, or type |
+| `conduyt_add_contacts_to_smart_list` | Add contacts to a static list (max 500) |
+| `conduyt_get_smart_list_contacts` | Get contacts in a smart list |
+
+### Users & Team
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_users` | List team members with optional stats |
+| `conduyt_get_user` | Get user profile and permissions |
+| `conduyt_create_user` | Create user directly (no invite email) |
+| `conduyt_update_user` | Update profile, role, or permissions |
+| `conduyt_get_user_stats` | Get performance stats (deals, tasks, activity) |
+| `conduyt_invite_user` | Invite team member via email |
+
+### Bulk Operations
+| Tool | Description |
+|------|-------------|
+| `conduyt_ai_import_contacts` | AI-powered bulk import (up to 1000, auto-tag, smart list, automation) |
+| `conduyt_export_contacts` | Export contacts as JSON with filters |
+| `conduyt_export_deals` | Export deals as JSON with filters |
+
+### Drip Campaigns
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_drip_campaigns` | List SMS/email drip campaigns |
+| `conduyt_get_drip_campaign` | Get campaign with steps and provider config |
+| `conduyt_create_drip_campaign` | Create a drip campaign with schedule |
+| `conduyt_update_drip_campaign` | Update campaign settings |
+| `conduyt_list_drip_enrollments` | List enrollments by campaign, contact, status |
+| `conduyt_batch_pause_enrollments` | Pause all active enrollments |
+| `conduyt_batch_resume_enrollments` | Resume paused enrollments |
+| `conduyt_batch_stop_enrollments` | Permanently stop enrollments |
+
+### Lead Scoring
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_scoring_rules` | List scoring rules |
+| `conduyt_create_scoring_rule` | Create a scoring rule |
+| `conduyt_update_scoring_rule` | Update rule name, points, or condition |
+| `conduyt_delete_scoring_rule` | Delete a scoring rule |
+| `conduyt_recalculate_scores` | Recalculate all contact scores |
+
+### Products
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_products` | List product catalog |
+| `conduyt_get_product` | Get product details |
+| `conduyt_create_product` | Create a product |
+| `conduyt_update_product` | Update product pricing or details |
+
+### Templates
+| Tool | Description |
+|------|-------------|
+| `conduyt_list_templates` | List email/SMS templates |
+| `conduyt_get_template` | Get template content |
+| `conduyt_create_template` | Create email or SMS template |
+| `conduyt_update_template` | Update template content |
+
+### Dashboard
+| Tool | Description |
+|------|-------------|
+| `conduyt_dashboard` | Full CRM dashboard (pipeline, activities, metrics, follow-ups) |
+
+### AI Extended
+| Tool | Description |
+|------|-------------|
+| `conduyt_ai_compose_email` | AI-generated email with context-aware tone |
+| `conduyt_ai_enrich_contact` | AI-powered contact data enrichment |
+| `conduyt_ai_summarize_contact` | AI summary with sentiment and next steps |
+
+## Setup
+
+```bash
+npm install
+```
+
+## Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "conduyt": {
+      "command": "npx",
+      "args": ["tsx", "src/index.ts"],
+      "cwd": "/path/to/conduyt-mcp",
+      "env": {
+        "CONDUYT_API_URL": "https://conduyt.app",
+        "CONDUYT_API_KEY": "cdy_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Claude Code
+
+Add to `.mcp.json` or settings:
+
+```json
+{
+  "mcpServers": {
+    "conduyt": {
+      "command": "npx",
+      "args": ["tsx", "/path/to/conduyt-mcp/src/index.ts"],
+      "env": {
+        "CONDUYT_API_URL": "https://conduyt.app",
+        "CONDUYT_API_KEY": "cdy_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Authentication
+
+Generate an API key in Conduyt at **Settings > API Keys**. Keys use the `cdy_` prefix and support three tiers:
+
+- **read** — GET requests only
+- **write** — GET + POST + PATCH
+- **admin** — Full access including DELETE
+
+Scopes can be restricted to specific modules (contacts, deals, tasks, etc.).
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `CONDUYT_API_URL` | Yes | Base URL (e.g. `https://conduyt.app`) |
+| `CONDUYT_API_KEY` | Yes | API key starting with `cdy_` |

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import type { ConduytConfig } from "./types.js";
+export declare class ConduytClient {
+    private baseUrl;
+    private apiKey;
+    constructor(config: ConduytConfig);
+    request(method: string, path: string, body?: unknown): Promise<unknown>;
+    get(path: string): Promise<unknown>;
+    post(path: string, body: unknown): Promise<unknown>;
+    patch(path: string, body: unknown): Promise<unknown>;
+    del(path: string): Promise<unknown>;
+}
+export declare function formatResult(data: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+};

package/dist/client.js

@@ -0,0 +1,43 @@
+export class ConduytClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.apiUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+        const res = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const json = await res.json().catch(() => null);
+        if (!res.ok) {
+            const msg = json?.error || res.statusText;
+            throw new Error(`Conduyt API ${res.status}: ${msg}`);
+        }
+        return json;
+    }
+    get(path) {
+        return this.request("GET", path);
+    }
+    post(path, body) {
+        return this.request("POST", path, body);
+    }
+    patch(path, body) {
+        return this.request("PATCH", path, body);
+    }
+    del(path) {
+        return this.request("DELETE", path);
+    }
+}
+export function formatResult(data) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ConduytClient } from "./client.js";
+import { registerDiscoveryTools } from "./tools/discovery.js";
+import { registerContactTools } from "./tools/contacts.js";
+import { registerDealTools } from "./tools/deals.js";
+import { registerTaskTools } from "./tools/tasks.js";
+import { registerPipelineTools } from "./tools/pipelines.js";
+import { registerActivityTools } from "./tools/activities.js";
+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 { registerCompanyTools } from "./tools/companies.js";
+import { registerTagTools } from "./tools/tags.js";
+import { registerCalendarTools } from "./tools/calendar.js";
+import { registerFormTools } from "./tools/forms.js";
+import { registerInvoiceTools } from "./tools/invoices.js";
+import { registerWebhookTools } from "./tools/webhooks.js";
+import { registerNotificationTools } from "./tools/notifications.js";
+import { registerCustomFieldTools } from "./tools/custom-fields.js";
+import { registerSmartListTools } from "./tools/smart-lists.js";
+import { registerUserTools } from "./tools/users.js";
+import { registerBulkTools } from "./tools/bulk.js";
+import { registerDripCampaignTools } from "./tools/drip-campaigns.js";
+import { registerScoringTools } from "./tools/scoring.js";
+import { registerProductTools } from "./tools/products.js";
+import { registerTemplateTools } from "./tools/templates.js";
+import { registerDashboardTools } from "./tools/dashboard.js";
+import { registerAiExtendedTools } from "./tools/ai-extended.js";
+import { registerWorkflowSandboxTools } from "./tools/workflow-sandbox.js";
+const apiUrl = process.env.CONDUYT_API_URL;
+const apiKey = process.env.CONDUYT_API_KEY;
+if (!apiUrl || !apiKey) {
+    console.error("Missing required environment variables:\n" +
+        "  CONDUYT_API_URL — Base URL (e.g. https://conduyt.app)\n" +
+        "  CONDUYT_API_KEY — API key with cdy_ prefix\n");
+    process.exit(1);
+}
+if (!apiKey.startsWith("cdy_")) {
+    console.error("CONDUYT_API_KEY must start with 'cdy_' — generate one at Settings > API Keys in Conduyt.");
+    process.exit(1);
+}
+const client = new ConduytClient({ apiUrl, apiKey });
+const server = new McpServer({
+    name: "conduyt",
+    version: "4.1.0",
+});
+registerDiscoveryTools(server, client);
+registerContactTools(server, client);
+registerDealTools(server, client);
+registerTaskTools(server, client);
+registerPipelineTools(server, client);
+registerActivityTools(server, client);
+registerAiTools(server, client);
+registerAutomationTools(server, client);
+registerSequenceTools(server, client);
+registerMessagingTools(server, client);
+registerCompanyTools(server, client);
+registerTagTools(server, client);
+registerCalendarTools(server, client);
+registerFormTools(server, client);
+registerInvoiceTools(server, client);
+registerWebhookTools(server, client);
+registerNotificationTools(server, client);
+registerCustomFieldTools(server, client);
+registerSmartListTools(server, client);
+registerUserTools(server, client);
+registerBulkTools(server, client);
+registerDripCampaignTools(server, client);
+registerScoringTools(server, client);
+registerProductTools(server, client);
+registerTemplateTools(server, client);
+registerDashboardTools(server, client);
+registerAiExtendedTools(server, client);
+registerWorkflowSandboxTools(server, client);
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/tools/activities.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+export declare function registerActivityTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/activities.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+export function registerActivityTools(server, client) {
+    server.tool("conduyt_list_activities", "List recent activities across the CRM — calls, emails, notes, meetings, deal changes, and system events.", {
+        userId: z.string().optional().describe("Filter by user UUID who performed the activity"),
+        type: z.string().optional().describe("Filter by activity type (e.g. 'call', 'email', 'note', 'meeting', 'deal_stage_changed')"),
+        contactId: z.string().optional().describe("Filter activities for a specific contact"),
+        page: z.number().optional().describe("Page number (default 1)"),
+        per_page: z.number().optional().describe("Results per page (default 25, max 100)"),
+    }, async ({ userId, type, contactId, page, per_page }) => {
+        const params = new URLSearchParams();
+        if (userId)
+            params.set("userId", userId);
+        if (type)
+            params.set("type", type);
+        if (contactId)
+            params.set("contactId", contactId);
+        if (page)
+            params.set("page", String(page));
+        if (per_page)
+            params.set("per_page", String(per_page));
+        const result = await client.get(`/api/v1/activities?${params}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_create_activity", "Log a new activity — a call, meeting, note, or custom event. Can be linked to a contact.", {
+        type: z.string().describe("Activity type: 'call', 'email', 'note', 'meeting', or custom"),
+        title: z.string().describe("Activity title/summary"),
+        description: z.string().optional().describe("Detailed notes about the activity"),
+        contactId: z.string().optional().describe("Link to a contact UUID"),
+        dealId: z.string().optional().describe("Link to a deal UUID"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/activities", params);
+        return formatResult(result);
+    });
+}

package/dist/tools/ai-extended.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+export declare function registerAiExtendedTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/ai-extended.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+export function registerAiExtendedTools(server, client) {
+    server.tool("conduyt_ai_compose_email", "AI-powered email composition. Generates subject, body, and HTML based on contact context, deal stage, and desired tone.", {
+        contactName: z.string().describe("Recipient's name"),
+        purpose: z.string().describe("Email purpose (e.g. 'follow up on demo', 'send proposal', 'check in after purchase')"),
+        senderName: z.string().describe("Your name as the sender"),
+        companyName: z.string().describe("Your company name"),
+        contactEmail: z.string().optional().describe("Recipient's email"),
+        contactCompany: z.string().optional().describe("Recipient's company"),
+        contactTitle: z.string().optional().describe("Recipient's job title"),
+        dealStage: z.string().optional().describe("Current deal stage for context"),
+        dealValue: z.number().optional().describe("Deal value for context"),
+        previousMessages: z.string().optional().describe("Summary of previous conversation for context"),
+        tone: z.string().optional().describe("Desired tone (e.g. 'professional', 'friendly', 'urgent')"),
+        senderTitle: z.string().optional().describe("Your job title"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/ai/compose-email", params);
+        return formatResult(result);
+    });
+    server.tool("conduyt_ai_enrich_contact", "AI-powered contact enrichment. Finds additional information about a person based on available details. Returns enriched fields like LinkedIn, Twitter, company, and job title.", {
+        email: z.string().optional().describe("Contact email to research"),
+        firstName: z.string().optional().describe("First name"),
+        lastName: z.string().optional().describe("Last name"),
+        company: z.string().optional().describe("Company name"),
+        jobTitle: z.string().optional().describe("Job title"),
+        phone: z.string().optional().describe("Phone number"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/ai/enrich-contact", params);
+        return formatResult(result);
+    });
+    server.tool("conduyt_ai_summarize_contact", "AI-powered contact summary. Analyzes all interactions, deals, and activities to generate a summary with sentiment, key topics, and recommended next steps.", {
+        contactId: z.string().describe("Contact UUID to summarize"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/ai/summarize-contact", params);
+        return formatResult(result);
+    });
+}

package/dist/tools/ai.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+export declare function registerAiTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/ai.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+export function registerAiTools(server, client) {
+    server.tool("conduyt_ai_insights", "Query AI-powered CRM insights. 8 query types available: pipeline_health (deals per stage, stale deals), sms_drip_status (SMS drip overview by provider/step), sms_responses_untouched (replied contacts with no follow-up), agent_followups (per-agent task performance), email_performance (open/click/reply rates), smart_view_summary (contact counts per saved view), team_activity (per-user activity counts), contact_import_history (recent import batches).", {
+        type: z.enum([
+            "pipeline_health",
+            "sms_drip_status",
+            "sms_responses_untouched",
+            "agent_followups",
+            "email_performance",
+            "smart_view_summary",
+            "team_activity",
+            "contact_import_history",
+        ]).describe("Insight query type"),
+        days: z.number().optional().describe("Lookback period in days (default varies by type)"),
+        pipelineId: z.string().optional().describe("Pipeline UUID (for pipeline_health)"),
+        userId: z.string().optional().describe("User UUID (for agent_followups)"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/ai/insights", params);
+        return formatResult(result);
+    });
+}

package/dist/tools/automations.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+export declare function registerAutomationTools(server: McpServer, client: ConduytClient): void;

package/dist/tools/automations.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { formatResult } from "../client.js";
+export function registerAutomationTools(server, client) {
+    server.tool("conduyt_list_automations", "List all automations (workflows) in the account. Returns name, trigger event, status, and execution counts.", {
+        page: z.number().optional().describe("Page number (default 1)"),
+        per_page: z.number().optional().describe("Results per page (default 25, max 100)"),
+    }, async ({ page, per_page }) => {
+        const params = new URLSearchParams();
+        if (page)
+            params.set("page", String(page));
+        if (per_page)
+            params.set("per_page", String(per_page));
+        const result = await client.get(`/api/v1/automations?${params}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_get_automation", "Get a single automation with full details — trigger, actions graph, schedule, and execution stats.", {
+        id: z.string().describe("Automation UUID"),
+    }, async ({ id }) => {
+        const result = await client.get(`/api/v1/automations/${id}`);
+        return formatResult(result);
+    });
+    server.tool("conduyt_create_automation", "Create a new automation. Requires a name and trigger event. Use conduyt_resolve_names to convert human-readable names to UUIDs before building actions.", {
+        name: z.string().describe("Automation name"),
+        description: z.string().optional().describe("Description of what this automation does"),
+        triggerEvent: z.string().describe("Trigger event (e.g. 'contact.created', 'deal.stage_changed', 'tag.added', 'scheduled')"),
+        kind: z.enum(["native", "n8n"]).optional().describe("Automation type — 'native' for built-in graph engine, 'n8n' for n8n webhook (default: 'n8n')"),
+        actions: z.any().optional().describe("Actions graph — v1: [{type, config}], v2: {nodes:[], startNodeId}"),
+        graphVersion: z.number().optional().describe("Graph version — 1 (legacy array) or 2 (node graph). Default 1"),
+        schedule: z.string().optional().describe("5-field cron expression (required if triggerEvent='scheduled')"),
+        scheduleTimezone: z.string().optional().describe("IANA timezone for scheduled triggers (e.g. 'America/Los_Angeles')"),
+        triggerConditions: z.any().optional().describe("Conditions that must match for the trigger to fire"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/automations", params);
+        return formatResult(result);
+    });
+    server.tool("conduyt_update_automation", "Update an existing automation — change trigger, actions, schedule, or activation status.", {
+        id: z.string().describe("Automation UUID"),
+        name: z.string().optional().describe("Updated name"),
+        description: z.string().optional().describe("Updated description"),
+        triggerEvent: z.string().optional().describe("Updated trigger event"),
+        isActive: z.boolean().optional().describe("Enable or disable the automation"),
+        actions: z.any().optional().describe("Updated actions graph"),
+        schedule: z.string().optional().describe("Updated cron schedule"),
+        scheduleTimezone: z.string().optional().describe("Updated timezone"),
+        stopOnResponse: z.boolean().optional().describe("Stop drip if contact responds"),
+    }, async ({ id, ...updates }) => {
+        const result = await client.patch(`/api/v1/automations/${id}`, updates);
+        return formatResult(result);
+    });
+    server.tool("conduyt_publish_automation", "Publish an automation — copies the draft actions to the live published version. The automation must have actions defined.", {
+        id: z.string().describe("Automation UUID"),
+    }, async ({ id }) => {
+        const result = await client.post(`/api/v1/automations/${id}/publish`, {});
+        return formatResult(result);
+    });
+    server.tool("conduyt_resolve_names", "Resolve human-readable names to UUIDs. Use this before creating automations — converts tag names, pipeline names, user names, and custom field labels to their UUIDs.", {
+        tags: z.array(z.string()).optional().describe("Tag names to resolve (e.g. ['new-lead', 'hot'])"),
+        pipelines: z.array(z.string()).optional().describe("Pipeline names to resolve (e.g. ['Sales Pipeline'])"),
+        stages: z.array(z.string()).optional().describe("Stage names to resolve (e.g. ['New Lead', 'Qualified'])"),
+        users: z.array(z.string()).optional().describe("User full names or emails to resolve"),
+        customFields: z.array(z.string()).optional().describe("Custom field keys or labels to resolve"),
+    }, async (params) => {
+        const result = await client.post("/api/v1/automations/resolve", params);
+        return formatResult(result);
+    });
+}

package/dist/tools/bulk.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ConduytClient } from "../client.js";
+export declare function registerBulkTools(server: McpServer, client: ConduytClient): void;