@omnifox/mcp-server 0.2.0

package/dist/tools/conversations.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Conversation tools — listing, assignment, status, snooze and follow-up.
+ *
+ * Two shapes exist for the same idea and they are NOT interchangeable:
+ * contact-scoped helpers act on the contact's currently open conversation,
+ * while the `/conversations/{id}` routes act on a conversation you already
+ * know the id of. Both are exposed, because an agent usually knows one or the
+ * other, never both.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OmnifoxClient } from "../omnifox/client.js";
+export declare function registerConversationTools(server: McpServer, client: OmnifoxClient): void;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/tools/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/tools/conversations.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU1D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA8IxF"}

package/dist/tools/conversations.js

@@ -0,0 +1,91 @@
+/**
+ * Conversation tools — listing, assignment, status, snooze and follow-up.
+ *
+ * Two shapes exist for the same idea and they are NOT interchangeable:
+ * contact-scoped helpers act on the contact's currently open conversation,
+ * while the `/conversations/{id}` routes act on a conversation you already
+ * know the id of. Both are exposed, because an agent usually knows one or the
+ * other, never both.
+ */
+import { z } from "zod";
+const ok = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+const conversationId = z
+    .union([z.number().int().positive(), z.string().regex(/^\d+$/)])
+    .describe("Numeric id of the conversation.");
+export function registerConversationTools(server, client) {
+    server.tool("list_conversations", "List the conversations of the workspace, most recently updated first. Filter by status to find what needs attention.", {
+        status: z
+            .enum(["open", "pending", "resolved", "closed", "snoozed"])
+            .optional()
+            .describe("Filter by lifecycle status."),
+        channel_id: z.number().int().optional(),
+        tag_id: z.number().int().optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ status, channel_id, tag_id, limit, page }) => ok(await client.get("/conversations", client.buildListQuery({ limit, page, extra: { status, channel_id, tag_id } }))));
+    server.tool("get_conversation", "Fetch one conversation with its contact, channel, status and assignment. Start here when you have an id and need context before acting.", { id: conversationId }, async ({ id }) => ok(await client.get(`/conversations/${encodeURIComponent(String(id))}`)));
+    server.tool("assign_conversation", "Assign a conversation to a user, a team or an AI agent — or unassign it.", {
+        id: conversationId,
+        assignee_type: z
+            .enum(["user", "team", "ai_agent", "none"])
+            .describe("Use 'none' to unassign."),
+        assignee_id: z
+            .number()
+            .int()
+            .optional()
+            .describe("Id of the user / team / AI agent. Omit when assignee_type is 'none'."),
+    }, async ({ id, assignee_type, assignee_id }) => ok(await client.post(`/conversations/${encodeURIComponent(String(id))}/assign`, {
+        assignee_type,
+        ...(assignee_id !== undefined ? { assignee_id } : {}),
+    })));
+    server.tool("assign_contact_conversation", "Assign the contact's currently OPEN conversation. Use this when you know the contact but not the conversation id.", {
+        identifier: z.string().min(1).describe("Contact id or kind:value selector."),
+        assignee: z
+            .union([z.number().int(), z.string()])
+            .nullable()
+            .describe("User id, user email, or 'team:<id>' to route to a team. Pass null to unassign."),
+    }, async ({ identifier, assignee }) => ok(await client.post(`/contacts/${encodeURIComponent(identifier)}/assignee`, { assignee })));
+    server.tool("update_conversation_status", "Reopen, resolve or close a conversation. Closing accepts a resolution label and free-text notes that stay in the thread.", {
+        id: conversationId,
+        status: z.enum(["open", "resolved", "closed"]),
+        resolution: z.string().max(255).optional().describe("Short label stored on close."),
+        notes: z.string().max(5000).optional().describe("Free-text closing notes."),
+    }, async ({ id, status, resolution, notes }) => {
+        const path = status === "open" ? "reopen" : status === "resolved" ? "resolve" : "close";
+        const body = status === "closed"
+            ? {
+                ...(resolution !== undefined ? { resolution } : {}),
+                ...(notes !== undefined ? { notes } : {}),
+            }
+            : undefined;
+        return ok(await client.post(`/conversations/${encodeURIComponent(String(id))}/${path}`, body));
+    });
+    server.tool("update_contact_conversation_status", "Set the status of the contact's open conversation when you only know the contact.", {
+        identifier: z.string().min(1).describe("Contact id or kind:value selector."),
+        status: z.enum(["open", "close", "closed", "resolved"]),
+        category: z.string().max(64).optional(),
+        summary: z.string().max(1000).optional(),
+    }, async ({ identifier, status, category, summary }) => ok(await client.post(`/contacts/${encodeURIComponent(identifier)}/conversation/status`, {
+        status,
+        ...(category !== undefined ? { category } : {}),
+        ...(summary !== undefined ? { summary } : {}),
+    })));
+    server.tool("snooze_conversation", "Snooze a conversation so it leaves the queue and comes back later. Use it instead of closing when a follow-up is due.", {
+        id: conversationId,
+        preset: z
+            .enum(["1h", "3h", "tomorrow", "next_week"])
+            .optional()
+            .describe("Relative snooze. Give this OR snoozed_until."),
+        snoozed_until: z
+            .string()
+            .optional()
+            .describe("Absolute ISO-8601 moment to wake the conversation at."),
+    }, async ({ id, preset, snoozed_until }) => ok(await client.post(`/conversations/${encodeURIComponent(String(id))}/snooze`, {
+        ...(preset ? { preset } : {}),
+        ...(snoozed_until ? { snoozed_until } : {}),
+    })));
+    server.tool("list_conversation_notes", "List the internal notes on a conversation — teammate-only context the customer never saw.", { id: conversationId }, async ({ id }) => ok(await client.get(`/conversations/${encodeURIComponent(String(id))}/notes`)));
+}
+//# sourceMappingURL=conversations.js.map

