convez.ai
MCP Server
QalaLabs

convertway-whatsapp-mcp

QalaLabs/convertway-whatsapp-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP Server for WhatsApp Business API via Convertway by Unicommerce — omnichannel communication layer for WhatsApp, SMS, and Email. Built for AI coding tools (Claude Code, Cursor).

Instalação

$npx convez-ai QalaLabs/convertway-whatsapp-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

Convertway WhatsApp MCP Server

MCP Server for WhatsApp Business API via Convertway by Unicommerce — omnichannel communication layer for WhatsApp, SMS, and Email. Built for AI coding tools (Claude Code, Cursor, etc.).

Features

  • 3 Channels — WhatsApp (text/template/media), SMS, Email (CC/BCC)
  • 11 MCP Tools — send, receive, list templates, check delivery, log conversations
  • 15 Message Templates — across 7 modules: shipment, payment, mis, support, alerts, b2b, escalation
  • Dual Transport — stdio (local CLI) or HTTP (remote server)
  • Inbound Webhooks — receive and process incoming messages
  • Conversation Store — file-based persistence

Quick Start

npm install
cp .env.example .env
# Edit .env: set CONVERTWAY_LICENSE_KEY
npm run dev          # stdio mode (local)
npm run dev:http     # HTTP mode (remote)

Remote Server Mode

Run as a remote MCP server for Claude Code, Cursor, or any MCP client:

npm run start:http

The server exposes a unified Express app on a single port:

EndpointMethodPurpose
/mcpPOST / GETMCP Streamable HTTP endpoint
/webhooks/convertwayPOSTConvertway webhook callbacks
/healthGETHealth check

MCP Client Config

{
  "mcpServers": {
    "convertway": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Tools

ToolDescription
send_whatsappSend WhatsApp text, template, or media messages
get_whatsapp_templatesList approved WhatsApp templates
send_smsSend SMS with sender ID
send_emailSend email with CC/BCC
get_delivery_statusCheck delivery status by message ID
receive_inboundPull inbound messages from webhook queue
log_conversationLog a conversation record
get_conversation_historyRetrieve conversation history
list_template_modulesList all template modules
list_templates_by_moduleList templates for a specific module
list_all_templatesList all templates across modules

Environment

VariableDefaultDescription
CONVERTWAY_LICENSE_KEY—Convertway API license key
MCP_TRANSPORTstdioTransport mode: stdio or http
MCP_PORT3000HTTP server port
MCP_PATH/mcpMCP endpoint path
WEBHOOK_PATH/webhooks/convertwayWebhook callback path
SMTP_HOST—SMTP server for email fallback

Architecture

src/
├── config.ts              # Env-based configuration
├── server.ts              # McpServer setup (stdio + HTTP)
├── index.ts               # Entry point
├── convertway/
│   ├── client.ts          # Convertway API client (Axios, Basic Auth)
│   └── types.ts           # TypeScript types
├── templates/
│   └── index.ts           # 15 templates with variable interpolation
├── tools/
│   ├── index.ts           # Tool registry (11 tools)
│   ├── whatsapp.ts        # WhatsApp send + template listing
│   ├── sms.ts             # SMS send
│   ├── email.ts           # Email send
│   ├── delivery.ts        # Delivery status
│   └── conversations.ts   # Conversation CRUD
├── webhooks/
│   ├── handler.ts         # Inbound message queue
│   ├── router.ts          # Express webhook routes
│   └── server.ts          # Standalone webhook server
└── storage/
    └── conversations.ts   # File-based conversation store

Docker

docker build -t convertway-mcp .
docker run -e CONVERTWAY_LICENSE_KEY=cw_your_key -e MCP_TRANSPORT=http -p 3000:3000 convertway-mcp
Ver o original no GitHub

Bom para

Relacionados