productivity
WhatsApp Business MCP, CLI, and Lua Integration for AI Agents
WhatsApp Business integration docs for AI agents: MCP gateway setup, WhatsApp Business CLI commands, Lua API reference, credentials, and function schemas.WhatsApp Business for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Agent Surfaces
Machine-Readable Metadata
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
whatsapp.whatsapp_send_message | Write write | 3 | Send a text message to a WhatsApp recipient. Use this for replying within an existing 24-hour customer service window. For new conversations, use the send_template tool instead. |
whatsapp.whatsapp_send_template | Write write | 4 | Send a template-based WhatsApp message. Use this to initiate new conversations outside the 24-hour window. The template must be pre-approved in the WhatsApp Business Manager. |
whatsapp.whatsapp_send_message_payload | Write write | 1 | Send any official WhatsApp Cloud API message payload to the configured phone number. |
whatsapp.whatsapp_mark_message_read | Write write | 1 | Mark an inbound WhatsApp message as read using its message ID. |
whatsapp.whatsapp_get_message | Read read | 2 | Retrieve a specific WhatsApp message or Graph object by ID with optional fields. |
whatsapp.whatsapp_check_contacts | Read read | 1 | Validate one or more phone numbers through the WhatsApp Cloud API contacts endpoint. |
whatsapp.whatsapp_list_contacts | Read read | 1 | Validate WhatsApp contacts for the configured business phone number. Legacy slug for check_contacts. |
whatsapp.whatsapp_upload_media | Write write | 2 | Upload a local image, video, audio, sticker, or document file to WhatsApp media storage. |
whatsapp.whatsapp_get_media | Read read | 1 | Get WhatsApp media metadata and the temporary download URL for a media ID. |
whatsapp.whatsapp_delete_media | Write write | 1 | Delete an uploaded WhatsApp media object by media ID. |
whatsapp.whatsapp_list_templates | Read read | 4 | List approved WhatsApp message templates. Templates are required to initiate new conversations outside the 24-hour service window. |
whatsapp.whatsapp_get_template | Read read | 1 | Get a WhatsApp message template by Graph template ID. |
whatsapp.whatsapp_create_template | Write write | 1 | Create a WhatsApp message template on the configured WhatsApp Business Account. |
whatsapp.whatsapp_update_template | Write write | 2 | Update a WhatsApp message template by Graph template ID. |
whatsapp.whatsapp_delete_template | Write write | 2 | Delete a WhatsApp message template by name and optional template ID. |
whatsapp.whatsapp_get_phone_number | Read read | 1 | Get phone number metadata such as display number, verified name, quality rating, and throughput. |
whatsapp.whatsapp_list_phone_numbers | Read read | 2 | List phone numbers attached to the configured WhatsApp Business Account. |
whatsapp.whatsapp_request_verification_code | Write write | 3 | Request a WhatsApp phone-number verification code by SMS or voice. |
whatsapp.whatsapp_verify_code | Write write | 2 | Verify a WhatsApp phone-number registration code. |
whatsapp.whatsapp_register_phone_number | Write write | 2 | Register a WhatsApp phone number for Cloud API use with a two-step verification PIN. |
whatsapp.whatsapp_deregister_phone_number | Write write | 1 | Deregister a WhatsApp phone number from Cloud API use. |
whatsapp.whatsapp_get_business_profile | Read read | 1 | Get the WhatsApp business profile for the configured phone number. |
whatsapp.whatsapp_update_business_profile | Write write | 1 | Update the WhatsApp business profile fields for the configured phone number. |
whatsapp.whatsapp_list_subscribed_apps | Read read | 0 | List apps subscribed to the configured WhatsApp Business Account webhook events. |
whatsapp.whatsapp_subscribe_app | Write write | 0 | Subscribe the configured app to WhatsApp Business Account webhook events. |
whatsapp.whatsapp_unsubscribe_app | Write write | 0 | Unsubscribe the configured app from WhatsApp Business Account webhook events. |
whatsapp.whatsapp_get_current_user | Read read | 0 | Get the authenticated WhatsApp Business user info - name, email, and business ID. Useful for verifying which account is connected. |
whatsapp.whatsapp_api_get | Read read | 2 | Call a safe relative Meta Graph API path with GET for WhatsApp endpoints not yet modeled as first-class tools. |
whatsapp.whatsapp_api_post | Write write | 3 | Call a safe relative Meta Graph API path with POST for WhatsApp endpoints not yet modeled as first-class tools. |
whatsapp.whatsapp_api_delete | Write write | 2 | Call a safe relative Meta Graph API path with DELETE for WhatsApp endpoints not yet modeled as first-class tools. |