Your agent can read chats, reply, look people up in the address book, react to and edit messages, manage groups, block and unblock contacts, fetch attachments and receive inbound messages by…
WhatsMCP | MCP Server is an MCP project maintained in the whatsmcp/mcp repository. The maintainer describes its purpose as “Your agent can read chats, reply, look people up in the address book, react to and edit messages, manage groups, block and unblock contacts, fetch…”. Read the project documentation for the complete scope.
The maintainer’s configuration uses https://api.whatsmcp.com/mcp. It declares streamable-http transport. Check the project’s account and authentication instructions when adding the endpoint to your client.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| wa_list_accounts | Lists your linked numbers: account_id, phone, push_name, state (pairing, connected, disconnected, logged_out, locked) |
| wa_pair_account | Starts linking a new number; returns a QR as a base64 PNG |
| wa_pair_status | Polls a pairing; returns a fresh code while one is waiting |
| wa_unpair_account | Disconnects a linked number |
| wa_set_profile_photo | Replaces or removes the profile photo of one of your numbers — the picture every contact sees |
| wa_get_plan | Your plan, its limits, and usage so far against the message and account caps — call it to see why a send was refused, or how much headroom is left |
| wa_send_message | Sends text, an image, a document or audio from one of your numbers |
| wa_list_messages | Reads messages across accounts, oldest first, paged by cursor |
| wa_get_chat | Recent messages for one account, no cursor — a one-off catch-up |
| wa_get_message | Fetches one stored message by its WhatsApp id or cursor — the one a webhook just announced, say |
| wa_get_media | Downloads a received attachment by message_id (base64 + mime) |
| wa_react | Reacts with an emoji; an empty reaction removes one you sent |
| wa_edit_message | Edits a message you sent — WhatsApp accepts an edit for about 20 minutes |
| wa_delete_message | Deletes for everyone. WhatsApp has no true delete; this revokes the message, which every modern client honours |
| wa_set_presence | Announces typing (composing/paused) to a chat, or sets an account available/unavailable. Fire-and-forget — there is no delivery confirmation |
| wa_list_contacts | The account's address book, paged — or, with a query, a search by name or number; optionally with profile pictures |
| wa_get_profile | Looks up who a number is on WhatsApp: whether it is registered, its public name, about text, picture, and a business's categories, contact details and hours |
| wa_block_contact | Blocks a contact — they can no longer call or message this account — or, with unblock: true, unblocks one again |
| wa_list_blocked | Everyone this account has blocked |
| wa_list_groups | Groups an account has joined — JID, name, member count |
| wa_list_channels | Channels an account follows — JID, name, subscriber count |
| wa_join_group | Joins a group from an invite link |
| wa_follow_channel | Follows a Channel from its link |
| wa_leave_chat | Leaves a group or unfollows a channel |
| wa_list_group_members | A group's members, each with JID, phone and admin flag |
| wa_create_group | Creates a group; returns its JID and invite link |
| wa_delete_group | Removes every other member, then leaves (WhatsApp has no true delete) |
| wa_update_participants | Adds members by phone number or JID, or promotes members to admin and demotes admins back — action is add, promote or demote |
| wa_remove_participants | Removes members from the group |
| wa_update_group | Changes the group's name, description, whether only admins may change settings (locked) and whether only admins may post (announce) — any of them in one call |
| wa_get_group_invite_link | Returns the invite link, or with reset revokes it and issues a new one |
| wa_list_calls | Call history, oldest first, paged — direction, peer, answered, seconds, reason, codec |
| wa_set_webhook | Registers an HTTPS endpoint for inbound messages; returns a signing secret shown once |
| wa_get_webhook | Shows the endpoint, whether it is enabled, when it last succeeded |
| wa_enable_webhook | Pauses or resumes delivery without changing the endpoint or its secret |
| wa_delete_webhook | Stops delivery; messages remain readable through the tools |
{
"mcpServers": {
"wamcp": {
"type": "http",
"url": "https://api.whatsmcp.com/mcp",
"headers": {
"Authorization": "YOUR_AUTHORIZATION"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
MCP server for sending SMTP email notifications
Tech stack, email security (SPF, DMARC, MX provider) and domain age API + MCP. 25 free domains/day.
Extract shoppable products from newsletter content with affiliate signals.
Business phone and SMS for teams: calls, texts, transcripts, contacts and call flows.