mcp-evolution 0.0.0-stage → 0.8.0

package/dist/registry.d.ts

@@ -0,0 +1,36 @@
+import { z, type ZodRawShape } from "zod";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { Config } from "./config.js";
+import type { EvolutionClient, InstanceClient } from "./evolution-client.js";
+import { RecipientPolicy } from "./guards/recipients.js";
+/** Per-call context handed to every tool handler. */
+export interface ToolContext {
+    /** Client bound to the (allowlisted) instance chosen for this call. */
+    client: InstanceClient;
+    /** Recipient policy in force for that instance (use to filter listing results). */
+    recipients: RecipientPolicy;
+    /** Shared, stateless HTTP client (instance-agnostic helpers such as list_instances). */
+    http: EvolutionClient;
+    config: Config;
+}
+type ToolResult = CallToolResult;
+export interface ToolDefinition<S extends ZodRawShape> {
+    title?: string;
+    description: string;
+    inputSchema: S;
+    /** false = tool is not bound to an instance (no `instance` param, no recipient checks). */
+    instanceScoped?: boolean;
+}
+export interface ToolRegistry {
+    registerTool<S extends ZodRawShape>(name: string, def: ToolDefinition<S>, handler: (args: z.objectOutputType<S, z.ZodTypeAny>, ctx: ToolContext) => Promise<ToolResult>): void;
+}
+/** Resolve which instance a call targets. Never returns a value outside the allowlist. */
+export declare function resolveInstance(config: Config, requested: unknown): string;
+export declare function recipientPolicyFor(config: Config, instance: string): RecipientPolicy;
+/**
+ * Wrap an McpServer so every tool registration goes through the guards:
+ * tool allowlist, instance allowlist/selection, recipient allowlist and secret redaction.
+ */
+export declare function createToolRegistry(server: McpServer, http: EvolutionClient, config: Config): ToolRegistry;
+export {};

package/dist/registry.js

