---
title: "MCP WhatsApp: conecta tu agente de IA con un comando"
description: "El MCP de WAME le da a tu agente de IA acceso real a WhatsApp, Instagram y Messenger: leer conversaciones, responder, enviar archivos, crear plantillas y gestionar grupos. Un comando para conectar, 21 herramientas listas."
url: "https://api-wa.me/es/blog/mcp-agente-ia-whatsapp"
language: "es"
og:type: "article"
og:site_name: "WAME API"
---

[Inicio](https://api-wa.me/es)/[Blog de la API de WhatsApp](https://api-wa.me/es/blog)/Conecta tu agente de IA a WhatsApp: MCP en la práctica (Claude, Cursor y n8n)

Raphael Serafim· Publicado el 10 de septiembre de 2026· 8 min de lectura

Compartir

# Conecta tu agente de IA a WhatsApp: MCP en la práctica (Claude, Cursor y n8n)

El MCP de WAME le da a tu agente de IA acceso real a WhatsApp, Instagram y Messenger: leer conversaciones, responder, enviar archivos, crear plantillas y gestionar grupos. Un comando para conectar, 21 herramientas listas.

Copiar para LLM[Ver como Markdown](https://api-wa.me/es/blog/mcp-agente-ia-whatsapp.md)

**El trabajo de conectar una IA a WhatsApp siempre fue el mismo: escribir la integración.** Definir las funciones, describirle cada parámetro al modelo, tratar la respuesta, mantener eso vivo cuando la API cambia. Media semana de trabajo antes de que salga el primer mensaje.

El MCP corta esa etapa. WAME publica un servidor **Model Context Protocol** en `https://mcp.wame.api.br`, y tu agente descubre solo lo que puede hacer.

## Qué cambia en la práctica

Sin MCP, escribes algo así para cada capacidad que el agente necesita:

javascript

Copiar

```
const tools = [{
  name: 'enviar_whatsapp',
  description: 'Envía un mensaje de texto por WhatsApp',
  parameters: {
    type: 'object',
    properties: {
      to: { type: 'string', description: 'Número con código de país' },
      text: { type: 'string' },
    },
    required: ['to', 'text'],
  },
}];
// ...y el handler que realmente llama a la API, y el manejo de errores,
// y lo mismo otra vez para leer conversaciones, enviar archivos, crear grupos…
```

Con MCP no escribes nada de eso. El servidor ya declara las herramientas, y el agente las lee al conectarse.

## Conectar

En **Claude Code**, un comando:

bash

Copiar

```
claude mcp add --transport http wame https://mcp.wame.api.br
```

En **Cursor**, **Claude Desktop** o cualquier cliente con interfaz de MCP, el camino es el mismo: agregar un servidor HTTP y pegar `https://mcp.wame.api.br`. El cliente pide la autorización de tu instancia y listo.

Después de eso, conversas:

> "Fíjate si alguien del equipo comercial quedó sin respuesta hoy y muéstramelo."

Y el agente llama a `find_pending_replies` y `list_chats` por su cuenta. Tú no elegiste la herramienta — la eligió él.

## Las 21 herramientas

Cubren el ciclo entero de una conversación, no solo el envío:

**Conversar**

| Herramienta | Parámetros | Qué hace |
| --- | --- | --- |
| `send_message` | `to`, `text`, `channel?` | Envía texto en el canal elegido |
| `send_media` | `to`, `type`, `url`, `caption?` | Imagen, video, audio, documento |
| `reply_to_message` | `messageId`, `to`, `text` | Responde citando el mensaje |
| `react_to_message` | `messageId`, `emoji` | Reacciona con un emoji |
| `set_typing` | `to`, `status` | Muestra "escribiendo…" |

**Leer y entender**

| Herramienta | Parámetros | Qué hace |
| --- | --- | --- |
| `list_chats` | `limit?`, `onlyUnread?` | Lista las conversaciones |
| `read_messages` | `chatId`, `limit?`, `page?` | Lee el historial de una conversación |
| `wait_for_message` | `timeoutSeconds?`, `chatId?` | Espera a que llegue el próximo mensaje |
| `find_contact` | `query` | Encuentra el número por el nombre |
| `check_number_registered` | `number` | Verifica si el número tiene WhatsApp |
| `mark_as_read` | `messageId`, `typing?` | Marca como leído |

**Operar**

| Herramienta | Parámetros | Qué hace |
| --- | --- | --- |
| `get_instance_status` | — | Estado de la conexión |
| `list_templates` | `onlyApproved?` | Plantillas disponibles |
| `send_template` | `templateName`, `recipients[]`, `confirm?` | Dispara una plantilla aprobada |
| `get_analytics` | `report?`, `since?`, `until?` | Métricas de atención |

**Grupos**

`list_groups`, `get_group`, `create_group`, `update_group`, `manage_group_participants`, `leave_group` — crear grupo, entrar, salir, agregar y quitar participantes.

## Tres canales, el mismo agente

`send_message` acepta `channel`. Eso no es un detalle de API: es consecuencia de que WAME entrega **WhatsApp, Instagram Direct y Messenger en la misma instancia**, con un único formato de webhook.

El agente que responde en WhatsApp responde en el Direct de Instagram sin una línea más. Si ya leíste sobre [los tres canales en la misma API](https://api-wa.me/es/blog/api-instagram-messenger-misma-api-whatsapp), es la misma instancia — ahora accesible por IA.

## Dónde sirve de verdad

**Triaje de la bandeja de entrada.** "¿Qué conversaciones de ayer quedaron sin respuesta y de qué se trata cada una?" El agente lee, resume y devuelve una lista. Nadie abre 40 conversaciones a mano.

**Operación asistida.** "Mándale el comprobante en PDF al cliente que preguntó por la factura." Encuentra el contacto, ubica el mensaje y envía el archivo.

**Apoyo a quien desarrolla.** Dentro de Cursor o Claude Code, con el MCP conectado, puedes probar el comportamiento real de la API mientras escribes el código que va a usarla. El agente manda el mensaje de prueba, lee lo que llegó y comparas con lo que tu handler esperaba.

**Automatización en flujo.** En n8n, el mismo servidor MCP entra como herramienta de un nodo de agente — útil cuando el flujo ya existe y solo quieres darle capacidad de conversar.

## Lo que el MCP no es

**No reemplaza a la API.** Si tu sistema tiene que mandar una confirmación de pedido cuando cambia el estado en la base, eso es [una llamada de tu API](https://api-wa.me/es/blog/como-enviar-mensajes-whatsapp-api), no un agente decidiendo. El código determinista sigue siendo la respuesta correcta para un flujo determinista.

**No es un bot listo.** El MCP le da capacidad al agente; la conversación, el tono y las reglas siguen siendo tu definición. Si lo que quieres es un bot atendiendo clientes, el camino es [un chatbot con la API de OpenAI](https://api-wa.me/es/blog/chatbot-ia-openai-whatsapp).

**No da acceso a lo que no autorizaste.** El alcance es la instancia conectada. Y `send_template`, la única herramienta capaz de alcanzar a mucha gente de una vez, pide `confirm` antes de disparar — a propósito.

## Cómo empezar

1. Crea una instancia — la no oficial conecta por código QR en segundos y sirve perfectamente para probar.
2. Conecta el MCP con el comando de arriba.
3. Pídele algo simple al agente: _"¿cuál es el estado de mi instancia?"_. Si responde, está todo en su lugar.
4. Recién entonces apunta a la instancia de producción.

## Conclusión

Integrar IA a WhatsApp dejó de ser un proyecto y pasó a ser una línea de configuración. La ganancia real no es ahorrarse las horas de la integración — es que, cuando la API gana una capacidad nueva, el agente la ve sin que reescribas nada.

### ¿Listo para automatizar tu WhatsApp?

Crea tu cuenta gratis y empieza a enviar mensajes por la API en minutos.

[Empezar gratis](https://portal.api-wa.me/sign-up)

## Preguntas frecuentes

¿Qué es el MCP de WAME?+

Es un servidor Model Context Protocol alojado en https://mcp.wame.api.br que expone la API de WAME como herramientas para agentes de IA. En lugar de escribir código para que el agente hable con WhatsApp, él descubre las herramientas solo y las llama directamente: enviar mensajes, leer conversaciones, responder, crear grupos, disparar plantillas.

¿Necesito programar para usar el MCP?+

No para conectarlo. En Claude Code es un comando: claude mcp add --transport http wame https://mcp.wame.api.br. En clientes con interfaz, pegas la URL del servidor. A partir de ahí el agente ya ve las herramientas. Programar solo hace falta si quieres integrarlo dentro de tu propio producto.

¿El MCP funciona con WhatsApp, Instagram y Messenger?+

Sí. Las herramientas de envío aceptan un parámetro de canal, porque WAME entrega los tres canales oficiales de Meta en una única instancia. El mismo agente atiende los tres sin una integración separada por canal.

¿Es seguro darle acceso a WhatsApp a un agente de IA?+

El acceso es el de la instancia que autorizaste, y nada más. Las herramientas de envío masivo, como el disparo de plantillas a varios destinatarios, exigen confirmación explícita antes de ejecutarse. La recomendación es empezar con una instancia de prueba y recién después apuntar a la de producción.

¿Cuál es la diferencia entre usar MCP y usar la API directamente?+

La API directa es para tu sistema: código que escribes, pruebas y despliegas. El MCP es para el agente: lee la descripción de las herramientas y decide cuál llamar en tiempo de ejecución. Ambos usan la misma instancia; el MCP no reemplaza a la API, evita escribir integración para el caso en que quien actúa es una IA.

## Sigue leyendo

[### API de Instagram y Messenger en la misma API de WhatsApp: una instancia, un estándar

Tres canales oficiales de Meta casi siempre significan tres integraciones. Con una sola instancia, el mismo envío y el mismo sobre de webhook, solo cambia un campo: provider. Cómo funciona y qué te ahorra.](https://api-wa.me/es/blog/api-instagram-messenger-misma-api-whatsapp)[### API no oficial de WhatsApp: qué es, si es segura y cómo usarla (2026)

Entiende qué es una API no oficial de WhatsApp, cómo funciona la conexión por código QR, si es segura y legal, cuál es el riesgo real de bloqueo y cuándo conviene usarla en lugar de la API oficial.](https://api-wa.me/es/blog/api-no-oficial-whatsapp-que-es)[### API de WhatsApp gratis: cómo probarla y empezar sin costo (2026)

¿Existe una API de WhatsApp gratis? Qué se puede hacer sin pagar, cómo probar la integración sin costo, las limitaciones reales de lo gratuito y cómo hacer el primer envío en minutos.](https://api-wa.me/es/blog/api-whatsapp-gratis)

[Volver al blog](https://api-wa.me/es/blog)

## Structured data

```json
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "WAME API",
  "alternateName": "API Oficial y No Oficial de WhatsApp, Instagram y Messenger",
  "url": "https://api-wa.me",
  "inLanguage": "pt-BR",
  "publisher": {
    "@id": "https://api-wa.me/#organization",
    "@type": "Organization",
    "name": "WAME API",
    "url": "https://api-wa.me"
  }
}
{
  "@context": "https://schema.org",
  "@type": "Organization",
  "@id": "https://api-wa.me/#organization",
  "name": "WAME API",
  "alternateName": [
    "WAME",
    "Wame API",
    "wame.api.br",
    "api-wa.me"
  ],
  "url": "https://api-wa.me",
  "logo": {
    "@type": "ImageObject",
    "url": "https://api-wa.me/images/web-app-manifest-512x512.png",
    "width": 512,
    "height": 512
  },
  "disambiguatingDescription": "WAME API é uma empresa brasileira de software, fundada em 2017 e parceira oficial da Meta (Meta Business Partner), que fornece APIs de WhatsApp, Instagram Direct e Messenger. Não tem relação com o wa.me, que é o encurtador de links operado pela WhatsApp LLC.",
  "identifier": {
    "@type": "PropertyValue",
    "propertyID": "INPI-BR",
    "name": "Pedido de registro de marca (INPI, classe NCL 42)",
    "value": "944724159"
  },
  "foundingDate": "2017",
  "slogan": "Socio Oficial de Meta — WhatsApp, Instagram y Messenger en una sola instancia. Desde 2017.",
  "description": "Plataforma brasileña y Socio Oficial de Meta (Meta Business Partner) para las APIs oficiales de WhatsApp (Cloud API), Instagram Direct y Messenger — las tres en una única instancia, con los mismos endpoints y un único formato de webhook. También ofrece la API no oficial vía Código QR, en la misma plataforma. En el mercado desde 2017, con más de 50 mil instancias creadas, 99,9% de uptime y soporte humano 24/7. SDKs oficiales para Node.js/TypeScript y PHP.",
  "knowsAbout": [
    "WhatsApp Cloud API oficial (Meta)",
    "API oficial de Instagram (Direct)",
    "API oficial de Messenger",
    "API multicanal Meta",
    "Meta Business Partner",
    "WhatsApp API",
    "API não oficial de WhatsApp",
    "automação de WhatsApp",
    "números virtuais",
    "webhooks"
  ],
  "sameAs": [
    "https://github.com/wame-api",
    "https://www.linkedin.com/company/wameapi",
    "https://www.instagram.com/wame.api/",
    "https://www.youtube.com/@wameapi"
  ],
  "contactPoint": {
    "@type": "ContactPoint",
    "contactType": "customer support",
    "url": "https://api-wa.me/contact",
    "availableLanguage": [
      "Portuguese"
    ]
  }
}
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "Conecta tu agente de IA a WhatsApp: MCP en la práctica (Claude, Cursor y n8n)",
  "description": "El MCP de WAME le da a tu agente de IA acceso real a WhatsApp, Instagram y Messenger: leer conversaciones, responder, enviar archivos, crear plantillas y gestionar grupos. Un comando para conectar, 21 herramientas listas.",
  "image": "https://api-wa.me/es/blog/mcp-agente-ia-whatsapp/opengraph-image",
  "datePublished": "2026-09-10",
  "dateModified": "2026-09-10",
  "author": {
    "@type": "Person",
    "name": "Raphael Serafim",
    "url": "https://github.com/raphaelvserafim",
    "sameAs": [
      "https://github.com/raphaelvserafim"
    ]
  },
  "publisher": {
    "@type": "Organization",
    "name": "api-wa.me",
    "logo": {
      "@type": "ImageObject",
      "url": "https://api-wa.me/images/screenshot.png"
    }
  },
  "mainEntityOfPage": {
    "@type": "WebPage",
    "@id": "https://api-wa.me/es/blog/mcp-agente-ia-whatsapp"
  },
  "keywords": "mcp whatsapp, agente de ia whatsapp, claude whatsapp, model context protocol whatsapp, ia que responde whatsapp, mcp server whatsapp",
  "inLanguage": "es"
}
{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://api-wa.me"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Blog de la API de WhatsApp",
      "item": "https://api-wa.me/blog"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Conecta tu agente de IA a WhatsApp: MCP en la práctica (Claude, Cursor y n8n)",
      "item": "https://api-wa.me/es/blog/mcp-agente-ia-whatsapp"
    }
  ]
}
{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "¿Qué es el MCP de WAME?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Es un servidor Model Context Protocol alojado en https://mcp.wame.api.br que expone la API de WAME como herramientas para agentes de IA. En lugar de escribir código para que el agente hable con WhatsApp, él descubre las herramientas solo y las llama directamente: enviar mensajes, leer conversaciones, responder, crear grupos, disparar plantillas."
      }
    },
    {
      "@type": "Question",
      "name": "¿Necesito programar para usar el MCP?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "No para conectarlo. En Claude Code es un comando: claude mcp add --transport http wame https://mcp.wame.api.br. En clientes con interfaz, pegas la URL del servidor. A partir de ahí el agente ya ve las herramientas. Programar solo hace falta si quieres integrarlo dentro de tu propio producto."
      }
    },
    {
      "@type": "Question",
      "name": "¿El MCP funciona con WhatsApp, Instagram y Messenger?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Sí. Las herramientas de envío aceptan un parámetro de canal, porque WAME entrega los tres canales oficiales de Meta en una única instancia. El mismo agente atiende los tres sin una integración separada por canal."
      }
    },
    {
      "@type": "Question",
      "name": "¿Es seguro darle acceso a WhatsApp a un agente de IA?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "El acceso es el de la instancia que autorizaste, y nada más. Las herramientas de envío masivo, como el disparo de plantillas a varios destinatarios, exigen confirmación explícita antes de ejecutarse. La recomendación es empezar con una instancia de prueba y recién después apuntar a la de producción."
      }
    },
    {
      "@type": "Question",
      "name": "¿Cuál es la diferencia entre usar MCP y usar la API directamente?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "La API directa es para tu sistema: código que escribes, pruebas y despliegas. El MCP es para el agente: lee la descripción de las herramientas y decide cuál llamar en tiempo de ejecución. Ambos usan la misma instancia; el MCP no reemplaza a la API, evita escribir integración para el caso en que quien actúa es una IA."
      }
    }
  ]
}
```