WasenderAPI MCP

Conecta WasenderAPI a agentes de IA y herramientas de automatización mediante el Model Context Protocol. Este servidor MCP remoto expone la gestión de sesiones de WhatsApp, mensajería, contactos y grupos como herramientas invocables para Claude Code, OpenCode, n8n y otras plataformas compatibles con MCP. Requiere un plan de pago y un Personal Access Token para la autenticación.

Guía de Integración de WasenderAPI MCP

Añade el WasenderAPI MCP a tus herramientas favoritas (Claude Code/Desktop/CLI, OpenCode o n8n) usando tu Personal Access Token.

La integración MCP solo está disponible en planes de pago. Esta función no está disponible en cuentas de prueba.

Reemplaza YOUR_PERSONAL_ACCESS_TOKEN con el token de la configuración de tu cuenta de WasenderAPI. Mantenlo en secreto.

Claude Code / Desktop / CLI

1. Asegúrate de que la CLI de Claude esté instalada y con sesión iniciada.
2. Registra el MCP usando tu token:

claude mcp add --transport http wasenderapi https://wasenderapi.com/mcp \
  --header "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN"

3. Verifica que aparezca con claude mcp list e inicia una nueva sesión de Claude Code; las herramientas de WasenderAPI estarán disponibles.

OpenCode

1. Abre tu configuración de OpenCode (por defecto en ~/.config/opencode/config.json).
2. Pega el fragmento de configuración a continuación bajo la clave "mcp":

{
  "mcp": {
    "WasenderAPI": {
      "type": "remote",
      "url": "https://wasenderapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

3. Reinicia o recarga OpenCode. El WasenderAPI MCP aparecerá como WasenderAPI.

Si ya tienes otras entradas MCP, solo añade el bloque "WasenderAPI" junto a ellas.

n8n (Nodo MCP Client Tool)

Requiere n8n v2.0 o posterior. n8n incluye un nodo MCP Tool que puede llamar a servidores MCP externos.

1. Instala/actualiza a n8n v2.0+
2. Crea un nuevo workflow y añade el nodo MCP Client Tool.
3. Configura el endpoint MCP: https://wasenderapi.com/mcp.
4. Añade el encabezado Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN.
5. Selecciona la herramienta deseada (p. ej., send-message, contacts, groups).
6. Ejecuta el nodo; n8n llamará a la herramienta MCP y devolverá la respuesta.

Asegúrate de que tu sesión de WasenderAPI esté conectada y que el token sea válido antes de ejecutar.

Herramientas Disponibles (MCP)

El WasenderAPI MCP expone las siguientes herramientas para agentes de IA:

Gestión de Sesiones

• list_whatsapp_sessions – Recupera todas las sesiones de WhatsApp con paginación.
• get_specific_whatsapp_session – Recupera los detalles de una sesión específica por ID.
• get_session_user – Obtiene información sobre el usuario de WhatsApp asociado a una sesión.
• create_whatsapp_session – Crea una nueva sesión de WhatsApp.
• update_whatsapp_session – Actualiza una sesión de WhatsApp específica.
• connect_whatsapp_session – Inicia/conecta una sesión de WhatsApp (devuelve un código QR si es necesario).
• disconnect_whatsapp_session – Desconecta una sesión de WhatsApp.
• get_message_logs – Recupera los registros de mensajes de una sesión específica.
• get_session_logs – Recupera los registros de sesión de una sesión específica.

Mensajería

• send_text_message – Envía un mensaje de texto a través de una sesión especificada.
• send_mention_text_message – Envía un mensaje de texto con menciones.
• send_image_message – Envía un mensaje de imagen a través de WhatsApp.
• send_audio_message – Envía un mensaje de audio (nota de voz o archivo de audio).
• send_video_message – Envía un mensaje de video a través de WhatsApp.
• send_document_message – Envía un documento/archivo a través de WhatsApp.
• send_location_message – Envía un mensaje de ubicación a través de WhatsApp.
• send_contact_message – Envía una tarjeta de contacto a través de WhatsApp.
• send_poll_message – Envía una encuesta a través de WhatsApp.
• send_presence_update – Envía una actualización de presencia (disponible, no disponible, escribiendo, grabando, en pausa).
• resend_message – Reenvía un mensaje de WhatsApp fallido.
• edit_message – Edita un mensaje de WhatsApp existente.
• delete_message – Elimina un mensaje de WhatsApp.
• get_message_info – Obtiene información sobre un mensaje específico (estado de entrega, confirmaciones de lectura).

Contactos

• list_contacts – Lista todos los contactos de WhatsApp de una sesión especificada.
• add_or_edit_contact – Añade un nuevo contacto o edita un contacto existente en WhatsApp.
• get_contact_info – Obtiene información sobre un contacto de WhatsApp específico.
• get_contact_picture – Obtiene la URL de la foto de perfil de un contacto de WhatsApp.
• block_contact – Bloquea un contacto de WhatsApp.
• unblock_contact – Desbloquea un contacto de WhatsApp.
• check_jid_on_whatsapp – Comprueba si un número de teléfono/JID existe en WhatsApp.
• get_lid_from_phone_number – Obtiene el LID (Linked Device ID) para un número de teléfono dado.
• get_phone_number_from_lid – Obtiene el número de teléfono para un LID dado.
• search_contacts – Busca contactos de WhatsApp por nombre o número de teléfono.

Grupos

• list_groups – Lista todos los grupos de WhatsApp de una sesión especificada.
• create_group – Crea un nuevo grupo de WhatsApp con el nombre y los participantes especificados.
• get_group_metadata – Obtiene los metadatos de un grupo específico (nombre, descripción, participantes).
• get_group_participants – Obtiene los participantes de un grupo de WhatsApp específico.
• add_group_participants – Añade participantes a un grupo de WhatsApp.
• remove_group_participants – Elimina participantes de un grupo de WhatsApp.
• update_group_participants – Asciende o degrada participantes en un grupo de WhatsApp.
• update_group_settings – Actualiza la configuración de un grupo de WhatsApp (asunto, descripción, modo de anuncio, etc.).
• leave_group – Abandona un grupo de WhatsApp.
• generate_invite_link – Genera un enlace de invitación para un grupo de WhatsApp.
• accept_group_invite – Acepta una invitación a un grupo de WhatsApp mediante código.
• search_groups – Busca grupos de WhatsApp por nombre.

Documentación

• get_api_documentation_tool – Obtiene la documentación de la API. Devuelve el índice de todas las APIs si no se proporciona un ID, o documentación detallada para una entrada específica.

Ejemplos de Código

json

{
  "mcp": {
    "WasenderAPI": {
      "type": "remote",
      "url": "https://wasenderapi.com/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
      }
    }
  }
}