package/dist/tools/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/tools/conversations.ts"],"names":[],"mappings":"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"}

package/dist/tools/extras.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The rest of the platform: workflows, broadcasts, webhooks and workspaces.
+ *
+ * 0.1.0 shipped four tools here that could not work — two hitting
+ * `/lifecycle-stages`, which is not a route the API has, one hitting
+ * `/channels/{id}/profile`, likewise absent, and a workflow trigger whose body
+ * the engine ignored. They are gone or corrected.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OmnifoxClient } from "../omnifox/client.js";
+export declare function registerExtraTools(server: McpServer, client: OmnifoxClient): void;
+//# sourceMappingURL=extras.d.ts.map

package/dist/tools/extras.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extras.d.ts","sourceRoot":"","sources":["../../src/tools/extras.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAW1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAqKjF"}

package/dist/tools/extras.js

@@ -0,0 +1,105 @@
+/**
+ * The rest of the platform: workflows, broadcasts, webhooks and workspaces.
+ *
+ * 0.1.0 shipped four tools here that could not work — two hitting
+ * `/lifecycle-stages`, which is not a route the API has, one hitting
+ * `/channels/{id}/profile`, likewise absent, and a workflow trigger whose body
+ * the engine ignored. They are gone or corrected.
+ */
+import { z } from "zod";
+const ok = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+const numericId = (what) => z
+    .union([z.number().int().positive(), z.string().regex(/^\d+$/)])
+    .describe(`Numeric id of the ${what}.`);
+export function registerExtraTools(server, client) {
+    // ---------- Workflows ----------
+    server.tool("list_workflows", "List the automation workflows of the workspace, with whether each one is currently active.", {
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ limit, page }) => ok(await client.get("/workflows", client.buildListQuery({ limit, page }))));
+    server.tool("trigger_workflow", "Run a workflow now. Whatever you pass as `context` is the trigger data its nodes read.", {
+        workflowId: numericId("workflow"),
+        context: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Trigger payload, e.g. { \"conversation_id\": 42 }."),
+        force: z
+            .boolean()
+            .optional()
+            .describe("Run even if the workflow is inactive. Without this an inactive one is refused."),
+    }, async ({ workflowId, context, force }) => ok(await client.post(`/workflows/${encodeURIComponent(String(workflowId))}/trigger`, {
+        context: context ?? {},
+        ...(force ? { force: true } : {}),
+    })));
+    server.tool("set_workflow_active", "Activate or deactivate a workflow. A workflow with no trigger node and at least one action cannot be activated.", { workflowId: numericId("workflow"), active: z.boolean() }, async ({ workflowId, active }) => ok(await client.post(`/workflows/${encodeURIComponent(String(workflowId))}/${active ? "activate" : "deactivate"}`)));
+    // ---------- Broadcasts ----------
+    server.tool("list_broadcasts", "List the broadcast campaigns of the workspace with their status and delivery counters.", {
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ limit, page }) => ok(await client.get("/broadcasts", client.buildListQuery({ limit, page }))));
+    server.tool("create_broadcast", "Create a broadcast campaign. WhatsApp broadcasts must use an approved template; SMS and email carry their own body.", {
+        name: z.string().min(1).max(255),
+        channel_id: z.number().int().positive(),
+        type: z.enum(["whatsapp_template", "sms", "email"]),
+        whatsapp_template_id: z
+            .number()
+            .int()
+            .optional()
+            .describe("Required when type is whatsapp_template."),
+        message_content: z
+            .string()
+            .optional()
+            .describe("Required for sms and email — the body to send."),
+        message_payload: z.record(z.string(), z.unknown()).optional(),
+        segment_filters: z
+            .record(z.string(), z.unknown())
+            .optional()
+            .describe("Audience filter, e.g. { \"tag_ids\": [3] }."),
+        scheduled_at: z
+            .string()
+            .optional()
+            .describe("ISO-8601 moment in the future. Omit and pass send_now to go immediately."),
+        send_now: z.boolean().optional(),
+    }, async (params) => ok(await client.post("/broadcasts", params)));
+    server.tool("cancel_broadcast", "Cancel a scheduled or running broadcast. Messages already delivered are not recalled.", { id: numericId("broadcast") }, async ({ id }) => ok(await client.post(`/broadcasts/${encodeURIComponent(String(id))}/cancel`)));
+    // ---------- Webhooks ----------
+    server.tool("register_webhook", "Subscribe an HTTPS endpoint to workspace events. Creating one requires a workspace admin, and the URL must be https.", {
+        name: z.string().min(1).max(255),
+        url: z.string().url().describe("Must be https — http is refused."),
+        events: z
+            .array(z.string().min(1))
+            .min(1)
+            .describe("Event names, e.g. message.received, conversation.assigned, contact.created, " +
+            "call.ended, tag.added, broadcast.completed."),
+        headers: z
+            .record(z.string(), z.string())
+            .optional()
+            .describe("Extra headers sent with each delivery."),
+        is_active: z.boolean().optional(),
+        retry_count: z.number().int().min(0).max(10).optional(),
+        timeout_seconds: z.number().int().min(5).max(60).optional(),
+    }, async (params) => ok(await client.post("/webhooks", params)));
+    server.tool("list_webhooks", "List the webhook subscriptions of the workspace and the events each one is signed up for.", {}, async () => ok(await client.get("/webhooks")));
+    // ---------- Workspaces ----------
+    server.tool("list_workspaces", "List the workspaces this token can reach. Useful first call when the agent serves more than one.", {}, async () => ok(await client.get("/workspaces")));
+    // ---------- Reports ----------
+    server.tool("get_report", "Read an analytics report over a date range — volume, response times, per-agent performance or an hour-by-hour heatmap.", {
+        report: z
+            .enum(["overview", "conversations", "agents", "heatmap"])
+            .describe("overview = headline stats and trend; conversations = by channel/status/volume; " +
+            "agents = per-agent performance; heatmap = volume by weekday and hour."),
+        preset: z
+            .enum(["today", "yesterday", "7d", "30d", "90d", "this_month", "last_month"])
+            .optional()
+            .describe("Defaults to the last 30 days."),
+        from: z.string().optional().describe("Explicit start date; overridden by preset."),
+        to: z.string().optional(),
+    }, async ({ report, preset, from, to }) => ok(await client.get(`/reports/${report}`, {
+        ...(preset ? { preset } : {}),
+        ...(from ? { from } : {}),
+        ...(to ? { to } : {}),
+    })));
+}
+//# sourceMappingURL=extras.js.map

