Complete reference for every tool available in the WhatsApp MCP Server.
FREE = Available in free tier PRO = Requires Pro or Enterprise plan
Send any type of message to WhatsApp contacts.
send_text_messageSend a text message. Supports URL preview and replying to a specific message.
Ask Claude: "Send a message to +56912345678 saying the order #1234 is ready for pickup"
send_image_messageSend an image via URL or uploaded media ID. Supports captions.
Ask Claude: "Send the image at https://example.com/product.jpg to +56912345678 with caption 'New arrival!'"
send_video_messageSend a video (MP4, 3GPP) with optional caption.
send_audio_messageSend an audio file (AAC, MP3, OGG, AMR).
send_document_messageSend a document (PDF, etc.) with optional filename and caption.
Ask Claude: "Send the invoice at https://example.com/invoice.pdf to +56912345678 with filename 'Invoice-March-2026.pdf'"
send_sticker_messageSend a WEBP sticker via URL or media ID.
send_location_messageSend a location pin with coordinates, name, and address.
Ask Claude: "Send our store location to +56912345678: latitude -33.45, longitude -70.65, name 'Our Store'"
send_contact_messageSend one or more contact cards with name, phone, email.
send_reactionReact to a received message with an emoji.
Ask Claude: "React with a thumbs up to the last message"
mark_as_readMark a message as read (shows blue checkmarks to the sender).
Rich interactive messages with buttons, lists, and product catalogs.
send_button_messageSend a message with up to 3 reply buttons. Great for quick choices like "Yes / No / Maybe".
Ask Claude: "Send a message to +56912345678 asking 'Do you want to confirm your appointment?' with buttons: Confirm, Reschedule, Cancel"
send_list_messageSend a scrollable list menu organized in sections. Users tap a button to see options.
Ask Claude: "Send a menu to +56912345678 with sections: Drinks (Coffee $3, Tea $2.50) and Food (Sandwich $5, Salad $4)"
send_cta_url_buttonSend a message with a call-to-action button that opens a URL.
send_product_messageSend a single product from your connected catalog.
send_product_list_messageSend a multi-product message showing several items from your catalog in sections.
Manage message templates required for initiating conversations outside the 24h window.
send_template_messageSend an approved template with dynamic parameters, media headers, and buttons.
Ask Claude: "Send the hello_world template to +56912345678"
list_templatesList all templates with their approval status (APPROVED, PENDING, REJECTED).
Ask Claude: "Show me all my WhatsApp templates"
create_templateCreate a new template. Supports categories: MARKETING, UTILITY, AUTHENTICATION.
delete_templateDelete a template by name.
get_template_statusCheck the current approval status of a specific template.
Upload, download, and manage media files on WhatsApp servers.
upload_mediaUpload a file from a URL to WhatsApp servers. Returns a media ID for use in messages. Max 100MB.
get_media_urlGet the download URL for an uploaded media file. URLs expire after 5 minutes.
delete_mediaDelete a previously uploaded media file.
Receive and search incoming messages. No other MCP server offers this.
get_recent_messagesGet messages received from customers. Filter by phone number or date.
Ask Claude: "Show me messages from today" Ask Claude: "Show me messages from +56912345678"
get_message_status_updatesTrack delivery status of sent messages: sent, delivered, read, or failed.
Ask Claude: "Show me which messages failed to deliver"
search_conversationsSearch through all received messages by text content, phone number, or date range.
Ask Claude: "Search for messages containing 'refund'"
View and manage your WhatsApp Business profile and phone numbers.
get_business_profileGet your profile info: about, address, description, email, websites.
update_business_profileUpdate any field of your business profile.
get_phone_numbersList all registered phone numbers with quality rating and messaging limits.
Create interactive forms, surveys, and sign-ups directly inside WhatsApp chat.
create_flowCreate a new WhatsApp Flow (multi-step interactive experience).
send_flow_messageSend a Flow to a customer. They see an interactive form directly in the chat.
Monitor your WhatsApp Business performance, quality, and limits.
get_conversation_analyticsGet conversation metrics: messages sent, delivered, costs, broken down by time period.
get_phone_quality_ratingCheck phone quality: GREEN (good), YELLOW (warning), RED (at risk of being blocked).
Ask Claude: "What's my phone number quality rating?"
get_messaging_limitsSee your current tier: 250 / 1K / 10K / 100K / Unlimited unique contacts per 24h.
get_delivery_statsGet delivery statistics for a date range: how many sent, delivered, read, and failed.
Anti-spam protection. Every outbound message is checked by the MessageGuard before sending.
manage_allowlistAdd, remove, or list phone numbers on your recipient allowlist. Enable or disable the allowlist to restrict who can receive messages.
Actions: add, remove, list, enable, disable
Ask Claude: "Add +56936538600 to my allowlist" Ask Claude: "Show my allowlist" Ask Claude: "Enable my recipient allowlist"
get_messaging_safety_statusView your current anti-spam config: allowlist status, rate limits per recipient, unique recipient caps, spam filter status, and usage this hour.
Ask Claude: "Show my messaging safety status"
| Protection | Free | Pro | Enterprise |
|---|---|---|---|
| Messages/recipient/hour | 5 | 30 | 100 |
| Unique recipients/hour | 3 | 50 | 500 |
| Spam content filter | Yes | Yes | Yes |
| Duplicate blocking | Yes | Yes | No |
Advanced compliance, audit, and custom control tools. Only available on the Enterprise plan.
get_message_audit_logFull audit trail of every message sent through your account. Filter by recipient, delivery status, and date range. Essential for compliance monitoring and team oversight.
Ask Claude: "Show me all messages sent to +56936538600 in the last 7 days" Ask Claude: "Show me all failed messages this week" Ask Claude: "Get my audit log for today"
set_custom_rate_limitsOverride default rate limits with your own values. Set per-recipient caps (up to 500/hr), unique recipient limits (up to 2000/hr), restrict allowed message types, and add custom blocked patterns on top of the built-in spam filter.
Ask Claude: "Set my rate limit to 200 messages per recipient per hour" Ask Claude: "Only allow text and template messages" Ask Claude: "Block messages containing 'promo code'"
export_safety_reportGenerate a comprehensive compliance report for your account. Includes message volume, success rate, blocked message count, risk score (0-100), and actionable recommendations. Export as JSON for integration with your compliance systems.
Ask Claude: "Generate my safety report for the last 30 days" Ask Claude: "What's my account risk score?"
AI-powered automatic replies to incoming WhatsApp messages. Supports 5 providers: Groq (free), Claude, OpenAI, Gemini, DeepSeek. Each client uses their own API key.
configure_auto_replySet up the AI chatbot: choose provider, API key, system prompt, business hours, conversation memory, and rate limits.
Ask Claude: "Configure auto-reply with Groq. Key: gsk_xxxxx. Prompt: You are a customer service agent for my store." Ask Claude: "Enable business hours only, 9am to 6pm" Ask Claude: "Switch provider to OpenAI with model gpt-4o"
get_auto_reply_statusCheck your current auto-reply configuration: provider, model, memory status, business hours, and rate limits.
Ask Claude: "Show my auto-reply status"
clear_conversation_historyClear the AI's conversation memory for a specific customer or all customers. Use when you want the AI to start fresh.
Ask Claude: "Clear conversation history for +56936538600" Ask Claude: "Clear all conversation histories"
| Provider | Default Model | Free Tier? |
|---|---|---|
| Groq | Llama 3.3 70B | Yes (recommended) |
| Claude (Anthropic) | claude-sonnet-4-20250514 | No |
| OpenAI | gpt-4o | No |
| Gemini (Google) | gemini-2.0-flash | Limited |
| DeepSeek | deepseek-chat | No |