Schema | mcp-wacli

Server Configuration

Describes the environment variables required to run the server.

Name	Required	Description	Default
No arguments

Capabilities

Features and capabilities supported by this server

Capability	Details
`tools`	{ "listChanged": false }
`prompts`	{ "listChanged": false }
`resources`	{ "subscribe": false, "listChanged": false }
`experimental`	{}

Tools

Functions exposed to the LLM to take actions

Name	Description
list_chats	List WhatsApp chats from local DB. `Args: query: Optional search string to filter chats by name limit: Max number of chats to return (default 50)`
show_chat	Show details of a single chat. `Args: jid: Chat JID (e.g. '573001234567@s.whatsapp.net' or '...@g.us' for groups)`
list_messages	List recent WhatsApp messages with optional filters. `Args: chat: Optional chat JID to filter by after: Only messages after this date (YYYY-MM-DD or RFC3339) before: Only messages before this date (YYYY-MM-DD or RFC3339) limit: Max results (default 50)`
search_messages	Full-text search across WhatsApp messages (FTS5 if available, LIKE fallback). `Args: query: Search text chat: Optional chat JID filter sender: Optional sender JID filter after: Only after this date (YYYY-MM-DD or RFC3339) before: Only before this date (YYYY-MM-DD or RFC3339) media_type: Filter by media type (image\|video\|audio\|document) limit: Max results (default 50)`
show_message	Show details of a single message. `Args: message_id: The message ID chat: Chat JID where the message is`
message_context	Show surrounding messages around a specific message ID for context. `Args: message_id: The message ID to center on chat: Chat JID where the message is before: Number of messages before (default 5) after: Number of messages after (default 5)`
search_contacts	Search WhatsApp contacts by name or phone number. `Args: query: Search term limit: Max results (default 50)`
show_contact	Show details of a single contact. `Args: jid: Contact JID (e.g. '573001234567@s.whatsapp.net')`
set_contact_alias	Set a local alias (nickname) for a contact. `Args: jid: Contact JID alias: Alias to set`
remove_contact_alias	Remove a local alias from a contact. `Args: jid: Contact JID`
refresh_contacts	Import/refresh contacts from the WhatsApp session store into local DB.
send_message	Send a text message via WhatsApp. `Args: to: Recipient phone number (e.g. '573001234567') or JID message: Text message to send`
send_file	Send a file (image, video, audio, document) via WhatsApp. `Args: to: Recipient phone number or JID file_path: Path to the file on the server caption: Optional caption for the file filename: Optional display name (defaults to file basename) mime: Optional MIME type override`
list_groups	List WhatsApp groups from local DB. `Args: query: Optional search string to filter groups limit: Max results (default 50)`
group_info	Fetch live group info from WhatsApp and update local DB. `Args: jid: Group JID (e.g. '120363001234567890@g.us')`
group_rename	Rename a WhatsApp group. `Args: jid: Group JID name: New group name`
group_leave	Leave a WhatsApp group. `Args: jid: Group JID`
group_join	Join a WhatsApp group by invite code. `Args: code: Invite code from a group link (the part after https://chat.whatsapp.com/)`
group_participants_add	Add participants to a WhatsApp group. `Args: jid: Group JID users: List of phone numbers or JIDs to add`
group_participants_remove	Remove participants from a WhatsApp group. `Args: jid: Group JID users: List of phone numbers or JIDs to remove`
group_participants_promote	Promote participants to admin in a WhatsApp group. `Args: jid: Group JID users: List of phone numbers or JIDs to promote`
group_participants_demote	Demote admin participants in a WhatsApp group. `Args: jid: Group JID users: List of phone numbers or JIDs to demote`
download_media	Download media from a WhatsApp message. `Args: message_id: The message ID containing media chat: Chat JID where the message is output: Optional output file or directory (defaults to wacli media dir)`
sync_once	Sync messages once (connect, fetch new messages, then exit). `Args: refresh_contacts: Also refresh contacts from session store refresh_groups: Also refresh joined groups (live) download_media: Download media in the background during sync`
history_backfill	Request older messages for a chat from your primary device (best-effort). `Args: chat: Chat JID to backfill history for`
doctor	Run wacli diagnostics — check store, authentication, and search capabilities.
auth_status	Show authentication status of the current wacli session.

Prompts

Interactive templates invoked by user choice

Name	Description
No prompts

Resources

Contextual data attached and managed by the client

Name	Description
No resources

mcp-wacli

Server Configuration

Capabilities

Tools

Prompts

Resources

Latest Blog Posts

MCP directory API