# Green API WhatsApp

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

- name: com.green-api/whatsapp
- version: 0.1.2
- connection class: R1 (autonomous)
- trust: 90/100
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.green-api%2Fwhatsapp
- tools: https://api.protogrid.dev/v1/servers/com.green-api%2Fwhatsapp/tools

**An agent can connect on its own if it already holds `X_INSTANCE_ID`, `X_API_TOKEN`, `X_INSTANCE_ID`.** Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "whatsapp": {
      "type": "http",
      "url": "https://mcp.green-api.com/mcp",
      "headers": {
        "X-Instance-Id": "${X_INSTANCE_ID}",
        "X-Api-Token": "${X_API_TOKEN}",
        "Authorization": "${X_INSTANCE_ID}"
      }
    }
  }
}
```

Placeholders to fill: `${X_INSTANCE_ID}`, `${X_API_TOKEN}`, `${X_INSTANCE_ID}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 65
- provenance: 90
- drivers: +repository +namespace-matches-repo +dns-namespace +reachable +uptime-100% ~updated-96d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- warn `tools.descriptions`: 4 of 41 tools have a description under 20 characters
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 41 of 41 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 4,784 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 41, about 4,784 tokens to load them all
- tool set hash: 784ccab6fef820a1bd6979fc7fb77ca7
- badge: [![protogrid quality](https://protogrid.dev/badge/com.green-api/whatsapp.svg)](https://protogrid.dev/servers/com.green-api/whatsapp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.green-api.com/mcp (streamable-http, auth api_key ${X_INSTANCE_ID}, reachable true, uptime30d 0.99159664)
- https://mcp.green-api.com/sse (sse, auth api_key ${X_INSTANCE_ID}, reachable true, uptime30d 1)

## Packages

_none_

## Tools (41)

- `whatsapp_add_group_participant`: Add a participant to a WhatsApp group
- `whatsapp_check_whatsapp`: Check whether a phone number has a WhatsApp account
- `whatsapp_connect`: Connect a WhatsApp instance. Call this before using other tools. Validates credentials via getStateInstance.
- `whatsapp_create_group`: Create a WhatsApp group
- `whatsapp_create_instance`: Create a new WhatsApp instance via the GREEN-API Partner API
- `whatsapp_delete_instance`: Delete a WhatsApp instance via the GREEN-API Partner API
- `whatsapp_delete_message`: Delete a message
- `whatsapp_delete_notification`: Delete a notification from the queue (acknowledge receipt)
- `whatsapp_disconnect`: Disconnect a WhatsApp instance and remove credentials from the session
- `whatsapp_edit_message`: Edit a previously sent message
- `whatsapp_forward_messages`: Forward messages to another chat
- `whatsapp_get_authorization_code`: Get an authorization code for sign-in by phone number
- `whatsapp_get_chat_history`: Get chat message history. Use a small 'count' (default 50, max 100) to keep responses focused.
- `whatsapp_get_contact_avatar`: Get the avatar of a contact or group
- `whatsapp_get_contact_info`: Get information about a contact or group
- `whatsapp_get_contacts`: Get the contact list
- `whatsapp_get_group_data`: Get group data (members, name, invite link)
- `whatsapp_get_instances`: List all partner instances via the GREEN-API Partner API
- `whatsapp_get_message`: Get a message by 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.
- `whatsapp_get_settings`: Get instance settings
- `whatsapp_get_state`: Get instance state (authorized, notAuthorized, blocked, sleepMode)
- `whatsapp_get_wa_settings`: Get WhatsApp account settings (name, description, etc.)
- `whatsapp_last_incoming_messages`: Get recent incoming messages from the last N minutes (default 60, max 1440 = 24 hours).
- `whatsapp_last_outgoing_messages`: Get recent outgoing messages from the last N minutes (default 60, max 1440 = 24 hours).
- `whatsapp_leave_group`: Leave a WhatsApp group
- `whatsapp_logout`: Log out the WhatsApp instance
- `whatsapp_read_chat`: Mark chat messages as read
- `whatsapp_reboot`: Reboot the WhatsApp instance
- `whatsapp_receive_notification`: Get one notification from the queue (manual polling)
- `whatsapp_remove_group_admin`: Revoke admin rights from a group member
- `whatsapp_remove_group_participant`: Remove a participant from a WhatsApp group
- `whatsapp_send_contact`: Send a contact card via WhatsApp
- `whatsapp_send_file`: Send a file by URL
- `whatsapp_send_file_by_upload`: Send a file directly to a chat via multipart upload (no separate URL step)
- `whatsapp_send_location`: Send a location
- `whatsapp_send_message`: Send a text message via WhatsApp
- `whatsapp_send_poll`: Send a poll via WhatsApp
- `whatsapp_set_group_admin`: Promote a group member to admin
- `whatsapp_set_settings`: Update instance settings (webhooks, proxy, etc.)
- `whatsapp_upload_file`: Upload a file to GREEN-API storage and return its URL. Use the returned URL with whatsapp_send_file.