Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WHATSAPP_API_VERSION | No | Version of the Meta Graph API (e.g., v21.0). | v21.0 |
| WHATSAPP_ACCESS_TOKEN | Yes | Your Meta system user access token. Can be obtained via Meta Business Manager → WhatsApp → API Configuration. | |
| WHATSAPP_PHONE_NUMBER_ID | Yes | Your WhatsApp Phone Number ID. | |
| WHATSAPP_BUSINESS_ACCOUNT_ID | Yes | Your WhatsApp Business Account ID (WABA ID). |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| send_text_message | Send a text message to a WhatsApp number. Works within the 24-hour conversation window. For messages outside this window, use send_template_message instead. |
| send_template_message | Send a pre-approved template message. Required for initiating conversations outside the 24-hour window. Templates must be approved by Meta before use. |
| send_media_message | Send an image, video, audio, or document to a WhatsApp number. |
| send_interactive_message | Send an interactive message with buttons or a selection list. |
| send_location_message | Send a location pin to a WhatsApp number. |
| send_contact_message | Send a contact card to a WhatsApp number. |
| mark_message_read | Mark a received message as read (blue checkmarks). Use the message_id from a received webhook. |
| list_templates | List all message templates in the WhatsApp Business Account, optionally filtered by status. |
| create_template | Create a new message template for approval by Meta. Templates are required for outbound messages outside the 24-hour window. |
| delete_template | Delete a message template by name. This action is irreversible. |
| get_phone_numbers | List all phone numbers registered on this WhatsApp Business Account, including quality rating and messaging limits. |
| get_business_profile | Get the WhatsApp Business profile (about, address, description, email, websites, profile picture). |
| update_business_profile | Update the WhatsApp Business profile information. |
| get_analytics | Get messaging analytics (sent, delivered, read counts) for a date range. |
| upload_media | Upload a media file for later sending. Returns a media_id that can be used with send_media_message. |
| get_media_url | Get the download URL for a received media file. URLs are valid for 5 minutes. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| campaign-sender | Guide for sending a marketing campaign via WhatsApp templates |
| support-responder | Guide for handling customer support messages on WhatsApp |
| template-creator | Guide for creating a WhatsApp message template following Meta's rules |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| templates | |
| business-profile | |
| phone-numbers |