@@ -0,0 +1,68 @@
+import { z } from "zod";
+import { GuardError } from "./errors.js";
+import { enforceRecipients, RecipientPolicy } from "./guards/recipients.js";
+const INSTANCE_ERROR = "Instance is not configured. Use list_instances to see the allowed instances.";
+/** Resolve which instance a call targets. Never returns a value outside the allowlist. */
+export function resolveInstance(config, requested) {
+    if (requested !== undefined && requested !== null && requested !== "") {
+        if (typeof requested !== "string" || !config.instances.includes(requested)) {
+            throw new GuardError(INSTANCE_ERROR);
+        }
+        return requested;
+    }
+    if (config.defaultInstance)
+        return config.defaultInstance;
+    throw new GuardError("Multiple instances are configured and no default is set: pass the `instance` parameter " +
+        "(see list_instances) or set EVOLUTION_DEFAULT_INSTANCE.");
+}
+export function recipientPolicyFor(config, instance) {
+    return new RecipientPolicy(config.instanceRecipients.get(instance) ?? config.globalRecipients);
+}
+function redactResult(result, redact) {
+    return {
+        ...result,
+        content: result.content.map((c) => (c.type === "text" ? { ...c, text: redact(c.text) } : c)),
+    };
+}
+/**
+ * Wrap an McpServer so every tool registration goes through the guards:
+ * tool allowlist, instance allowlist/selection, recipient allowlist and secret redaction.
+ */
+export function createToolRegistry(server, http, config) {
+    const multi = config.instances.length > 1;
+    const instanceParam = multi
+        ? z
+            .enum(config.instances, { errorMap: () => ({ message: INSTANCE_ERROR }) })
+            .optional()
+            .describe(config.defaultInstance
+            ? `WhatsApp instance to use (default: ${config.defaultInstance}). See list_instances.`
+            : "WhatsApp instance to use (required: no default configured). See list_instances.")
+        : undefined;
+    return {
+        registerTool(name, def, handler) {
+            if (!config.allowedTools.has(name))
+                return;
+            const scoped = def.instanceScoped !== false;
+            const inputSchema = scoped && instanceParam ? { ...def.inputSchema, instance: instanceParam } : def.inputSchema;
+            server.registerTool(name, { title: def.title, description: def.description, inputSchema }, async (rawArgs) => {
+                try {
+                    const { instance: requested, ...args } = rawArgs ?? {};
+                    const instance = scoped
+                        ? resolveInstance(config, requested)
+                        : (config.defaultInstance ?? config.instances[0]);
+                    const recipients = recipientPolicyFor(config, instance);
+                    if (scoped)
+                        enforceRecipients(name, args, recipients);
+                    const client = http.forInstance(instance);
+                    const result = await handler(args, { client, recipients, http, config });
+                    return redactResult(result, http.redact);
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    return { isError: true, content: [{ type: "text", text: http.redact(msg) }] };
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/schemas.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+export declare const JidSchema: z.ZodString;
+export declare const PhoneOrJidSchema: z.ZodString;
+export declare const LimitSchema: z.ZodOptional<z.ZodNumber>;

package/dist/schemas.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export const JidSchema = z
+    .string()
+    .min(1)
+    .describe("WhatsApp JID (e.g. 5511999999999@s.whatsapp.net or group@g.us)");
+export const PhoneOrJidSchema = z
+    .string()
+    .min(1)
+    .describe("Recipient JID or phone number (e.g. 5511999999999 or group@g.us)");
+export const LimitSchema = z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("Max items to return (default 50)");
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,gEAAgE,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,kEAAkE,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,EAAE;KACR,GAAG,EAAE;KACL,QAAQ,EAAE;KACV,QAAQ,EAAE;KACV,QAAQ,CAAC,kCAAkC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type Config } from "./config.js";
+/** Build a fully-guarded MCP server for the given config (no transport attached). */
+export declare function createServer(config: Config): McpServer;
+export declare function startServer(): Promise<void>;

package/dist/server.js

@@ -0,0 +1,74 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createRequire } from "node:module";
+import { parseConfig, ConfigError } from "./config.js";
+import { EvolutionClient } from "./evolution-client.js";
+import { createHttpApp, loadHttpOptions } from "./http.js";
+import { createToolRegistry } from "./registry.js";
+import { registerAllTools } from "./tools/index.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../package.json");
+/** Build a fully-guarded MCP server for the given config (no transport attached). */
+export function createServer(config) {
+    const http = new EvolutionClient({
+        apiUrl: config.apiUrl,
+        apiKey: config.apiKey,
+        basicAuth: config.basicAuth,
+        dbUrl: config.dbUrl,
+        instances: config.instances,
+    });
+    const server = new McpServer({ name: "mcp-evolution", version });
+    registerAllTools(createToolRegistry(server, http, config));
+    return server;
+}
+function describeConfig(config) {
+    return (`instances: ${config.instances.join(", ")}; ` +
+        `default: ${config.defaultInstance ?? "none"}; tools: ${config.allowedTools.size}; ` +
+        `recipient allowlist: ${config.globalRecipients || config.instanceRecipients.size > 0 ? "on" : "off"}`);
+}
+export async function startServer() {
+    const mode = (process.env.MCP_TRANSPORT?.trim() || "stdio").toLowerCase();
+    if (mode === "http")
+        return startHttpServer();
+    if (mode !== "stdio") {
+        console.error(`[mcp-evolution] MCP_TRANSPORT must be "stdio" or "http" (got "${mode}")`);
+        process.exit(1);
+    }
+    const config = parseConfig();
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    // Graceful shutdown — close transport cleanly on SIGINT/SIGTERM
+    const shutdown = async (signal) => {
+        console.error(`[mcp-evolution] Received ${signal}, shutting down...`);
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown("SIGINT"));
+    process.on("SIGTERM", () => void shutdown("SIGTERM"));
+    await server.connect(transport);
+    console.error(`[mcp-evolution] Started (${describeConfig(config)})`);
+}
+async function startHttpServer() {
+    const config = parseConfig();
+    let opts;
+    try {
+        opts = loadHttpOptions(process.env);
+    }
+    catch (err) {
+        if (err instanceof ConfigError) {
+            console.error(`[mcp-evolution] ${err.message}`);
+            process.exit(1);
+        }
+        throw err;
+    }
+    const app = createHttpApp(() => createServer(config), opts);
+    const shutdown = (signal) => {
+        console.error(`[mcp-evolution] Received ${signal}, shutting down...`);
+        app.close(() => process.exit(0));
+    };
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    await new Promise((resolve) => app.listen(opts.port, opts.host, resolve));
+    console.error(`[mcp-evolution] HTTP listening on ${opts.host}:${opts.port}${opts.path} (${describeConfig(config)})`);
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/accept-invite.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerAcceptInvite(server: ToolRegistry): void;

package/dist/tools/accept-invite.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    inviteCode: z.string().min(1).describe("Group invite code (the part after https://chat.whatsapp.com/)"),
+};
+export function registerAcceptInvite(server) {
+    server.registerTool("accept_invite", {
+        title: "Accept Invite",
+        description: "Accept a WhatsApp group invite by invite code via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.get(`/group/acceptInviteCode/${client.instanceName}?inviteCode=${encodeURIComponent(args.inviteCode)}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=accept-invite.js.map

package/dist/tools/accept-invite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept-invite.js","sourceRoot":"","sources":["../../src/tools/accept-invite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACxG,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,0EAA0E;QACvF,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,2BAA2B,MAAM,CAAC,YAAY,eAAe,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CACnG,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/archive-chat.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerArchiveChat(server: ToolRegistry): void;

package/dist/tools/archive-chat.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    lastMessage: z.object({
+        key: z.object({
+            remoteJid: z.string().optional(),
+            fromMe: z.boolean().optional(),
+            id: z.string().optional(),
+        }),
+    }).describe("Last message object of the chat"),
+    chat: z.string().min(1).describe("JID of the chat to archive/unarchive"),
+    archive: z.boolean().describe("true to archive, false to unarchive"),
+};
+export function registerArchiveChat(server) {
+    server.registerTool("archive_chat", {
+        title: "Archive Chat",
+        description: "Archive or unarchive a WhatsApp chat via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.post(`/chat/archiveChat/${client.instanceName}`, {
+                lastMessage: args.lastMessage,
+                chat: args.chat,
+                archive: args.archive,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=archive-chat.js.map

package/dist/tools/archive-chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-chat.js","sourceRoot":"","sources":["../../src/tools/archive-chat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;YACZ,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YAC9B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,CAAC;KACH,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IACxE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;CACrE,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,iEAAiE;QAC9E,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,YAAY,EAAE,EAAE;gBACzE,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/check-number.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerCheckNumber(server: ToolRegistry): void;

package/dist/tools/check-number.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    numbers: z.array(z.string().min(1)).min(1).describe("Array of phone numbers to check (e.g. ['5511999999999']). Returns whether each number has WhatsApp and their JID."),
+};
+export function registerCheckNumber(server) {
+    server.registerTool("check_number", {
+        title: "Check Number",
+        description: "Check whether phone numbers have WhatsApp accounts. Returns exists, jid, and number for each.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.post(`/chat/whatsappNumbers/${client.instanceName}`, {
+                numbers: args.numbers,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=check-number.js.map

package/dist/tools/check-number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-number.js","sourceRoot":"","sources":["../../src/tools/check-number.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CACjD,mHAAmH,CACpH;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+FAA+F;QAC5G,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,yBAAyB,MAAM,CAAC,YAAY,EAAE,EAAE;gBAC7E,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/connection-state.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerConnectionState(server: ToolRegistry): void;

package/dist/tools/connection-state.js

@@ -0,0 +1,19 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerConnectionState(server) {
+    server.registerTool("connection_state", {
+        title: "Connection State",
+        description: "Get the current connection state of the selected WhatsApp instance (open, close, connecting).",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.get(`/instance/connectionState/${client.instanceName}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=connection-state.js.map

package/dist/tools/connection-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.js","sourceRoot":"","sources":["../../src/tools/connection-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IAC1D,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,+FAA+F;QAC5G,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,6BAA6B,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAClF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/create-group.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerCreateGroup(server: ToolRegistry): void;

package/dist/tools/create-group.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    subject: z.string().min(1).describe("Group name/subject"),
+    description: z.string().optional().describe("Optional group description"),
+    participants: z.array(z.string().min(1)).min(1).describe("Array of participant phone numbers or JIDs"),
+};
+export function registerCreateGroup(server) {
+    server.registerTool("create_group", {
+        title: "Create Group",
+        description: "Create a new WhatsApp group via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const payload = {
+                subject: args.subject,
+                participants: args.participants,
+            };
+            if (args.description)
+                payload["description"] = args.description;
+            const data = await client.post(`/group/create/${client.instanceName}`, payload);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=create-group.js.map

package/dist/tools/create-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-group.js","sourceRoot":"","sources":["../../src/tools/create-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACzD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACzE,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CACvG,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAA4B;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,CAAC;YACF,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;YAChE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;YAChF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete-message.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerDeleteMessage(server: ToolRegistry): void;

package/dist/tools/delete-message.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    id: z.string().min(1).describe("Message ID to delete"),
+    remoteJid: z.string().min(1).describe("JID of the chat containing the message"),
+    fromMe: z.boolean().describe("Whether the message was sent by this instance"),
+    participant: z.string().optional().describe("Participant JID (required for group messages)"),
+};
+export function registerDeleteMessage(server) {
+    server.registerTool("delete_message", {
+        title: "Delete Message",
+        description: "Delete a message for everyone via the selected WhatsApp instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const payload = {
+                id: args.id,
+                remoteJid: args.remoteJid,
+                fromMe: args.fromMe,
+            };
+            if (args.participant)
+                payload["participant"] = args.participant;
+            const data = await client.delete(`/chat/deleteMessageForEveryone/${client.instanceName}`, payload);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=delete-message.js.map

package/dist/tools/delete-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-message.js","sourceRoot":"","sources":["../../src/tools/delete-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC/E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC7E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CAC7F,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,mEAAmE;QAChF,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAA4B;gBACvC,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;YACF,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;YAChE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,kCAAkC,MAAM,CAAC,YAAY,EAAE,EAAE,OAAO,CAAC,CAAC;YACnG,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/download-media.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerDownloadMedia(server: ToolRegistry): void;

package/dist/tools/download-media.js

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { mimeToExt } from "../util/normalize.js";
+const MEDIA_DIR = "/tmp/mcp-evolution-media";
+const schema = {
+    message: z.object({
+        key: z.object({
+            remoteJid: z.string().min(1).describe("Chat JID"),
+            fromMe: z.boolean().describe("Whether sent by this instance"),
+            id: z.string().min(1).describe("Message ID"),
+        }),
+    }).describe("Message object containing the media"),
+    convertToMp4: z.boolean().optional().describe("Convert audio to mp4 format (forwarded to Evolution)"),
+};
+export function registerDownloadMedia(server) {
+    server.registerTool("download_media", {
+        title: "Download Media",
+        description: "Download media from a WhatsApp message and write it to disk. " +
+            "Returns { path, mimetype, size, messageId } — NOT raw base64 (prevents context overflow). " +
+            "File is written to /tmp/mcp-evolution-media/<instance>-<messageId>.<ext>. " +
+            "Caller is responsible for cleanup (rm the file when done).",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const payload = { message: args.message };
+            if (args.convertToMp4 !== undefined)
+                payload["convertToMp4"] = args.convertToMp4;
+            const data = await client.post(`/chat/getBase64FromMediaMessage/${client.instanceName}`, payload);
+            const base64 = data.base64;
+            if (!base64) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: "Evolution returned no base64 data for this message." }],
+                };
+            }
+            const mimetype = data.mimetype ?? data.mediaType ?? "application/octet-stream";
+            const ext = mimeToExt(mimetype);
+            const messageId = args.message.key.id;
+            const filename = `${client.instanceName}-${messageId}.${ext}`;
+            const filePath = path.join(MEDIA_DIR, filename);
+            // Ensure media dir exists (mode 0700 — only root/owner readable)
+            await fs.mkdir(MEDIA_DIR, { recursive: true, mode: 0o700 });
+            const buf = Buffer.from(base64, "base64");
+            await fs.writeFile(filePath, buf, { mode: 0o600 });
+            const result = { path: filePath, mimetype, size: buf.length, messageId };
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=download-media.js.map

package/dist/tools/download-media.js.map

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

package/dist/tools/fetch-business-profile.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFetchBusinessProfile(server: ToolRegistry): void;

package/dist/tools/fetch-business-profile.js

@@ -0,0 +1,25 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { PhoneOrJidSchema } from "../schemas.js";
+const schema = {
+    number: PhoneOrJidSchema,
+};
+export function registerFetchBusinessProfile(server) {
+    server.registerTool("fetch_business_profile", {
+        title: "Fetch Business Profile",
+        description: "Fetch the WhatsApp Business profile information of a contact via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.post(`/chat/fetchBusinessProfile/${client.instanceName}`, {
+                number: args.number,
+            });
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=fetch-business-profile.js.map

package/dist/tools/fetch-business-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-business-profile.js","sourceRoot":"","sources":["../../src/tools/fetch-business-profile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,GAAG;IACb,MAAM,EAAE,gBAAgB;CACzB,CAAC;AAEF,MAAM,UAAU,4BAA4B,CAAC,MAAoB;IAC/D,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,yFAAyF;QACtG,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,8BAA8B,MAAM,CAAC,YAAY,EAAE,EAAE;gBAClF,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-invite-code.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFetchInviteCode(server: ToolRegistry): void;

package/dist/tools/fetch-invite-code.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    groupJid: z.string().min(1).describe("Group JID (e.g. 120363000000000000@g.us)"),
+};
+export function registerFetchInviteCode(server) {
+    server.registerTool("fetch_invite_code", {
+        title: "Fetch Invite Code",
+        description: "Fetch the invite code/link for a WhatsApp group via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.get(`/group/inviteCode/${client.instanceName}?groupJid=${encodeURIComponent(args.groupJid)}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=fetch-invite-code.js.map

package/dist/tools/fetch-invite-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-invite-code.js","sourceRoot":"","sources":["../../src/tools/fetch-invite-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,MAAM,GAAG;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACjF,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IAC1D,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAC3B,qBAAqB,MAAM,CAAC,YAAY,aAAa,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CACzF,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,YAAY,QAAQ;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3G,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-privacy.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistry } from "../registry.js";
+export declare function registerFetchPrivacy(server: ToolRegistry): void;

package/dist/tools/fetch-privacy.js

@@ -0,0 +1,19 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerFetchPrivacy(server) {
+    server.registerTool("fetch_privacy", {
+        title: "Fetch Privacy Settings",
+        description: "Fetch the current privacy settings of the selected WhatsApp instance.",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.get(`/chat/fetchPrivacySettings/${client.instanceName}`);
+            return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+        }
+        catch (e) {
+            if (e instanceof McpError)
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=fetch-privacy.js.map