package/dist/tools/extras.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extras.js","sourceRoot":"","sources":["../../src/tools/extras.ts"],"names":[],"mappings":"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"}

package/dist/tools/messaging.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Messaging tools — send and read messages.
+ *
+ * Omnifox has two send contracts and they do not share a body shape:
+ *
+ *   - `POST /contacts/{id}/message` takes the respond.io-shaped envelope
+ *     `{channelId, message: {type, ...}}`. Attachments travel as a URL.
+ *   - `POST /conversations/{id}/messages` takes a flat payload validated by
+ *     `SendMessageRequest`. Media needs a real multipart upload, which an MCP
+ *     tool cannot do, so only the text-ish types are exposed there.
+ *
+ * 0.1.0 posted a camelCase payload to `/contacts/{id}/messages` — a path that
+ * does not exist (the route is singular) — so no message ever left.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OmnifoxClient } from "../omnifox/client.js";
+export declare function registerMessagingTools(server: McpServer, client: OmnifoxClient): void;
+//# sourceMappingURL=messaging.d.ts.map

package/dist/tools/messaging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/tools/messaging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAU1D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAmJrF"}

package/dist/tools/messaging.js

@@ -0,0 +1,127 @@
+/**
+ * Messaging tools — send and read messages.
+ *
+ * Omnifox has two send contracts and they do not share a body shape:
+ *
+ *   - `POST /contacts/{id}/message` takes the respond.io-shaped envelope
+ *     `{channelId, message: {type, ...}}`. Attachments travel as a URL.
+ *   - `POST /conversations/{id}/messages` takes a flat payload validated by
+ *     `SendMessageRequest`. Media needs a real multipart upload, which an MCP
+ *     tool cannot do, so only the text-ish types are exposed there.
+ *
+ * 0.1.0 posted a camelCase payload to `/contacts/{id}/messages` — a path that
+ * does not exist (the route is singular) — so no message ever left.
+ */
+import { z } from "zod";
+const ok = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+const conversationId = z
+    .union([z.number().int().positive(), z.string().regex(/^\d+$/)])
+    .describe("Numeric id of the conversation.");
+export function registerMessagingTools(server, client) {
+    server.tool("send_message", "Send a message to a contact. Reuses their open conversation on that channel or starts one. " +
+        "Outside WhatsApp's 24-hour window only a template will be delivered.", {
+        identifier: z
+            .string()
+            .min(1)
+            .describe("Contact id, or a kind:value selector like 'phone:+593987654321'."),
+        channelId: z
+            .number()
+            .int()
+            .optional()
+            .describe("Channel to send through. Omitted, the contact's last active channel is used."),
+        type: z
+            .enum(["text", "attachment", "quick_reply", "whatsapp_template", "email"])
+            .default("text"),
+        text: z.string().optional().describe("Body when type is text."),
+        attachment: z
+            .object({
+            type: z.enum(["image", "video", "audio", "file"]),
+            url: z.string().url().describe("Publicly reachable URL; Omnifox fetches it."),
+        })
+            .optional(),
+        quickReply: z
+            .object({
+            title: z.string().describe("Question shown above the buttons."),
+            replies: z.array(z.string()).min(1).max(10),
+        })
+            .optional(),
+        template: z
+            .object({
+            name: z.string().describe("Approved template name — see list_templates."),
+            languageCode: z.string().describe("e.g. es, en_US."),
+            components: z.array(z.record(z.string(), z.unknown())).optional(),
+        })
+            .optional(),
+        email: z
+            .object({
+            subject: z.string().optional(),
+            html: z.string().optional(),
+            text: z.string().optional(),
+            cc: z.array(z.string()).optional(),
+            bcc: z.array(z.string()).optional(),
+        })
+            .optional(),
+    }, async ({ identifier, channelId, type, text, attachment, quickReply, template, email }) => {
+        const message = { type };
+        if (type === "text") {
+            if (!text)
+                throw new Error("send_message: `text` is required when type is text");
+            message.text = text;
+        }
+        else if (type === "attachment") {
+            if (!attachment)
+                throw new Error("send_message: `attachment` is required when type is attachment");
+            message.attachment = attachment;
+        }
+        else if (type === "quick_reply") {
+            if (!quickReply)
+                throw new Error("send_message: `quickReply` is required when type is quick_reply");
+            message.title = quickReply.title;
+            message.replies = quickReply.replies;
+        }
+        else if (type === "whatsapp_template") {
+            if (!template)
+                throw new Error("send_message: `template` is required when type is whatsapp_template");
+            message.template = template;
+        }
+        else if (type === "email") {
+            Object.assign(message, email ?? {});
+        }
+        return ok(await client.post(`/contacts/${encodeURIComponent(identifier)}/message`, {
+            ...(channelId !== undefined ? { channelId } : {}),
+            message,
+        }));
+    });
+    server.tool("send_conversation_message", "Send into a conversation you already know the id of. Use type 'note' for an internal note teammates see but the customer does not.", {
+        conversationId,
+        type: z.enum(["text", "note"]).default("text"),
+        content_text: z.string().min(1),
+        mentioned_user_ids: z
+            .array(z.number().int())
+            .optional()
+            .describe("Teammates to @-mention on an internal note."),
+    }, async ({ conversationId: id, type, content_text, mentioned_user_ids }) => ok(await client.post(`/conversations/${encodeURIComponent(String(id))}/messages`, {
+        type,
+        content_text,
+        ...(type === "note" ? { is_internal_note: true } : {}),
+        ...(mentioned_user_ids?.length ? { mentioned_user_ids } : {}),
+    })));
+    server.tool("get_message", "Fetch one message with its delivery status. Both ids are required — messages are addressed within their conversation.", { conversationId, messageId: z.union([z.number().int(), z.string().regex(/^\d+$/)]) }, async ({ conversationId: id, messageId }) => ok(await client.get(`/conversations/${encodeURIComponent(String(id))}/messages/${encodeURIComponent(String(messageId))}`)));
+    server.tool("list_messages", "List the messages of a conversation, oldest first. Set include_notes to see internal notes interleaved.", {
+        conversationId,
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+        include_notes: z
+            .boolean()
+            .optional()
+            .describe("Include internal notes alongside the customer-visible messages."),
+    }, async ({ conversationId: id, limit, page, include_notes }) => ok(await client.get(`/conversations/${encodeURIComponent(String(id))}/messages`, client.buildListQuery({
+        limit,
+        page,
+        extra: { include_notes: include_notes ? 1 : undefined },
+    }))));
+    server.tool("retry_message", "Ask the channel to deliver a failed message again. Only a message in a failed state can be retried.", { conversationId, messageId: z.union([z.number().int(), z.string().regex(/^\d+$/)]) }, async ({ conversationId: id, messageId }) => ok(await client.post(`/conversations/${encodeURIComponent(String(id))}/messages/${encodeURIComponent(String(messageId))}/retry`)));
+}
+//# sourceMappingURL=messaging.js.map

