// MCP TOOL REFERENCE

WAHA MCP SERVER TOOLS

52 tools from the WAHA MCP Server MCP Server, categorised by risk level.

// ALL 52 WAHA MCP SERVER TOOLS

READ 17 tools

Read waha_check_contact_exists Check if phone number is registered on WhatsApp. Read waha_get_all_contacts List all contacts with pagination. Read waha_get_all_presence Get all subscribed presence information. Read waha_get_chat_picture Get the profile picture URL for a chat. Uses 24-hour cache by default. Read waha_get_chats Get overview of recent WhatsApp chats. Returns chat ID, name, last message preview, and unread count. Defau... Read waha_get_contact Get contact information by ID. Read waha_get_contact_about Get contact Read waha_get_contact_profile_picture Get contact Read waha_get_group_info Get detailed information about a specific group. Read waha_get_group_invite_code Get group invite link. Read waha_get_group_join_info Get group information from invite link without joining. Read waha_get_group_participants List all members in a group. Read waha_get_group_picture Get group profile picture URL. Read waha_get_groups List all groups with filtering and pagination options. Read waha_get_groups_count Get total number of groups. Read waha_get_messages Get messages from a specific WhatsApp chat. Returns message content, sender, timestamp, and status. Default... Read waha_get_presence Get online/offline/typing status for a chat. Auto-subscribes if not already subscribed.

WRITE 28 tools

Write waha_demote_group_admin Remove admin privileges from participant(s). Requires admin privileges. Write waha_react_to_message Add an emoji reaction to a message. To remove a reaction, send an empty string. Write waha_add_group_participants Add member(s) to a group. Requires admin privileges. Write waha_archive_chat Archive a chat. Archived chats are hidden from the main chat list. Write waha_block_contact Block a contact. Write waha_create_group Create a new WhatsApp group. Write waha_edit_message Edit a sent message in a chat. Only works for messages sent by the bot. Write waha_join_group Join a group using invite code/link. Write waha_mark_chat_read Mark messages in a chat as read. Can specify number of recent messages or time range in days. Write waha_mark_chat_unread Mark a chat as unread. This adds an unread indicator to the chat. Write waha_pin_message Pin a message in a chat. Pinned messages appear at the top of the chat. Write waha_promote_group_admin Promote participant(s) to group admin. Requires admin privileges. Write waha_send_audio Send audio/voice messages to a WhatsApp chat. Supports URL or base64 data. Write waha_send_contact Send contact card(s) to a WhatsApp chat using vCard format. Write waha_send_location Send location coordinates to a WhatsApp chat. Write waha_send_media Send media files (images, videos, or documents) to a WhatsApp chat. Supports URL or base64 data. Write waha_send_message Send a text message to a WhatsApp chat. Returns message ID and delivery timestamp. Write waha_set_group_info_admin_only Toggle whether only admins can edit group info. Requires admin privileges. Write waha_set_group_messages_admin_only Toggle whether only admins can send messages. Requires admin privileges. Write waha_set_group_picture Set or update group profile picture. Write waha_set_presence Set your own presence status (online, offline, typing, recording, or paused). Write waha_star_message Star or unstar a message. Write waha_subscribe_presence Subscribe to presence updates for a chat. Write waha_unarchive_chat Unarchive a chat. Moves the chat back to the main chat list. Write waha_unblock_contact Unblock a contact. Write waha_unpin_message Unpin a message in a chat. Write waha_update_group_description Update group description. Write waha_update_group_subject Change group name/subject.

DESTRUCTIVE 6 tools

Destructive waha_clear_chat_messages Clear all messages from a chat. WARNING: This is a destructive operation that cannot be undone. Destructive waha_delete_chat Delete a chat completely. WARNING: This is a destructive operation that cannot be undone. Destructive waha_delete_group_picture Remove group profile picture. Destructive waha_delete_message Delete a specific message from a chat. This is a destructive operation and cannot be undone. Destructive waha_remove_group_participants Remove member(s) from a group. Requires admin privileges. Destructive waha_leave_group Leave a group.

EXECUTE 1 tools

Execute waha_revoke_group_invite_code Revoke current invite link and generate a new one. Requires admin privileges.

// FAQ

How many tools does the WAHA MCP Server MCP server have? +

The WAHA MCP Server MCP server exposes 52 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on WAHA MCP Server tools? +

Route the WAHA MCP Server server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do WAHA MCP Server tools fall into? +

WAHA MCP Server tools are categorised as Read (17), Write (28), Destructive (6), Execute (1). Each category has a recommended default policy.

Enforce policy on every WAHA MCP Server tool call.

Start from WAHA MCP Server, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Free to start. No card required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.