GREEN-API WhatsApp
Servidor MCP de GREEN-API
Envía mensajes de WhatsApp, gestiona grupos y contactos, y administra instancias de GREEN-API desde un asistente de IA.
Conectar con GREEN-API WhatsApp
GREEN-API WhatsApp requiere una clave de API. Conéctate con su propia URL y tu clave:
Envía tu clave en la cabecera X-Instance-Id. mcp.tc nunca ve ni guarda claves. Dónde conseguir una clave
Compartir este servidor
El enlace abre esta página, con la URL y los pasos de configuración.
mcp.tc/i/green-api-whatsappDescripción
Conecta un asistente con WhatsApp a través de GREEN-API. Puede enviar texto, archivos, ubicaciones, contactos y encuestas, editar, reenviar y eliminar mensajes, leer el historial de chats y los mensajes recientes, gestionar grupos, comprobar si unos números tienen WhatsApp y gestionar instancias, incluida la Partner API para crearlas y eliminarlas.
Funciona como un endpoint alojado Streamable HTTP (con un endpoint SSE heredado), o como un binario local de Go mediante stdio. El endpoint alojado recibe el ID y el token de instancia de GREEN-API en las cabeceras X-Instance-Id y X-Api-Token. El README también menciona un flujo OAuth integrado en modo proxy.
Qué puedes hacer
- Enviar texto, archivos, ubicaciones, contactos y encuestas
- Editar, reenviar y eliminar mensajes
- Leer el historial de chats y los mensajes entrantes o salientes recientes
- Crear grupos y gestionar participantes y administradores
- Comprobar si unos números de teléfono tienen WhatsApp
- Ver y actualizar los ajustes, el estado y el código QR de la instancia
- Crear, listar y eliminar instancias de partner
Herramientas 41
whatsapp_add_group_participantEscrituraAñadir un participante a un grupo de WhatsApp
whatsapp_check_whatsappSolo lecturaComprobar si un número de teléfono tiene una cuenta de WhatsApp
whatsapp_connectEscrituraConectar una instancia de WhatsApp y validar las credenciales
whatsapp_create_groupEscrituraCrear un grupo de WhatsApp
whatsapp_create_instanceEscrituraCrear una nueva instancia mediante la Partner API
whatsapp_delete_instancePuede borrarEliminar una instancia mediante la Partner API
whatsapp_delete_messagePuede borrarEliminar un mensaje
whatsapp_delete_notificationPuede borrarEliminar una notificación de la cola
whatsapp_disconnectEscrituraDesconectar una instancia y quitar sus credenciales de la sesión
whatsapp_edit_messagePuede borrarEditar un mensaje enviado anteriormente
whatsapp_forward_messagesPuede borrarReenviar mensajes a otro chat
whatsapp_get_authorization_codeSolo lecturaObtener un código de autorización para iniciar sesión con número de teléfono
Mostrar 29 herramientas más
whatsapp_get_chat_historySolo lecturaObtener el historial de mensajes de un chat
whatsapp_get_contact_avatarSolo lecturaObtener el avatar de un contacto o grupo
whatsapp_get_contact_infoSolo lecturaObtener información sobre un contacto o grupo
whatsapp_get_contactsSolo lecturaObtener la lista de contactos
whatsapp_get_group_dataSolo lecturaObtener los miembros, el nombre y el enlace de invitación de un grupo
whatsapp_get_instancesSolo lecturaListar las instancias de partner
whatsapp_get_messageSolo lecturaObtener un mensaje por ID
whatsapp_get_qrSolo lecturaObtener el código QR para autorizar la instancia
whatsapp_get_settingsSolo lecturaObtener los ajustes de la instancia
whatsapp_get_stateSolo lecturaObtener el estado de la instancia, como autorizada o bloqueada
whatsapp_get_wa_settingsSolo lecturaObtener los ajustes de la cuenta de WhatsApp
whatsapp_last_incoming_messagesSolo lecturaObtener los mensajes entrantes de los últimos N minutos
whatsapp_last_outgoing_messagesSolo lecturaObtener los mensajes salientes de los últimos N minutos
whatsapp_leave_groupPuede borrarSalir de un grupo de WhatsApp
whatsapp_logoutPuede borrarCerrar la sesión de la instancia de WhatsApp
whatsapp_read_chatEscrituraMarcar como leídos los mensajes de un chat
whatsapp_rebootEscrituraReiniciar la instancia de WhatsApp
whatsapp_receive_notificationSolo lecturaObtener una notificación de la cola mediante polling
whatsapp_remove_group_adminPuede borrarRevocar los derechos de administrador a un miembro del grupo
whatsapp_remove_group_participantPuede borrarQuitar a un participante de un grupo
whatsapp_send_contactPuede borrarEnviar una tarjeta de contacto
whatsapp_send_filePuede borrarEnviar un archivo por URL
whatsapp_send_file_by_uploadPuede borrarEnviar un archivo directamente mediante carga multipart
whatsapp_send_locationPuede borrarEnviar una ubicación
whatsapp_send_messagePuede borrarEnviar un mensaje de texto
whatsapp_send_pollPuede borrarEnviar una encuesta
whatsapp_set_group_adminEscrituraPromover a administrador a un miembro del grupo
whatsapp_set_settingsPuede borrarActualizar los ajustes de la instancia, como los webhooks
whatsapp_upload_fileEscrituraSubir archivo
Leídas del servidor en funcionamiento el 18 nov 2026. Solo lectura, Escritura y Puede borrar son indicaciones que declara el servidor; tu cliente decide si te pregunta antes de ejecutar una herramienta.
Prompts de ejemplo
Envía un mensaje de WhatsApp a 15551234567 diciendo que el pedido ha sido enviado
Muestra los mensajes recibidos en las últimas 2 horas
Crea un grupo de WhatsApp llamado Project Team con estos números
Comprueba si +49 170 1234567 tiene WhatsApp
Configuración
Todos los clientes se conectan a mcp.green-api.com. Elige el tuyo; la página recuerda tu elección.
Claude Code
- Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport http green-api-whatsapp https://mcp.green-api.com/mcp --header "X-Instance-Id: <YOUR_X_INSTANCE_ID>" --header "X-Api-Token: <YOUR_X_API_TOKEN>"- Sustituye el marcador por tu clave antes de ejecutarlo, y después compruébalo con
/mcpdentro de Claude Code.
Añade --scope user para que esté disponible en todos los proyectos, no solo en este.
Claude Desktop
- Usa el puente
mcp-remote, que guarda la clave en este equipo (un conector añadido en claude.ai con la clave en Request headers también aparece aquí). Abre Settings → Developer → Edit Config y añade:
{
"mcpServers": {
"green-api-whatsapp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.green-api.com/mcp",
"--header",
"X-Instance-Id: <YOUR_X_INSTANCE_ID>",
"--header",
"X-Api-Token: <YOUR_X_API_TOKEN>"
]
}
}
}- Sustituye el marcador por tu clave y reinicia Claude Desktop.
El puente necesita Node.js en tu equipo.
claude.ai
- Abre el formulario de conectores en claude.ai. Este botón rellena el nombre y la URL por ti:
Añadir a claude.ai (se abre en una pestaña nueva)
- Comprueba que la URL es
https://mcp.green-api.com/mcp. En Request headers, añadeX-Instance-Id: <YOUR_X_INSTANCE_ID>yX-Api-Token: <YOUR_X_API_TOKEN>con tu clave de GREEN-API y luego haz clic en Add. - Actívalo en un chat desde el menú de herramientas.
Los planes gratuitos permiten un conector personalizado. En los planes Team y Enterprise lo añade un propietario en Organization settings → Connectors.
Cursor
Añadir a Cursor (se abre en una pestaña nueva)
O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):
{
"mcpServers": {
"green-api-whatsapp": {
"url": "https://mcp.green-api.com/mcp",
"headers": {
"X-Instance-Id": "<YOUR_X_INSTANCE_ID>",
"X-Api-Token": "<YOUR_X_API_TOKEN>"
}
}
}
}VS Code
Añádelo a .vscode/mcp.json. VS Code pide la clave la primera vez y la guarda de forma segura:
{
"servers": {
"green-api-whatsapp": {
"type": "http",
"url": "https://mcp.green-api.com/mcp",
"headers": {
"X-Instance-Id": "${input:x-instance-id}",
"X-Api-Token": "${input:x-api-token}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "x-instance-id",
"description": "X-Instance-Id",
"password": true
},
{
"type": "promptString",
"id": "x-api-token",
"description": "X-Api-Token",
"password": true
}
]
}Devin Desktop
- Añádelo a
~/.config/devin/mcp_config.json(macOS y Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"green-api-whatsapp": {
"serverUrl": "https://mcp.green-api.com/mcp",
"headers": {
"X-Instance-Id": "<YOUR_X_INSTANCE_ID>",
"X-Api-Token": "<YOUR_X_API_TOKEN>"
}
}
}
}- Actualiza la lista de servidores MCP en Cascade.
Devin Desktop es el nuevo nombre de Windsurf. Para los servidores remotos lee serverUrl (o url).
Codex
codex mcp add green-api-whatsapp --url https://mcp.green-api.com/mcpcodex mcp add no puede definir las cabeceras X-Instance-Id y X-Api-Token, así que este paso es obligatorio: pon esta entrada en ~/.codex/config.toml en lugar de ejecutar el comando, o añade su línea env_http_headers a la entrada que creó el comando:
[mcp_servers.green-api-whatsapp]
url = "https://mcp.green-api.com/mcp"
env_http_headers = { "X-Instance-Id" = "X_INSTANCE_ID", "X-Api-Token" = "X_API_TOKEN" }Codex lee los valores de las cabeceras de las variables de entorno indicadas en env_http_headers.
Gemini CLI
gemini mcp add --transport http --header "X-Instance-Id: <YOUR_X_INSTANCE_ID>" --header "X-Api-Token: <YOUR_X_API_TOKEN>" green-api-whatsapp https://mcp.green-api.com/mcpAsí lo añades al proyecto actual. Añade -s user para usarlo en todas partes.
Cualquier cliente
La mayoría de los clientes aceptan esta forma. Algunos llaman de otra manera al campo de la URL: serverUrl en Devin Desktop, httpUrl en el archivo de ajustes de Gemini CLI.
{
"mcpServers": {
"green-api-whatsapp": {
"type": "http",
"url": "https://mcp.green-api.com/mcp",
"headers": {
"X-Instance-Id": "<YOUR_X_INSTANCE_ID>",
"X-Api-Token": "<YOUR_X_API_TOKEN>"
}
}
}
}Zed pone los servidores bajo context_servers en sus ajustes. Cline necesita "type": "streamableHttp"; si no, supone SSE.
¿Tu cliente solo inicia servidores locales? Conéctalo con npx -y mcp-remote https://mcp.green-api.com/mcp.
Insertar
Muestra GREEN-API WhatsApp en un README o en tu web. Cada inserción enlaza a esta página, usa la URL propia del servidor y no instala cookies. Cómo funcionan las inserciones
La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.
Insignia para README
[](https://mcp.tc/i/green-api-whatsapp)<a href="https://mcp.tc/i/green-api-whatsapp"><img src="https://mcp.tc/i/green-api-whatsapp/badge.svg" alt="GREEN-API WhatsApp on mcp.tc" height="20"></a>Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.
Tarjeta para web
<script src="https://mcp.tc/w/green-api-whatsapp.js" async></script>La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.
iframe
<iframe src="https://mcp.tc/embed/green-api-whatsapp" title="GREEN-API WhatsApp on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.
JSON
La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, la URL propia del servidor, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).
https://mcp.tc/i/green-api-whatsapp.jsonPrompt para la IA
Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de GREEN-API WhatsApp a tu web.
Añade a mi web la tarjeta de mcp.tc de GREEN-API WhatsApp, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.
Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:
```html
<script src="https://mcp.tc/w/green-api-whatsapp.js" async></script>
```
Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.
```html
<div data-mcptc="green-api-whatsapp"><a href="https://mcp.tc/i/green-api-whatsapp">GREEN-API WhatsApp on mcp.tc</a></div>
```
Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.
Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).
Para un README u otra documentación en Markdown, usa la insignia:
```markdown
[](https://mcp.tc/i/green-api-whatsapp)
```
Referencia: https://mcp.tc/es/embedHistorial de cambios
Sus herramientas requieren iniciar sesión, así que no podemos leerlas. Aquí aparecen las ediciones de su responsable.
Preguntas frecuentes
¿Puedo pegar mcp.tc/i/green-api-whatsapp en mi cliente MCP?
No. Los enlaces de mcp.tc son páginas, no direcciones de servidores. Conéctate con https://mcp.green-api.com/mcp, para que tu cliente hable directamente con GREEN-API WhatsApp. Tu clave también va ahí, nunca a mcp.tc. El enlace rápido sirve para compartir: abre esta página, con los pasos de configuración para cada cliente.
¿GREEN-API WhatsApp necesita una clave de API o iniciar sesión?
Sí. GREEN-API WhatsApp necesita una clave de API, enviada en la cabecera X-Instance-Id. Consíguela en GREEN-API y guárdala en la configuración de tu cliente, nunca en un archivo compartido.
¿GREEN-API WhatsApp es un servidor remoto o local?
Remoto. Lo aloja GREEN-API en https://mcp.green-api.com/mcp, y usa Streamable HTTP. No hay nada que instalar.
¿Qué puede hacer GREEN-API WhatsApp?
Tiene 41 herramientas, entre ellas whatsapp_add_group_participant, whatsapp_check_whatsapp y whatsapp_connect. Puedes enviar texto, archivos, ubicaciones, contactos y encuestas, editar, reenviar y eliminar mensajes y leer el historial de chats y los mensajes entrantes o salientes recientes.
¿Qué clientes pueden usarlo?
Cualquier cliente compatible con servidores MCP remotos que pueda enviar tu clave: Claude Code, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. En claude.ai y Claude Desktop, añade la clave como cabecera de la solicitud al crear el conector personalizado. ChatGPT no puede enviar una clave, así que no puede usarlo.
¿mcp.tc sigue los cambios de GREEN-API WhatsApp?
En parte. Las herramientas de GREEN-API WhatsApp requieren iniciar sesión, así que su pestaña Historial solo muestra las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.
¿Quién escribió esta página?
El robot de mcp.tc leyó los metadatos propios de GREEN-API WhatsApp (su handshake MCP, su lista de herramientas y sus páginas públicas), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.
mcp.tc no tiene relación con GREEN-API. Esta página se creó a partir de los metadatos públicos de GREEN-API WhatsApp, comprobados por última vez el 18 nov 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.