Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | info | |
| MEDIA_DIR | No | ||
| TRANSPORT | No | MCP transport mode | stdio |
| STORE_PATH | No | ||
| SESSION_DIR | No | ||
| SETTINGS_PATH | No | ||
| MEDIA_PUBLIC_BASE_URL | No | ||
| MCP_HTTP_ENABLE_JSON_RESPONSE | No | 1 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_qr_code | Get the latest WhatsApp QR code as an image for authentication |
| check_auth_status | Check if the WhatsApp client is authenticated and ready |
| logout | Logout from WhatsApp and clear the current session |
| force_resync | Force a full WhatsApp resync (clears app state and reconnects). |
| search_contacts | Search WhatsApp contacts by name or phone number. |
| resolve_contact | Resolve a contact by name or phone number (returns best matches). |
| get_contact_by_id | Get contact details by JID. |
| get_profile_pic | Get profile picture URL for a contact or group JID. |
| get_group_info | Get group metadata and participants by group JID. |
| list_chats | Get WhatsApp chats, optionally filtered and sorted. |
| list_system_chats | List system chats (status/protocol events). |
| list_groups | List group chats only. |
| get_chat_by_id | Get WhatsApp chat metadata by JID. |
| get_direct_chat_by_contact_number | Get direct WhatsApp chat JID by contact phone number (less reliable, use get_chat_by_id if JID is known). |
| get_chat_by_contact | Resolve a contact by name or phone number and return the chat metadata. |
| analyze_group_overlaps | Find members that appear across multiple groups and return overlap details. |
| find_members_without_direct_chat | Find group members that do not have a direct chat with you. |
| find_members_not_in_contacts | Find group members that are not in your contacts. |
| run_group_audit | Run a combined group-membership audit (overlaps, no direct chat, not in contacts). |
| list_messages | Get WhatsApp messages from a specific chat. |
| get_message_by_id | Get a specific WhatsApp message by its ID. |
| search_messages | Search messages by text, optionally within a specific chat. |
| get_message_context | Get recent messages around a specific message ID within its chat (context accuracy depends on fetch limit). |
| get_last_interaction | Get the most recent message involving a specific contact or group JID. |
| send_message | Send a WhatsApp text message to a person or group. |
| send_media | Send media (image, video, document, audio) via WhatsApp. |
| download_media | Download media from a WhatsApp message and return its content. |
| ping | - |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |