wacrm-mcp: deixe um agente de IA usar o WACRM
wacrm-mcp é um servidor MCP em Node com cinco ferramentas sobre a Core API do WACRM: enviar um modelo de WhatsApp, ler uma conversa, criar um contato, acompanhar atualizações de pedido e de status de mensagem, e ler o saldo da carteira de tokens. Ele se autentica com uma chave de API do WACRM informada como variável de ambiente.
Por a equipe WACRM Atualizado em
Vive no repositório do WACRM hoje — ainda não publicado no npm nem em nenhum registro de pacotes
5 ferramentas, cada uma uma tradução direta para uma chamada já existente e já testada da Core API
Protocolo: o @modelcontextprotocol/sdk oficial sobre stdio (initialize, tools/list, tools/call)
Autenticação: uma chave de API do WACRM com escopo via a variável de ambiente WACRM_API_KEY, enviada apenas como Authorization: Bearer
Sem lógica de negócio no servidor — checagem de escopos, repetição idempotente e débito de carteira acontecem na Core API
O WACRM não é afiliado nem endossado pela Meta
Para que serve o wacrm-mcp
Um agente de IA que já fala MCP pode usar estas cinco ferramentas da mesma forma que uma pessoa usa a caixa de entrada do Workspace do WACRM: enviar um modelo aprovado, se atualizar sobre uma conversa, adicionar um contato novo, acompanhar atualizações de pedido e de entrega, e conferir quanto resta da carteira de tokens. Cada ferramenta é uma tradução direta para uma chamada da Core API feita com a própria chave de API com escopo de quem chama — o servidor nunca guarda lógica de negócio, uma decisão de política, ou um cache próprio.
Fale com um especialista
Huy Nguyen (David), Fundador e CEO
Pergunte qual ferramenta combina com seu agente, ou como apontar um cliente MCP para o servidor.
Ferramentas
| Ferramenta | Chamada à Core API | Escopo | Notas |
|---|---|---|---|
send_template | POST /v1/messages (type: template) | messages:send | Sempre carrega um Idempotency-Key — uma nova tentativa com a mesma chave nunca envia duas vezes. |
read_conversation | GET /v1/contacts/{contact}/messages | contacts:read | Paginação por marca d'água — devolva next_since_id para avançar de página. |
create_contact | POST /v1/contacts | contacts:write | Pode responder 402 plan_limit_reached se o limite de contatos do projeto já foi usado. |
notify_order | POST /v1/webhook-endpoints | wa_webhooks:write | Inscreve seu próprio endpoint HTTPS no evento message.status — ainda não existe uma rota separada de notificação de pedidos. |
wallet_balance | GET /v1/token-balance | wallet:read | Sem entrada — devolve o saldo atual do projeto e o uso deste ciclo. |
Configuração
Aponte um cliente MCP para o servidor via stdio, com sua própria chave com escopo no ambiente:
{
"mcpServers": {
"wacrm": {
"command": "node",
"args": ["/path/to/apps/mcp/src/index.mjs"],
"env": {
"WACRM_API_KEY": "sk_live_sua_chave_com_escopo",
"WACRM_API_BASE": "https://api.wacrm.ai"
}
}
}
}O que isto não é
- Ainda não publicado no npm nem em nenhum registro de pacotes — o pacote vive só neste repositório.
- Não é um repositório público — hoje não existe um link de código-fonte público para ele.
- O WACRM não é afiliado nem endossado pela Meta.
- Nenhum débito de carteira ou controle de plano acontece dentro deste servidor — isso vive na própria Core API.
Perguntas frequentes
O wacrm-mcp já está publicado no npm?
Ainda não. O pacote vive dentro do repositório privado do WACRM hoje, sem configuração de publicação e sem repositório público no GitHub. Uma versão pública do pacote está planejada.
Como o wacrm-mcp se autentica?
Com uma chave de API do WACRM que você informa como a variável de ambiente WACRM_API_KEY ao iniciar o servidor. A chave só é enviada como o cabeçalho Authorization: Bearer de cada requisição à Core API — nunca é registrada em log, nem aparece no resultado de uma ferramenta ou em um erro.
O servidor MCP adiciona sua própria cobrança ou checagem de escopos?
Não. O wacrm-mcp não tem lógica de negócio própria: a checagem de escopos, a repetição idempotente e o débito da carteira acontecem dentro da Core API por trás da chave que você fornece, exatamente como em uma chamada direta à API.
O que acontece quando uma chamada de ferramenta falha?
A ferramenta devolve um resultado de erro com o próprio {code, message} da Core API — insufficient_scope, uma credencial inválida, um 404, um conflito ou um limite de taxa — nunca um resultado vazio em silêncio.
O WACRM é afiliado à Meta?
Não. O WACRM é um produto independente construído sobre a WhatsApp Business Platform e não é afiliado nem endossado pela Meta, nesta página ou em qualquer outro lugar do wacrm.ai.
Relacionado
Consiga uma chave de API do WACRM para seu agente
Solicite acesso antecipado para ter um Workspace e criar uma chave de API com escopo para o wacrm-mcp.