MCP Radar
MCP Server

Green API WhatsApp

com.green-api/whatsapp
Business & Operations Communication Public & reachable MCP 2025-11-25

What this MCP does

Manages WhatsApp instances, contacts, groups, messages, notifications, chat history, and account connection state through Green API.

Capabilities

Tools

41 tools
whatsapp_add_group_participant
Add a participant to a WhatsApp group
Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_id', 'participant_chat_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Group ID'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'participant_chat_id': {'type': 'string', 'description': 'Participant chat ID (79001234567@c.us)'}}}
whatsapp_check_whatsapp
Check whether a phone number has a WhatsApp account
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'phone_number'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'phone_number': {'type': 'number', 'description': 'Phone number to check'}}}
whatsapp_connect
Connect a WhatsApp instance. Call this before using other tools. Validates credentials via getStateInstance.
Input schema 
{'type': 'object', 'required': ['instance_id', 'api_token'], 'properties': {'api_url': {'type': 'string', 'description': 'API URL (defaults to https://api.green-api.com)'}, 'api_token': {'type': 'string', 'description': 'Instance API token'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID (from console.green-api.com)'}}}
whatsapp_create_group
Create a WhatsApp group
Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_name', 'chat_ids'], 'properties': {'chat_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Participant list (chat IDs, e.g. 79001234567@c.us)'}, 'group_name': {'type': 'string', 'description': 'Group name'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_create_instance
Create a new WhatsApp instance via the GREEN-API Partner API
Open world
Input schema 
{'type': 'object', 'required': ['partner_token'], 'properties': {'partner_token': {'type': 'string', 'description': 'Partner Token from your GREEN-API dashboard'}}}
whatsapp_delete_instance
Delete a WhatsApp instance via the GREEN-API Partner API
Destructive Open world
Input schema 
{'type': 'object', 'required': ['partner_token', 'instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'Instance ID to delete'}, 'partner_token': {'type': 'string', 'description': 'Partner Token from your GREEN-API dashboard'}}}
whatsapp_delete_message
Delete a message
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'id_message'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'id_message': {'type': 'string', 'description': 'ID of the message to delete'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_delete_notification
Delete a notification from the queue (acknowledge receipt)
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'receipt_id'], 'properties': {'receipt_id': {'type': 'number', 'description': 'Notification ID (receiptId from receiveNotification)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_disconnect
Disconnect a WhatsApp instance and remove credentials from the session
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_edit_message
Edit a previously sent message
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'id_message', 'message'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'message': {'type': 'string', 'description': 'New message text'}, 'id_message': {'type': 'string', 'description': 'ID of the message to edit'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_forward_messages
Forward messages to another chat
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'chat_id_from', 'messages'], 'properties': {'chat_id': {'type': 'string', 'description': 'Destination chat ID'}, 'messages': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Message IDs to forward'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'chat_id_from': {'type': 'string', 'description': 'Source chat ID'}}}
whatsapp_get_authorization_code
Get an authorization code for sign-in by phone number
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'phone_number'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'phone_number': {'type': 'string', 'description': 'Phone number (e.g. 79001234567)'}}}
whatsapp_get_chat_history
Get chat message history. Use a small 'count' (default 50, max 100) to keep responses focused.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id'], 'properties': {'count': {'type': 'number', 'description': 'Number of messages (default 50, max 100)'}, 'chat_id': {'type': 'string', 'description': 'Chat ID (79001234567@c.us or 120363XXX@g.us)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_contact_avatar
Get the avatar of a contact or group
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id'], 'properties': {'chat_id': {'type': 'string', 'description': 'Contact or group ID'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_contact_info
Get information about a contact or group
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id'], 'properties': {'chat_id': {'type': 'string', 'description': 'Contact or group ID'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_contacts
Get the contact list
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_group_data
Get group data (members, name, invite link)
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Group ID (e.g. 120363XXX@g.us)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_instances
List all partner instances via the GREEN-API Partner API
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['partner_token'], 'properties': {'partner_token': {'type': 'string', 'description': 'Partner Token from your GREEN-API dashboard'}}}
whatsapp_get_message
Get a message by ID
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'id_message'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'id_message': {'type': 'string', 'description': 'Message ID'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_qr
Get the QR code for instance authorization. The result contains the QR as an image and a qrLink URL to an official GREEN-API page with a full-size auto-refreshing QR code. Always include the qrLink in your response as a clickable markdown link so the user can open it in the browser and scan comfortably.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_settings
Get instance settings
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_state
Get instance state (authorized, notAuthorized, blocked, sleepMode)
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_get_wa_settings
Get WhatsApp account settings (name, description, etc.)
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_last_incoming_messages
Get recent incoming messages from the last N minutes (default 60, max 1440 = 24 hours).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'minutes': {'type': 'number', 'description': 'Time window in minutes (default 60, max 1440)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_last_outgoing_messages
Get recent outgoing messages from the last N minutes (default 60, max 1440 = 24 hours).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'minutes': {'type': 'number', 'description': 'Time window in minutes (default 60, max 1440)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_leave_group
Leave a WhatsApp group
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Group ID (120363XXX@g.us)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_logout
Log out the WhatsApp instance
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_read_chat
Mark chat messages as read
Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'id_message': {'type': 'string', 'description': 'ID of a specific message (optional)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_reboot
Reboot the WhatsApp instance
Open world
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_receive_notification
Get one notification from the queue (manual polling)
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_remove_group_admin
Revoke admin rights from a group member
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_id', 'participant_chat_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Group ID (120363XXX@g.us)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'participant_chat_id': {'type': 'string', 'description': 'Participant chat ID (79001234567@c.us)'}}}
whatsapp_remove_group_participant
Remove a participant from a WhatsApp group
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_id', 'participant_chat_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Group ID'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'participant_chat_id': {'type': 'string', 'description': 'Participant chat ID (79001234567@c.us)'}}}
whatsapp_send_contact
Send a contact card via WhatsApp
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'phone_number'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'company': {'type': 'string', 'description': 'Contact company'}, 'last_name': {'type': 'string', 'description': 'Contact last name'}, 'first_name': {'type': 'string', 'description': 'Contact first name'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'phone_number': {'type': 'number', 'description': 'Contact phone number'}}}
whatsapp_send_file
Send a file by URL
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'url'], 'properties': {'url': {'type': 'string', 'description': 'File URL'}, 'caption': {'type': 'string', 'description': 'File caption'}, 'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'file_name': {'type': 'string', 'description': 'File name'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_send_file_by_upload
Send a file directly to a chat via multipart upload (no separate URL step)
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'file_base64', 'filename'], 'properties': {'caption': {'type': 'string', 'description': 'File caption (optional)'}, 'chat_id': {'type': 'string', 'description': 'Chat ID (79001234567@c.us or 120363XXX@g.us)'}, 'filename': {'type': 'string', 'description': 'File name with extension (e.g. photo.jpg)'}, 'file_base64': {'type': 'string', 'description': 'File contents encoded as base64'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_send_location
Send a location
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'latitude', 'longitude'], 'properties': {'name': {'type': 'string', 'description': 'Place name'}, 'address': {'type': 'string', 'description': 'Address'}, 'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'latitude': {'type': 'number', 'description': 'Latitude'}, 'longitude': {'type': 'number', 'description': 'Longitude'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
whatsapp_send_message
Send a text message via WhatsApp
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'message'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID (79001234567@c.us or 120363XXX@g.us)'}, 'message': {'type': 'string', 'description': 'Message text'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'link_preview': {'type': 'boolean', 'description': 'Show link previews'}, 'quoted_message_id': {'type': 'string', 'description': 'ID of the message to quote (optional)'}}}
whatsapp_send_poll
Send a poll via WhatsApp
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'chat_id', 'message', 'options'], 'properties': {'chat_id': {'type': 'string', 'description': 'Chat ID'}, 'message': {'type': 'string', 'description': 'Poll question'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Answer options (strings)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'multiple_answers': {'type': 'boolean', 'description': 'Allow multiple answers'}}}
whatsapp_set_group_admin
Promote a group member to admin
Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'group_id', 'participant_chat_id'], 'properties': {'group_id': {'type': 'string', 'description': 'Group ID (120363XXX@g.us)'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'participant_chat_id': {'type': 'string', 'description': 'Participant chat ID (79001234567@c.us)'}}}
whatsapp_set_settings
Update instance settings (webhooks, proxy, etc.)
Destructive Open world
Input schema 
{'type': 'object', 'required': ['instance_id'], 'properties': {'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}, 'webhook_url': {'type': 'string', 'description': 'URL for incoming webhooks'}, 'delay_message': {'type': 'number', 'description': 'Message send delay (ms)'}, 'state_webhook': {'type': 'boolean', 'description': 'Enable state webhook'}, 'device_webhook': {'type': 'boolean', 'description': 'Enable device webhook'}, 'incoming_webhook': {'type': 'boolean', 'description': 'Enable incoming message webhook'}, 'outgoing_webhook': {'type': 'boolean', 'description': 'Enable outgoing message webhook'}, 'webhook_url_token': {'type': 'string', 'description': 'Token for the webhook URL'}, 'status_instance_webhook': {'type': 'boolean', 'description': 'Enable instance status webhook'}, 'mark_incoming_messages_readed': {'type': 'boolean', 'description': 'Mark incoming messages as read'}}}
whatsapp_upload_file
Upload a file to GREEN-API storage and return its URL. Use the returned URL with whatsapp_send_file.
Open world
Input schema 
{'type': 'object', 'required': ['instance_id', 'file_base64', 'filename'], 'properties': {'filename': {'type': 'string', 'description': 'File name with extension (e.g. photo.jpg)'}, 'file_base64': {'type': 'string', 'description': 'File contents encoded as base64'}, 'instance_id': {'type': 'number', 'description': 'WhatsApp instance ID'}}}
History

Recent tool changes

Added
whatsapp_upload_file
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_set_settings
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_set_group_admin
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_send_poll
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_send_message
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_send_location
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_send_file_by_upload
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_send_file
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_send_contact
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_remove_group_participant
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_remove_group_admin
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_receive_notification
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_reboot
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_read_chat
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_logout
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_leave_group
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_last_outgoing_messages
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_last_incoming_messages
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_wa_settings
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_state
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_settings
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_qr
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_message
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_instances
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_group_data
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_contacts
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_contact_info
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_contact_avatar
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_chat_history
Sept. 17, 2026, 12:35 p.m.
Added
whatsapp_get_authorization_code
Sept. 17, 2026, 12:35 p.m.
Discover

Similar MCP servers

独行录 / opcmenu

io.github.yzlee/opcmenu

Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…

Odichat

io.github.odichat/mcp-odichat

Manages WhatsApp, Instagram, and Facebook inboxes with contacts, conversations, agents, automation rules, labels, canned response…

KaiCalls

com.kaicalls/kaicalls

Provides AI phone reception, outbound calling campaigns, call transcripts and recordings, lead management, routing, staff alerts,…

anima

io.github.anima-labs-ai/anima

Provides agent-owned email inboxes, phone and SMS identities, email drafting and sending, message search and threading, domains, …

agendaforge

app.agendaforge/agendaforge

Manages events, agendas, sessions, speakers, attendees, sponsors, forms, contacts, email templates, approvals, and organizer work…

Asyntai

com.asyntai/support-agent

Manages website AI support agents, their knowledge bases, conversations, live replies, leads, products, webhooks, analytics, and …

ikeytz – Schlüsseldienst Ludwigsburg

com.ikeytz/website

Publishes read-only business information, locksmith pricing and service details, and links for phone, email, and WhatsApp contact.

mailbox

bot.mailbox/mailbox

Manages physical inbound and outbound mail, postal fulfillment, OCR-backed mail context, facility messaging, delivery tracking, c…