package/dist/tools/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../../src/tools/messaging.ts"],"names":[],"mappings":"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"}

package/dist/tools/workspace.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Workspace tools — agents, custom fields, channels, snippets, templates, tags.
+ *
+ * Every path and body below was checked against the live API. Two corrections
+ * over 0.1.0 that mattered: workspace members live at `/agents` (there is no
+ * `/users` route), and custom fields are defined with `key`/`label`/
+ * `entity_type`, not `name`/`slug`/`required`.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { OmnifoxClient } from "../omnifox/client.js";
+export declare function registerWorkspaceTools(server: McpServer, client: OmnifoxClient): void;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/tools/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/tools/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAY1D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA6LrF"}

package/dist/tools/workspace.js

@@ -0,0 +1,110 @@
+/**
+ * Workspace tools — agents, custom fields, channels, snippets, templates, tags.
+ *
+ * Every path and body below was checked against the live API. Two corrections
+ * over 0.1.0 that mattered: workspace members live at `/agents` (there is no
+ * `/users` route), and custom fields are defined with `key`/`label`/
+ * `entity_type`, not `name`/`slug`/`required`.
+ */
+import { z } from "zod";
+const ok = (data) => ({
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+});
+/** Every id in Omnifox is a positive integer, not a UUID. */
+const id = (what) => z
+    .union([z.number().int().positive(), z.string().regex(/^\d+$/)])
+    .describe(`Numeric id of the ${what}.`);
+export function registerWorkspaceTools(server, client) {
+    // ---------- Agents (workspace members) ----------
+    server.tool("list_users", "List the workspace members (human agents) with their availability status.", {
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ limit, page }) => ok(await client.get("/agents", client.buildListQuery({ limit, page }))));
+    server.tool("get_user", "Fetch a single workspace member by id, with their role and current availability.", { id: id("user") }, async ({ id: userId }) => ok(await client.get(`/agents/${encodeURIComponent(String(userId))}`)));
+    server.tool("set_user_status", "Set a member's availability: available, busy, away or offline. Routing rules honour it immediately.", {
+        id: id("user"),
+        status: z.enum(["available", "busy", "away", "offline"]),
+    }, async ({ id: userId, status }) => ok(await client.put(`/agents/${encodeURIComponent(String(userId))}/status`, {
+        status,
+        workspace_id: client.workspaceId,
+    })));
+    // ---------- Custom fields ----------
+    server.tool("list_custom_fields", "List the custom field definitions of the workspace so you know which keys a record accepts.", {
+        entity_type: z
+            .enum(["contact", "conversation", "deal", "company"])
+            .optional()
+            .describe("Restrict to the fields defined for one kind of record."),
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ entity_type, limit, page }) => ok(await client.get("/custom-fields", client.buildListQuery({ limit, page, extra: { entity_type } }))));
+    server.tool("get_custom_field", "Fetch a single custom field definition, including its type and its option list.", { id: id("custom field") }, async ({ id: fieldId }) => ok(await client.get(`/custom-fields/${encodeURIComponent(String(fieldId))}`)));
+    server.tool("create_custom_field", "Define a new custom field on contacts, conversations, deals or companies. The type cannot be changed once created.", {
+        key: z
+            .string()
+            .regex(/^[a-z0-9_]+$/)
+            .describe("snake_case identifier used in API payloads."),
+        label: z.string().min(1).describe("Human-readable name shown in the UI."),
+        type: z.enum([
+            "text",
+            "textarea",
+            "number",
+            "decimal",
+            "date",
+            "datetime",
+            "boolean",
+            "select",
+            "multiselect",
+            "url",
+            "email",
+            "phone",
+        ]),
+        entity_type: z
+            .enum(["contact", "conversation", "deal", "company"])
+            .describe("Which kind of record the field hangs off."),
+        options: z
+            .array(z.string())
+            .optional()
+            .describe("Required when type is select or multiselect."),
+        is_required: z.boolean().optional(),
+        is_filterable: z.boolean().optional(),
+        sort_order: z.number().int().min(0).optional(),
+    }, async (params) => ok(await client.post("/custom-fields", params)));
+    // ---------- Channels & templates ----------
+    server.tool("list_channels", "List the connected channels (WhatsApp, Instagram, Messenger, Telegram, webchat, SMS, email, voice).", {
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ limit, page }) => ok(await client.get("/channels", client.buildListQuery({ limit, page }))));
+    server.tool("list_snippets", "List the saved replies (snippets) of the workspace — pre-written answers the team reuses.", {
+        scope: z
+            .enum(["all", "shared", "mine"])
+            .optional()
+            .describe("`shared` hides private snippets; `mine` returns only your own."),
+        category_id: z.number().int().optional(),
+        limit: z.number().int().min(1).max(100).optional(),
+        page: z.number().int().min(1).optional(),
+    }, async ({ scope, category_id, limit, page }) => ok(await client.get("/snippets", client.buildListQuery({ limit, page, extra: { scope, category_id } }))));
+    server.tool("list_templates", "List the approved WhatsApp message templates of a channel. Required to write to a contact outside the 24-hour window.", { channelId: id("channel") }, async ({ channelId }) => ok(await client.get(`/channels/${encodeURIComponent(String(channelId))}/templates`)));
+    // ---------- Tags ----------
+    server.tool("list_tags", "List the tags of the workspace, so you can attach an existing one instead of inventing a name.", { search: z.string().optional().describe("Filter by name.") }, async ({ search }) => ok(await client.get("/tags", search ? { search } : undefined)));
+    server.tool("create_tag", "Create a tag in the workspace. To tag a contact you do not need this first — add_contact_tags creates missing tags itself.", {
+        name: z.string().min(1).max(100),
+        color: z
+            .string()
+            .regex(/^#[0-9a-fA-F]{6}$/)
+            .optional(),
+        description: z.string().max(500).optional(),
+    }, async (params) => ok(await client.post("/tags", params)));
+    server.tool("update_tag", "Rename, recolor or re-describe a tag. The change applies everywhere the tag is already attached.", {
+        id: id("tag"),
+        patch: z.object({
+            name: z.string().min(1).max(100).optional(),
+            color: z
+                .string()
+                .regex(/^#[0-9a-fA-F]{6}$/)
+                .optional(),
+            description: z.string().max(500).optional(),
+        }),
+    }, async ({ id: tagId, patch }) => ok(await client.put(`/tags/${encodeURIComponent(String(tagId))}`, patch)));
+    server.tool("delete_tag", "Delete a tag and detach it from every record that carried it. Irreversible.", { id: id("tag") }, async ({ id: tagId }) => ok(await client.delete(`/tags/${encodeURIComponent(String(tagId))}`)));
+}
+//# sourceMappingURL=workspace.js.map

package/dist/tools/workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/tools/workspace.ts"],"names":[],"mappings":"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"}

package/dist/transport/http.d.ts

@@ -0,0 +1,12 @@
+/**
+ * HTTP transport — POST /mcp + GET /health.
+ *
+ * Uses the SDK's StreamableHTTPServerTransport in stateless mode so the same
+ * express process can fan out across MCP clients (e.g. Composio, k8s).
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface HttpOptions {
+    port?: number;
+}
+export declare function startHttp(serverFactory: () => McpServer, opts?: HttpOptions): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,SAAS,CAC7B,aAAa,EAAE,MAAM,SAAS,EAC9B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CA8Df"}