@moshipp/mosend-mcp

Servidor MCP (Model Context Protocol) oficial de Mosend — conecta agentes de IA (Claude Desktop, Claude Code, o cualquier cliente MCP) a tu WhatsApp Business: leer y responder conversaciones, gestionar contactos, plantillas, difusiones, la base de conocimiento del bot y más.

Requisitos

1. Una cuenta en Mosend con plan que incluya acceso a API.
2. Una API key: Dashboard → Configuración → Integraciones → API Keys.
   • ⚠️ Créala con scopes explícitos mínimos (una key sin scopes tiene acceso total). Sugeridos para un agente típico: conversations:read, conversations:write, messages:read, messages:send, contacts:read, contacts:write, templates:read, phone-numbers:read, bot:read, bot:write, billing:read.
   • Opcional: restringe la key a números específicos (phoneNumberIds).
3. El UUID de tu organización (visible en la URL del dashboard o vía API).

Uso con Claude Desktop / Claude Code

{
  "mcpServers": {
    "mosend": {
      "command": "npx",
      "args": ["-y", "@moshipp/mosend-mcp"],
      "env": {
        "MOSEND_API_KEY": "mk_live_xxx.yyy",
        "MOSEND_ORG_ID": "00000000-0000-0000-0000-000000000000"
      }
    }
  }
}

Claude Code:

claude mcp add mosend -e MOSEND_API_KEY=mk_live_xxx.yyy -e MOSEND_ORG_ID=<uuid> -- npx -y @moshipp/mosend-mcp

Variables:

| Variable | Requerida | Descripción | | --- | --- | --- | | MOSEND_API_KEY | ✅ | API key mk_live_<prefix>.<secret> | | MOSEND_ORG_ID | ✅ | UUID de la organización | | MOSEND_BASE_URL | — | Default https://api.mosend.dev |

Tools disponibles (31)

Mensajería: send_text_message, send_message_raw · Conversaciones: list_conversations, get_conversation, get_conversation_messages, set_conversation_status, snooze_conversation · Contactos/CRM: search_contacts, create_contact, add_contact_note, create_task, list_tags · Plantillas: list_templates, sync_templates · Difusiones: create_broadcast, send_broadcast (⚠️ masiva) · Bot IA: get_bot_config, toggle_bot, get_ai_credits, search_knowledge, list_knowledge_docs, upload_knowledge_text, delete_knowledge_doc · Agenda/citas: list_appointment_types, get_appointment_slots, book_appointment, list_appointments, reschedule_appointment, cancel_appointment · Otros: list_phone_numbers, create_whatsapp_link.

Ejemplos de lo que puede hacer un agente conectado:

• "Revisa mis conversaciones sin responder, resume qué pide cada cliente y redacta las respuestas."
• "Sube estas políticas de envío a la base de conocimiento del bot."
• "Crea un enlace de WhatsApp con el mensaje 'Hola, quiero más info 🙋' y dame el link."
• "Busca al contacto Juan Pérez y agéndame una tarea de llamarlo mañana."
• "Un cliente quiere una cita: muéstrame los horarios libres de esta semana y reserva el que elija."

Desarrollo

npm install
npm run build      # dist/index.js
npm run typecheck
MOSEND_API_KEY=... MOSEND_ORG_ID=... node dist/index.js   # stdio

Seguridad

• El servidor solo puede hacer lo que la API key permita: usa scopes mínimos y restricción por número.
• send_broadcast es una acción masiva — el tool lo advierte en su descripción para que el agente pida confirmación humana.
• Los endpoints solo-humanos (usuarios, 2FA, passkeys, push) están bloqueados para API keys en el backend y no se exponen aquí.

Licencia

MIT © Moshipp