Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "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}"
      }
    }
  }
}

claude mcp add --transport http whatsapp https://mcp.green-api.com/mcp --header "X-Instance-Id: ${X_INSTANCE_ID}" --header "X-Api-Token: ${X_API_TOKEN}" --header "Authorization: ${X_INSTANCE_ID}"

[mcp_servers.whatsapp]
url = "https://mcp.green-api.com/mcp"
env_http_headers = { "X-Instance-Id" = "X_INSTANCE_ID", "X-Api-Token" = "X_API_TOKEN", "Authorization" = "X_INSTANCE_ID" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "whatsapp": {
      "type": "remote",
      "url": "https://mcp.green-api.com/mcp",
      "enabled": true,
      "headers": {
        "X-Instance-Id": "{env:X_INSTANCE_ID}",
        "X-Api-Token": "{env:X_API_TOKEN}",
        "Authorization": "{env:X_INSTANCE_ID}"
      }
    }
  }
}

{
  "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}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=whatsapp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLmdyZWVuLWFwaS5jb20vbWNwIiwiaGVhZGVycyI6eyJYLUluc3RhbmNlLUlkIjoiJHtYX0lOU1RBTkNFX0lEfSIsIlgtQXBpLVRva2VuIjoiJHtYX0FQSV9UT0tFTn0iLCJBdXRob3JpemF0aW9uIjoiJHtYX0lOU1RBTkNFX0lEfSJ9fQ%3D%3D"
}

{
  "servers": {
    "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}"
      }
    }
  }
}

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

extensions:
  "whatsapp":
    enabled: true
    name: "whatsapp"
    type: streamable_http
    uri: "https://mcp.green-api.com/mcp"
    headers:
      "X-Instance-Id": "${X_INSTANCE_ID}"
      "X-Api-Token": "${X_API_TOKEN}"
      "Authorization": "${X_INSTANCE_ID}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_INSTANCE_ID}, ${X_API_TOKEN}, ${X_INSTANCE_ID}. The registry never accepts secret values.

Quality 88 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

warn
tools.descriptions4 of 41 tools have a description under 20 characters
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations41 of 41 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 4,784 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

41 tools, about 4,784 tokens to load them all · tool set 784ccab6fef8 · checked 2026-10-20 17:34 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance90

liveness100

freshness65

hygiene100

+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. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.green-api.com/mcp` streamable-http	api_key `${X_INSTANCE_ID}`	yes	99%	959 ms	2025-11-25	2026-10-20
`https://mcp.green-api.com/sse` sse	api_key `${X_INSTANCE_ID}`	yes	100%	851 ms	2025-11-25	2026-10-20

Tools (41)

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

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "com.green-api/whatsapp",
  "title": "Green API WhatsApp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.green-api.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-Instance-Id",
          "isSecret": true,
          "isRequired": true,
          "description": "Green API instance ID"
        },
        {
          "name": "X-Api-Token",
          "isSecret": true,
          "isRequired": true,
          "description": "Green API instance token"
        }
      ]
    },
    {
      "url": "https://mcp.green-api.com/sse",
      "type": "sse",
      "headers": [
        {
          "name": "X-Instance-Id",
          "isSecret": true,
          "isRequired": true,
          "description": "Green API instance ID"
        },
        {
          "name": "X-Api-Token",
          "isSecret": true,
          "isRequired": true,
          "description": "Green API instance token"
        }
      ]
    }
  ],
  "version": "0.1.2",
  "repository": {
    "url": "https://github.com/green-api/green-api-mcp-gateway",
    "source": "github"
  },
  "description": "MCP gateway for WhatsApp via Green API: messaging, contacts, groups and instance management."
}