mcp-evolution 0.0.0-stage → 0.8.0

package/dist/tools/get-group-resolved-participants.js

@@ -0,0 +1,170 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { getPool, isDbConfigured } from "../util/db.js";
+const schema = {
+    groupJid: z
+        .string()
+        .min(1)
+        .describe("Group JID (e.g. 120363xxxxxxxx@g.us)"),
+    sinceDays: z
+        .number()
+        .int()
+        .min(1)
+        .max(365)
+        .default(180)
+        .optional()
+        .describe("Lookback window in days for message history used to resolve LIDs. Default 180. " +
+        "Larger window = more LIDs resolved but slower query."),
+    onlyResolved: z
+        .boolean()
+        .default(false)
+        .optional()
+        .describe("When true, omits participants without phone or pushName from response. " +
+        "Useful when caller only wants actionable contacts."),
+};
+export function registerGetGroupResolvedParticipants(server) {
+    server.registerTool("get_group_resolved_participants", {
+        title: "Get Group Resolved Participants (LID → phone + name)",
+        description: "Resolve a group's LID participants to phone JID + pushName by cross-referencing " +
+            "the Evolution Postgres Message history (key->>'participantAlt' field). " +
+            "Returns: { groupJid, total, resolved, unresolved, participants: [{ lid, phone, name, isAdmin, lastSeen }] }. " +
+            "Coverage depends on how many participants sent messages in the lookback window — " +
+            "silent members stay unresolved. Phone field is ready to use with send_text. " +
+            "Requires EVOLUTION_DB_URL env var pointing to Evolution's Postgres.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            if (!isDbConfigured()) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: "EVOLUTION_DB_URL not configured. Set it in the MCP env to enable DB-backed " +
+                                "LID resolution (e.g. postgresql://user:pass@host:5432/evolution_api).",
+                        },
+                    ],
+                };
+            }
+            const pool = getPool();
+            if (!pool) {
+                return {
+                    isError: true,
+                    content: [
+                        { type: "text", text: "Postgres pool unavailable." },
+                    ],
+                };
+            }
+            const groupJid = args.groupJid;
+            const sinceDays = args.sinceDays ?? 180;
+            const onlyResolved = args.onlyResolved === true;
+            const data = (await client.get(`/group/findGroupInfos/${client.instanceName}?groupJid=${encodeURIComponent(groupJid)}`));
+            const participants = Array.isArray(data.participants)
+                ? data.participants
+                : [];
+            if (participants.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                groupJid,
+                                subject: data.subject,
+                                total: 0,
+                                resolved: 0,
+                                unresolved: 0,
+                                participants: [],
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            const lidIds = participants.map((p) => p.id ?? "").filter(Boolean);
+            let resolvedMap = new Map();
+            if (lidIds.length > 0) {
+                const sql = `
+            SELECT DISTINCT ON (participant)
+              participant,
+              participant_alt,
+              push_name,
+              last_seen
+            FROM (
+              SELECT
+                key->>'participant' AS participant,
+                key->>'participantAlt' AS participant_alt,
+                "pushName" AS push_name,
+                "messageTimestamp" AS last_seen
+              FROM "Message"
+              WHERE key->>'remoteJid' = $1
+                AND key->>'participant' = ANY($2::text[])
+                AND "messageTimestamp" > EXTRACT(EPOCH FROM (NOW() - ($3 || ' days')::interval))
+                AND (key->>'participantAlt' IS NOT NULL OR "pushName" IS NOT NULL)
+                AND "instanceId" = (SELECT id FROM "Instance" WHERE name = $4 LIMIT 1)
+              ORDER BY "messageTimestamp" DESC
+            ) t
+            ORDER BY participant, last_seen DESC NULLS LAST
+          `;
+                const params = [groupJid, lidIds, String(sinceDays), client.instanceName];
+                const res = await pool.query(sql, params);
+                for (const row of res.rows) {
+                    resolvedMap.set(row.participant, row);
+                }
+            }
+            const enriched = participants
+                .map((p) => {
+                const id = p.id ?? "";
+                const r = resolvedMap.get(id);
+                const phoneJid = r?.participant_alt ?? null;
+                const phone = phoneJid && phoneJid.endsWith("@s.whatsapp.net")
+                    ? phoneJid.split("@")[0]
+                    : null;
+                const isLid = id.endsWith("@lid");
+                const fallbackPhone = !isLid && id.endsWith("@s.whatsapp.net") ? id.split("@")[0] : null;
+                const name = r?.push_name && !/^\d+$/.test(r.push_name) ? r.push_name : null;
+                return {
+                    lid: id,
+                    phone: phone ?? fallbackPhone,
+                    name,
+                    isAdmin: p.admin != null && p.admin !== "",
+                    lastSeen: r?.last_seen ? Number(r.last_seen) : null,
+                };
+            })
+                .filter((p) => (onlyResolved ? p.phone || p.name : true));
+            const resolvedCount = enriched.filter((p) => p.phone).length;
+            const namedCount = enriched.filter((p) => p.name).length;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            groupJid,
+                            subject: data.subject,
+                            total: participants.length,
+                            resolvedPhone: resolvedCount,
+                            resolvedName: namedCount,
+                            unresolved: participants.length - resolvedCount,
+                            sinceDays,
+                            participants: enriched,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: e.message }],
+                };
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            return {
+                isError: true,
+                content: [
+                    { type: "text", text: `DB resolution failed: ${msg}` },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-group-resolved-participants.js.map

package/dist/tools/get-group-resolved-participants.js.map

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

package/dist/tools/get-settings.d.ts

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

package/dist/tools/get-settings.js

@@ -0,0 +1,19 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerGetSettings(server) {
+    server.registerTool("get_settings", {
+        title: "Get Settings",
+        description: "Get the current settings of the selected WhatsApp instance.",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.get(`/settings/find/${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=get-settings.js.map

package/dist/tools/get-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-settings.js","sourceRoot":"","sources":["../../src/tools/get-settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,6DAA6D;QAC1E,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,kBAAkB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YACvE,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/handle-label.d.ts

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

package/dist/tools/handle-label.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { PhoneOrJidSchema } from "../schemas.js";
+const schema = {
+    number: PhoneOrJidSchema,
+    labelId: z.string().min(1).describe("Label ID to add or remove (get IDs from find_labels)"),
+    action: z.enum(["add", "remove"]).describe("add: assign label to chat; remove: unassign label from chat"),
+};
+export function registerHandleLabel(server) {
+    server.registerTool("handle_label", {
+        title: "Handle Label",
+        description: "Add or remove a WhatsApp label from a chat via the selected instance (requires WhatsApp Business).",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.post(`/label/handleLabel/${client.instanceName}`, {
+                number: args.number,
+                labelId: args.labelId,
+                action: args.action,
+            });
+            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=handle-label.js.map

package/dist/tools/handle-label.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-label.js","sourceRoot":"","sources":["../../src/tools/handle-label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,GAAG;IACb,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sDAAsD,CAAC;IAC3F,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,6DAA6D,CAAC;CAC1G,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,oGAAoG;QACjH,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,sBAAsB,MAAM,CAAC,YAAY,EAAE,EAAE;gBAC1E,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,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/index.d.ts

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

package/dist/tools/index.js

@@ -0,0 +1,131 @@
+import { registerListInstances } from "./list-instances.js";
+// Original tools
+import { registerListGroups } from "./list-groups.js";
+import { registerFindChats } from "./find-chats.js";
+import { registerFindContacts } from "./find-contacts.js";
+import { registerFindMessages } from "./find-messages.js";
+import { registerGetChatHistory } from "./get-chat-history.js";
+import { registerSendText } from "./send-text.js";
+import { registerSendMedia } from "./send-media.js";
+import { registerGetGroupInfo } from "./get-group-info.js";
+import { registerGetGroupResolvedParticipants } from "./get-group-resolved-participants.js";
+// Message
+import { registerSendAudio } from "./send-audio.js";
+import { registerSendSticker } from "./send-sticker.js";
+import { registerSendLocation } from "./send-location.js";
+import { registerSendContact } from "./send-contact.js";
+import { registerSendReaction } from "./send-reaction.js";
+import { registerSendPoll } from "./send-poll.js";
+import { registerSendList } from "./send-list.js";
+import { registerSendButton } from "./send-button.js";
+import { registerSendStatus } from "./send-status.js";
+// Chat
+import { registerMarkAsRead } from "./mark-as-read.js";
+import { registerArchiveChat } from "./archive-chat.js";
+import { registerDeleteMessage } from "./delete-message.js";
+import { registerFetchProfilePicture } from "./fetch-profile-picture.js";
+import { registerDownloadMedia } from "./download-media.js";
+import { registerSendPresence } from "./send-presence.js";
+// Profile
+import { registerFetchBusinessProfile } from "./fetch-business-profile.js";
+import { registerUpdateProfileName } from "./update-profile-name.js";
+import { registerUpdateProfileStatus } from "./update-profile-status.js";
+import { registerUpdateProfilePicture } from "./update-profile-picture.js";
+import { registerRemoveProfilePicture } from "./remove-profile-picture.js";
+import { registerFetchPrivacy } from "./fetch-privacy.js";
+import { registerUpdatePrivacy } from "./update-privacy.js";
+// Group
+import { registerCreateGroup } from "./create-group.js";
+import { registerUpdateGroupSubject } from "./update-group-subject.js";
+import { registerUpdateGroupDescription } from "./update-group-description.js";
+import { registerUpdateGroupPicture } from "./update-group-picture.js";
+import { registerFetchInviteCode } from "./fetch-invite-code.js";
+import { registerRevokeInviteCode } from "./revoke-invite-code.js";
+import { registerAcceptInvite } from "./accept-invite.js";
+import { registerSendGroupInvite } from "./send-group-invite.js";
+import { registerUpdateParticipants } from "./update-participants.js";
+import { registerUpdateGroupSetting } from "./update-group-setting.js";
+import { registerLeaveGroup } from "./leave-group.js";
+import { registerFindGroupByInvite } from "./find-group-by-invite.js";
+// Instance
+import { registerConnectionState } from "./connection-state.js";
+import { registerRestartInstance } from "./restart-instance.js";
+import { registerLogoutInstance } from "./logout-instance.js";
+import { registerGetSettings } from "./get-settings.js";
+import { registerSetSettings } from "./set-settings.js";
+// Webhook
+import { registerFindWebhook } from "./find-webhook.js";
+import { registerSetWebhook } from "./set-webhook.js";
+// Label
+import { registerFindLabels } from "./find-labels.js";
+import { registerHandleLabel } from "./handle-label.js";
+// Block & Misc
+import { registerUpdateBlockStatus } from "./update-block-status.js";
+import { registerCheckNumber } from "./check-number.js";
+export function registerAllTools(server) {
+    registerListInstances(server);
+    // Original
+    registerListGroups(server);
+    registerFindChats(server);
+    registerFindContacts(server);
+    registerFindMessages(server);
+    registerGetChatHistory(server);
+    registerSendText(server);
+    registerSendMedia(server);
+    registerGetGroupInfo(server);
+    registerGetGroupResolvedParticipants(server);
+    // Message
+    registerSendAudio(server);
+    registerSendSticker(server);
+    registerSendLocation(server);
+    registerSendContact(server);
+    registerSendReaction(server);
+    registerSendPoll(server);
+    registerSendList(server);
+    registerSendButton(server);
+    registerSendStatus(server);
+    // Chat
+    registerMarkAsRead(server);
+    registerArchiveChat(server);
+    registerDeleteMessage(server);
+    registerFetchProfilePicture(server);
+    registerDownloadMedia(server);
+    registerSendPresence(server);
+    // Profile
+    registerFetchBusinessProfile(server);
+    registerUpdateProfileName(server);
+    registerUpdateProfileStatus(server);
+    registerUpdateProfilePicture(server);
+    registerRemoveProfilePicture(server);
+    registerFetchPrivacy(server);
+    registerUpdatePrivacy(server);
+    // Group
+    registerCreateGroup(server);
+    registerUpdateGroupSubject(server);
+    registerUpdateGroupDescription(server);
+    registerUpdateGroupPicture(server);
+    registerFetchInviteCode(server);
+    registerRevokeInviteCode(server);
+    registerAcceptInvite(server);
+    registerSendGroupInvite(server);
+    registerUpdateParticipants(server);
+    registerUpdateGroupSetting(server);
+    registerLeaveGroup(server);
+    registerFindGroupByInvite(server);
+    // Instance
+    registerConnectionState(server);
+    registerRestartInstance(server);
+    registerLogoutInstance(server);
+    registerGetSettings(server);
+    registerSetSettings(server);
+    // Webhook
+    registerFindWebhook(server);
+    registerSetWebhook(server);
+    // Label
+    registerFindLabels(server);
+    registerHandleLabel(server);
+    // Block & Misc
+    registerUpdateBlockStatus(server);
+    registerCheckNumber(server);
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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

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

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

package/dist/tools/leave-group.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 to leave (e.g. 120363000000000000@g.us)"),
+};
+export function registerLeaveGroup(server) {
+    server.registerTool("leave_group", {
+        title: "Leave Group",
+        description: "Leave a WhatsApp group via the selected instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.delete(`/group/leaveGroup/${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=leave-group.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"leave-group.js","sourceRoot":"","sources":["../../src/tools/leave-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,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,mDAAmD,CAAC;CAC1F,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,mDAAmD;QAChE,WAAW,EAAE,MAAM;KACpB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAC9B,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/list-groups.d.ts

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

package/dist/tools/list-groups.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const schema = {
+    search: z
+        .string()
+        .optional()
+        .describe("Case-insensitive substring match against group subject. Omit for no filter."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(50)
+        .optional()
+        .describe("Max results to return (default 50, max 500)."),
+};
+export function registerListGroups(server) {
+    server.registerTool("list_groups", {
+        title: "List Groups",
+        description: "List WhatsApp groups for the selected instance. Supports search and limit to prevent large payloads.",
+        inputSchema: schema,
+    }, async (args, { client, recipients }) => {
+        try {
+            const data = await client.get(`/group/fetchAllGroups/${client.instanceName}?getParticipants=false`);
+            let groups = Array.isArray(data) ? data : [];
+            // Recipient allowlist: never expose groups outside it
+            if (recipients.restricted)
+                groups = groups.filter((g) => recipients.isAllowed(g.id));
+            // Client-side search filter (Evolution API has no query filter)
+            if (args.search) {
+                const needle = args.search.toLowerCase();
+                groups = groups.filter((g) => g.subject?.toLowerCase().includes(needle));
+            }
+            // Sort by subject asc for stable results
+            groups.sort((a, b) => (a.subject ?? "").localeCompare(b.subject ?? ""));
+            // Cap results
+            const limit = args.limit ?? 50;
+            groups = groups.slice(0, limit);
+            // Normalize to compact shape — drop owner to shrink payload
+            const normalized = groups.map(({ id, subject, size }) => ({ id, subject, size }));
+            return {
+                content: [{ type: "text", text: JSON.stringify(normalized, null, 2) }],
+            };
+        }
+        catch (e) {
+            if (e instanceof McpError) {
+                return { isError: true, content: [{ type: "text", text: e.message }] };
+            }
+            throw e;
+        }
+    });
+}
+//# sourceMappingURL=list-groups.js.map

package/dist/tools/list-groups.js.map

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

package/dist/tools/list-instances.d.ts

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

package/dist/tools/list-instances.js

@@ -0,0 +1,37 @@
+import { z } from "zod";
+const schema = {
+    includeState: z
+        .boolean()
+        .optional()
+        .describe("When true, also fetch the connection state (open/close/connecting) of each instance."),
+};
+export function registerListInstances(server) {
+    server.registerTool("list_instances", {
+        title: "List Instances",
+        description: "List the WhatsApp instances this server is allowed to use (names only) and which one is the default. " +
+            "Pass one of these names as `instance` to other tools. Set includeState=true to also get each connection state.",
+        inputSchema: schema,
+        instanceScoped: false,
+    }, async (args, { http, config }) => {
+        const instances = await Promise.all(config.instances.map(async (name) => {
+            const item = {
+                name,
+                default: name === config.defaultInstance,
+            };
+            if (args.includeState) {
+                try {
+                    const data = await http
+                        .forInstance(name)
+                        .get(`/instance/connectionState/${name}`);
+                    item.state = data?.instance?.state ?? data?.state ?? "unknown";
+                }
+                catch (e) {
+                    item.error = e instanceof Error ? e.message : String(e);
+                }
+            }
+            return item;
+        }));
+        return { content: [{ type: "text", text: JSON.stringify({ instances }, null, 2) }] };
+    });
+}
+//# sourceMappingURL=list-instances.js.map

package/dist/tools/list-instances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-instances.js","sourceRoot":"","sources":["../../src/tools/list-instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,MAAM,GAAG;IACb,YAAY,EAAE,CAAC;SACZ,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sFAAsF,CAAC;CACpG,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACT,uGAAuG;YACvG,gHAAgH;QAClH,WAAW,EAAE,MAAM;QACnB,cAAc,EAAE,KAAK;KACtB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE;QAC/B,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YAClC,MAAM,IAAI,GAAuE;gBAC/E,IAAI;gBACJ,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,eAAe;aACzC,CAAC;YACF,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,IAAI;yBACpB,WAAW,CAAC,IAAI,CAAC;yBACjB,GAAG,CAAoD,6BAA6B,IAAI,EAAE,CAAC,CAAC;oBAC/F,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,SAAS,CAAC;gBACjE,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,IAAI,CAAC,KAAK,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CACH,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChG,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/logout-instance.d.ts

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

package/dist/tools/logout-instance.js

@@ -0,0 +1,19 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerLogoutInstance(server) {
+    server.registerTool("logout_instance", {
+        title: "Logout Instance",
+        description: "Logout the selected WhatsApp instance (disconnects and clears session — requires QR scan to reconnect).",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.delete(`/instance/logout/${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=logout-instance.js.map

package/dist/tools/logout-instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logout-instance.js","sourceRoot":"","sources":["../../src/tools/logout-instance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,yGAAyG;QACtH,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,oBAAoB,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC5E,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/mark-as-read.d.ts

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

package/dist/tools/mark-as-read.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+const MessageKeySchema = z.object({
+    remoteJid: z.string().min(1).describe("JID of the chat"),
+    fromMe: z.boolean().describe("Whether the message was sent by this instance"),
+    id: z.string().min(1).describe("Message ID"),
+});
+const schema = {
+    readMessages: z.array(MessageKeySchema).min(1).describe("Array of message keys to mark as read"),
+};
+export function registerMarkAsRead(server) {
+    server.registerTool("mark_as_read", {
+        title: "Mark as Read",
+        description: "Mark one or more messages as read via the selected WhatsApp instance.",
+        inputSchema: schema,
+    }, async (args, { client }) => {
+        try {
+            const data = await client.post(`/chat/markMessageAsRead/${client.instanceName}`, {
+                readMessages: args.readMessages,
+            });
+            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=mark-as-read.js.map

package/dist/tools/mark-as-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mark-as-read.js","sourceRoot":"","sources":["../../src/tools/mark-as-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IACxD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IAC7E,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,MAAM,GAAG;IACb,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;CACjG,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,uEAAuE;QACpF,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,2BAA2B,MAAM,CAAC,YAAY,EAAE,EAAE;gBAC/E,YAAY,EAAE,IAAI,CAAC,YAAY;aAChC,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/remove-profile-picture.d.ts

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

package/dist/tools/remove-profile-picture.js

@@ -0,0 +1,19 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+export function registerRemoveProfilePicture(server) {
+    server.registerTool("remove_profile_picture", {
+        title: "Remove Profile Picture",
+        description: "Remove the profile picture of the selected WhatsApp instance.",
+        inputSchema: {},
+    }, async (_args, { client }) => {
+        try {
+            const data = await client.delete(`/chat/removeProfilePicture/${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=remove-profile-picture.js.map