Green API WhatsApp

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

MCP gateway for WhatsApp via Green API: messaging, contacts, groups and instance management.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Green API WhatsApp": {
      "url": "https://mcp.green-api.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (41)

• whatsapp_add_group_participant

  Add a participant to a WhatsApp group

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_id (required) — string — Group ID
  • participant_chat_id (required) — string — Participant chat ID ([email protected])

  Hints: read-only no · destructive no · idempotent no · open-world yes

• whatsapp_check_whatsapp read-only

  Check whether a phone number has a WhatsApp account

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • phone_number (required) — number — Phone number to check

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_connect

  Connect a WhatsApp instance. Call this before using other tools. Validates credentials via getStateInstance.

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID (from console.green-api.com)
  • api_token (required) — string — Instance API token
  • api_url — string — API URL (defaults to https://api.green-api.com)

  Hints: read-only no · destructive no · idempotent no · open-world no

• whatsapp_create_group

  Create a WhatsApp group

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_name (required) — string — Group name
  • chat_ids (required) — array — Participant list (chat IDs, e.g. [email protected])

  Hints: read-only no · destructive no · idempotent no · open-world yes

• whatsapp_create_instance

  Create a new WhatsApp instance via the GREEN-API Partner API

  Parameters:

  • partner_token (required) — string — Partner Token from your GREEN-API dashboard

  Hints: read-only no · destructive no · idempotent no · open-world yes

• whatsapp_delete_instance destructive

  Delete a WhatsApp instance via the GREEN-API Partner API

  Parameters:

  • partner_token (required) — string — Partner Token from your GREEN-API dashboard
  • instance_id (required) — number — Instance ID to delete

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_delete_message destructive

  Delete a message

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • id_message (required) — string — ID of the message to delete

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_delete_notification destructive

  Delete a notification from the queue (acknowledge receipt)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • receipt_id (required) — number — Notification ID (receiptId from receiveNotification)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_disconnect

  Disconnect a WhatsApp instance and remove credentials from the session

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only no · destructive no · idempotent no · open-world no

• whatsapp_edit_message destructive

  Edit a previously sent message

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • id_message (required) — string — ID of the message to edit
  • message (required) — string — New message text

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_forward_messages destructive

  Forward messages to another chat

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Destination chat ID
  • chat_id_from (required) — string — Source chat ID
  • messages (required) — array — Message IDs to forward

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_get_authorization_code read-only

  Get an authorization code for sign-in by phone number

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • phone_number (required) — string — Phone number (e.g. 79001234567)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_chat_history read-only

  Get chat message history. Use a small 'count' (default 50, max 100) to keep responses focused.

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID ([email protected] or [email protected])
  • count — number — Number of messages (default 50, max 100)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_contact_avatar read-only

  Get the avatar of a contact or group

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Contact or group ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_contact_info read-only

  Get information about a contact or group

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Contact or group ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_contacts read-only

  Get the contact list

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_group_data read-only

  Get group data (members, name, invite link)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_id (required) — string — Group ID (e.g. [email protected])

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_instances read-only

  List all partner instances via the GREEN-API Partner API

  Parameters:

  • partner_token (required) — string — Partner Token from your GREEN-API dashboard

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_message read-only

  Get a message by ID

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • id_message (required) — string — Message ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_qr read-only

  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.

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_settings read-only

  Get instance settings

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_state read-only

  Get instance state (authorized, notAuthorized, blocked, sleepMode)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_get_wa_settings read-only

  Get WhatsApp account settings (name, description, etc.)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_last_incoming_messages read-only

  Get recent incoming messages from the last N minutes (default 60, max 1440 = 24 hours).

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • minutes — number — Time window in minutes (default 60, max 1440)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_last_outgoing_messages read-only

  Get recent outgoing messages from the last N minutes (default 60, max 1440 = 24 hours).

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • minutes — number — Time window in minutes (default 60, max 1440)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_leave_group destructive

  Leave a WhatsApp group

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_id (required) — string — Group ID ([email protected])

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_logout destructive

  Log out the WhatsApp instance

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_read_chat

  Mark chat messages as read

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • id_message — string — ID of a specific message (optional)

  Hints: read-only no · destructive no · idempotent no · open-world yes

• whatsapp_reboot

  Reboot the WhatsApp instance

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only no · destructive no · idempotent no · open-world yes

• whatsapp_receive_notification read-only

  Get one notification from the queue (manual polling)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• whatsapp_remove_group_admin destructive

  Revoke admin rights from a group member

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_id (required) — string — Group ID ([email protected])
  • participant_chat_id (required) — string — Participant chat ID ([email protected])

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_remove_group_participant destructive

  Remove a participant from a WhatsApp group

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_id (required) — string — Group ID
  • participant_chat_id (required) — string — Participant chat ID ([email protected])

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_send_contact destructive

  Send a contact card via WhatsApp

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • phone_number (required) — number — Contact phone number
  • company — string — Contact company
  • last_name — string — Contact last name
  • first_name — string — Contact first name

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_send_file destructive

  Send a file by URL

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • url (required) — string — File URL
  • caption — string — File caption
  • file_name — string — File name

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_send_file_by_upload destructive

  Send a file directly to a chat via multipart upload (no separate URL step)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID ([email protected] or [email protected])
  • file_base64 (required) — string — File contents encoded as base64
  • filename (required) — string — File name with extension (e.g. photo.jpg)
  • caption — string — File caption (optional)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_send_location destructive

  Send a location

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • latitude (required) — number — Latitude
  • longitude (required) — number — Longitude
  • name — string — Place name
  • address — string — Address

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_send_message destructive

  Send a text message via WhatsApp

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID ([email protected] or [email protected])
  • message (required) — string — Message text
  • link_preview — boolean — Show link previews
  • quoted_message_id — string — ID of the message to quote (optional)

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_send_poll destructive

  Send a poll via WhatsApp

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • chat_id (required) — string — Chat ID
  • message (required) — string — Poll question
  • options (required) — array — Answer options (strings)
  • multiple_answers — boolean — Allow multiple answers

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_set_group_admin

  Promote a group member to admin

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • group_id (required) — string — Group ID ([email protected])
  • participant_chat_id (required) — string — Participant chat ID ([email protected])

  Hints: read-only no · destructive no · idempotent no · open-world yes

• whatsapp_set_settings destructive

  Update instance settings (webhooks, proxy, etc.)

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • webhook_url — string — URL for incoming webhooks
  • delay_message — number — Message send delay (ms)
  • state_webhook — boolean — Enable state webhook
  • device_webhook — boolean — Enable device webhook
  • incoming_webhook — boolean — Enable incoming message webhook
  • outgoing_webhook — boolean — Enable outgoing message webhook
  • webhook_url_token — string — Token for the webhook URL
  • status_instance_webhook — boolean — Enable instance status webhook
  • mark_incoming_messages_readed — boolean — Mark incoming messages as read

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• whatsapp_upload_file

  Upload a file to GREEN-API storage and return its URL. Use the returned URL with whatsapp_send_file.

  Parameters:

  • instance_id (required) — number — WhatsApp instance ID
  • file_base64 (required) — string — File contents encoded as base64
  • filename (required) — string — File name with extension (e.g. photo.jpg)

  Hints: read-only no · destructive no · idempotent no · open-world yes

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.