GREEN-API WABA MCP Server Supported Methods#

The method is used to connect a WABA instance to the session and validate its credentials. Call to connect to another instance. Not needed on the hosted server, where the instance is bound automatically during OAuth authorization.
instance_id, api_token, api_url
Example requests:
- "Connect to WABA instance 1234567890 with token abc123"

The method is used to disconnect the instance and remove saved credentials from the session.
instance_id
Example requests:
- "Disconnect from GREEN-API WABA"

The method is used to return the current state of the account: authorized, notAuthorized or starting.
instance_id
Example requests:
- "Check if my WABA instance is authorized"
- "What is the WhatsApp Business connection status?"

The method is used to restart the WABA instance.
instance_id
Example requests:
- "Reboot the WABA instance"

The method is used to read the current notification settings: webhook URL and token, enabled notification types.
instance_id
Example requests:
- "Show my instance settings"

The method is used to update notification settings. An empty webhook_url disables webhooks. At least one parameter must be passed.
webhook_url, webhook_url_token, outgoing_webhook, outgoing_api_message_webhook, incoming_webhook, instance_id
Example requests:
- "Set the webhook to https://myserver.com/hook"
- "Enable incoming message notifications"

The method is used to retrieve the phone number and state of the WhatsApp Business account.
instance_id
Example requests:
- "Which number is connected to my WABA instance?"

The method is used to send a free-form text message of up to 20000 characters. Supports link previews. Delivered only inside the 24-hour customer care window.
chat_id, message, link_preview, instance_id
Example requests:
- "Reply to the customer +11001234567: 'Hello! Your order is on its way'"

The method is used to send a pre-approved message template. This is the only way to start a conversation or message a customer outside the 24-hour window. Supports template parameters {{1}}, {{2}}, a media header and postback buttons.
chat_id, template_id, params, media_type, media_url, media_filename, message, postback_texts, instance_id
Example requests:
- "Send the order_status template to +11001234567 with the parameter '#123'"
- "Remind the customer about the appointment using the appointment_reminder template"

The method is used to send an image, video, audio file or document by URL. Supports a caption. Delivered only inside the 24-hour customer care window. Limits: images 5 MB, audio and video 16 MB, documents 100 MB.
chat_id, url, file_name, caption, instance_id
Example requests:
- "Send the PDF report from https://example.com/report.pdf"
- "Send a photo with the caption 'New Product'"

Sends a file directly via base64 upload, without first publishing the file to a URL. Delivered only inside the 24-hour customer care window.
chat_id, file_base64, filename, caption, instance_id
Example requests:
- "Send this file to the customer without uploading it to the server"

The method is used to create a message template and submit it to Meta for review. The template gets the PENDING status and can be sent only after its status changes to APPROVED. MARKETING and AUTHENTICATION templates are billed per message, UTILITY templates are cheaper.
element_name, language_code, category, template_type, vertical, content, example, header, example_header, footer, buttons, cards, media_url, enable_sample, add_security_recommendation, code_expiration_minutes, instance_id
Example requests:
- "Create a UTILITY template in English: 'Your order {{1}} has been shipped'"
- "Create a template for sending a verification code"

The method is used to edit a template in the REJECTED, APPROVED or PAUSED status. After editing, the template returns to the PENDING status until Meta reviews it again.
template_id, content, example, template_type, header, example_header, footer, buttons, media_url, category, enable_sample, allow_template_category_change, instance_id
Example requests:
- "Fix the text of the rejected template and resubmit it for review"

The method is used to return the list of account templates with their Meta review status: PENDING, APPROVED, REJECTED, FAILED or PAUSED. Can be filtered by status. Displayed as an interactive widget in clients that support MCP Apps.
status, instance_id
Example requests:
- "Show all my approved templates"
- "Which templates are still under review?"

The method is used to return a template by its ID: status, body and buttons.
template_id, instance_id
Example requests:
- "Show the template with ID 1234567890"

The method is used to delete all language versions of a template by its name.
element_name, instance_id
Example requests:
- "Delete the old_promo template"

The method is used to delete one template version by its name and ID.
element_name, template_id, instance_id
Example requests:
- "Delete the English version of the order_status template"

The method is used to load the chat message history, newest first. Returns the last 50 messages by default, 100 at most.
chat_id, count, instance_id
Example requests:
- "Show the last 20 messages from the chat with the client"

The method is used to retrieve a message by its ID in the specified chat.
chat_id, id_message, instance_id
Example requests:
- "Find the message with ID BAE5F..."

The method is used to return incoming messages for a specified period (default 60 minutes, max 1440). Helps to see which customers have an open customer care window.
minutes, instance_id
Example requests:
- "Who has written to me in the last 2 hours?"

The method is used to return outgoing messages for a specified period (default 60 minutes, max 1440) with their delivery status.
minutes, instance_id
Example requests:
- "What messages did I send in the last hour and were they delivered?"

The method is used to receive a single notification from the queue: incoming messages, template button replies, delivery statuses. Notifications are stored in the queue for up to 24 hours. Each notification must be acknowledged with waba_delete_notification, otherwise it will be received again.
instance_id
Example requests:
- "Check if there are new events in the queue"

The method is used to acknowledge processing of a notification and remove it from the queue.
receipt_id, instance_id
Example requests:
- "Confirm receipt of notification with ID 1234"

The method is used to return the list of messages waiting to be sent.
instance_id
Example requests:
- "Show the messages in the send queue"

The method is used to clear the queue of messages to be sent.
instance_id
Example requests:
- "Clear the outgoing message queue"

The method is used to call any WABA API method by name when there is no dedicated tool for it. The request parameter is passed as an object like {"method": "getMessagesCount", "httpMethod": "GET", "body": {...}}.
request, instance_id
Example requests:
- "How many messages are in the send queue?"
- "Show the list of recent chats"

The method is used to return a list of all partner instances via the Partner API.
partner_token
Example requests:
- "Show all my GREEN-API instances"

The method is used to create a new instance via the Partner API.
partner_token
Example requests:
- "Create a new instance for our bot"

The method is used to delete the specified instance via the Partner API.
instance_id, partner_token
Example requests:
- "Delete instance 9876543210"