List WhatsApp groups for the pinned instance. Supports search and limit to prevent large payloads.

Find chats for the pinned instance. Supports search, limit, and offset to prevent large payloads.

Find contacts for the pinned instance. Supports search (substring on pushName/name/remoteJid), limit, and offset to prevent large payloads. Returns normalized { remoteJid, pushName, profilePicUrl, isBusiness } — extra fields dropped.

Find messages by remoteJid (phone number or group JID) for the pinned instance. Returns normalized { id, fromMe, remoteJid, timestamp, type, text, mediaKey?, quotedMessageId? } — raw payload dropped to prevent overflow.

Get chat history for a specific contact or group JID. Returns normalized { id, fromMe, remoteJid, timestamp, type, text, mediaKey?, quotedMessageId? } — raw payload dropped to prevent overflow.

Send a text message via the pinned WhatsApp instance.

Send a media message (image, video, audio, document) via the pinned instance.

Get detailed info for a specific WhatsApp group. By default returns { id, subject, subjectOwner, subjectTime, size, desc, descId, creation, owner, admins } — participant list is dropped to prevent payload overflow. Set includeParticipants=true to get the full list (use sparingly for large groups).

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.

Send a WhatsApp audio (PTT voice note) via the pinned instance.

Send a sticker message via the pinned WhatsApp instance.

Send a location pin message via the pinned WhatsApp instance.

Share one or more contacts (vCards) via the pinned WhatsApp instance.

React to a WhatsApp message with an emoji via the pinned instance. Send empty string to remove reaction.

Send a WhatsApp poll message via the pinned instance.

Send a WhatsApp list message (interactive menu) via the pinned instance.

Send a WhatsApp interactive button message via the pinned instance (max 3 buttons).

Post a WhatsApp Status update (story) via the pinned instance.

Mark one or more messages as read via the pinned WhatsApp instance.

Archive or unarchive a WhatsApp chat via the pinned instance.

Delete a message for everyone via the pinned WhatsApp instance.

Fetch the profile picture URL of a WhatsApp contact via the pinned instance.

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/-.. Caller is responsible for cleanup (rm the file when done).

Send a presence update (typing, recording, etc.) to a chat via the pinned instance.

Fetch the WhatsApp Business profile information of a contact via the pinned instance.

Update the display name of the pinned WhatsApp instance's profile.

Update the 'about' status text of the pinned WhatsApp instance's profile.

Update the profile picture of the pinned WhatsApp instance.

Remove the profile picture of the pinned WhatsApp instance.

Fetch the current privacy settings of the pinned WhatsApp instance.

Update privacy settings for the pinned WhatsApp instance. Values: all, contacts, contact_blacklist, none.

Create a new WhatsApp group via the pinned instance.

Update the name/subject of a WhatsApp group via the pinned instance.

Update the description of a WhatsApp group via the pinned instance.

Update the profile picture of a WhatsApp group via the pinned instance.

Fetch the invite code/link for a WhatsApp group via the pinned instance.

Revoke and regenerate the invite code for a WhatsApp group via the pinned instance.

Accept a WhatsApp group invite by invite code via the pinned instance.

Send a WhatsApp group invite link to specific contacts via the pinned instance.

Add, remove, promote, or demote participants in a WhatsApp group via the pinned instance.

Update group settings (announcement mode, locked) via the pinned instance.

Leave a WhatsApp group via the pinned instance.

Get group information from an invite code without joining via the pinned instance. Returns { id, subject, subjectOwner, subjectTime, size, desc, descId, creation, owner, admins } by default. Set includeParticipants=true to also get the full participant list.

Get the current connection state of the pinned WhatsApp instance (open, close, connecting).

Restart the pinned WhatsApp instance (reconnects without logging out).

Logout the pinned WhatsApp instance (disconnects and clears session — requires QR scan to reconnect).

Get the current settings of the pinned WhatsApp instance.

Update settings for the pinned WhatsApp instance.

Get the current webhook configuration for the pinned WhatsApp instance.

Configure the webhook for the pinned WhatsApp instance.

List all WhatsApp labels for the pinned instance (requires WhatsApp Business). Returns normalized { id, name, color } array — nested chat blobs dropped to prevent overflow.

Add or remove a WhatsApp label from a chat via the pinned instance (requires WhatsApp Business).

Block or unblock a WhatsApp contact via the pinned instance.

Check whether phone numbers have WhatsApp accounts. Returns exists, jid, and number for each.