io.github.sumioshi/wacrew-whatsapp-mcp
WhatsApp MCP server: read chats and groups, transcribe voice notes and reply at a human pace.
- Created
- 2 weeks ago
- Last commit
- 22 hours ago
- Latest release
- v0.1.04 days ago
Security Findings
Tool name/behavior mismatch2×
MaliciousScannerrevisar_texto: Handler sends the chat's message history and the draft text to an external OpenRouter LLM via avaliarPostura, which the description (listing only local checks) does not disclose.
preparar_resposta: Handler sends the conversation history to an external OpenRouter LLM via avaliarPostura for posture evaluation, which the description does not disclose.
Tools out of server's stated scope4×
MaliciousScanneragenda_ver: Google Calendar access is a different product from the WhatsApp chat server described in its stated purpose.
agenda_marcar: Creating Google Calendar events and sending invitations falls outside the WhatsApp server's stated purpose.
agenda_editar: Editing Google Calendar events falls outside the WhatsApp server's stated purpose.
agenda_apagar: Deleting Google Calendar events falls outside the WhatsApp server's stated purpose.
Missing permission declaration
SuspiciousScannerServer declares no permissions across 37 tools
Tools
37 tools exposed by this MCP server
agenda_apagar
Apaga um evento do Google Agenda. Só apague o que o operador pediu explicitamente. Se o evento tiver convidados, o Google avisa o cancelamento por e-mail.
agenda_editar
agenda_marcar
agenda_ver
Lê o Google Agenda do operador (todas as agendas da conta) numa janela de datas; padrão hoje até daqui a 7 dias. Cada evento traz `agenda` e `id` (use em agenda_editar/agenda_apagar) e `hora_brt` em horário de Brasília; `organizador` = reunião de outra pessoa, que só ela altera. Desconectado = erro pedindo para reconectar em /agenda no painel.
preparar_resposta
Passo 1 de 2 do envio: chame ANTES de escrever qualquer mensagem pra um chat (não recebe texto). Devolve o que a conta já usou nas últimas 5 mensagens ali (aberturas, verbos, pontuação, tamanhos), o estado da conversa (ativa/fria, o que o cliente deixou em aberto, se o operador já respondeu na mão) e `instrucoes` numéricas pra variar. Escreva seguindo as instruções; o `responder` revisa e recusa o que estourar. Pra conferir um rascunho já escrito, use 'revisar_texto'.
revisar_texto
Passo 2 de 2 do envio: revisa um rascunho JÁ ESCRITO, sem enviar (o contexto antes de escrever vem de 'preparar_resposta'). Confere repetição contra as últimas mensagens do chat, dois-pontos e outros tells, auto-incriminação, desculpa, tratamento. Devolve ok/score/hits/sugestoes. No modo 'confirmar', revise, corrija e só então mostre o texto ao operador. O 'responder' roda esta mesma revisão ao enviar.
alertar_chat
Liga/desliga a NOTIFICAÇÃO NO MAC (pro humano) quando chega mensagem de cliente num chat — grupo OU DM — por slug. NÃO acorda o agente nem faz o Claude reagir sozinho: é só um aviso de tela pro operador. (Pra o AGENTE ser acordado por mensagem nova — modo monitor/autônomo — arme um Monitor no `data/<slug>/messages.jsonl`, ver CLAUDE.md.) Opt-in por conversa. Depois de notificado, use `novidades` pra puxar o que chegou.
anotar
Grava a nota livre (mini-CRM) de um chat, SUBSTITUINDO a anterior por inteiro: pra acrescentar, leia antes com 'ler_notas'. Use pra contexto que não está nas mensagens (combinados, contatos, preferências do cliente). Fica só no painel, o cliente não vê. Nota vazia apaga.
assistir_video
Assiste um vídeo inteiro com o Gemini (imagem e áudio juntos) e devolve o que aparece e o que é falado, com tempos MM:SS. Diferente de 'ver_video', que só tira quadros sem som. Use quando o conteúdo do vídeo importa: cliente mostrando erro na tela, explicando algo em vídeo, ou mandando LINK de vídeo (YouTube, Instagram, TikTok). Custa ~US$ 0,03–0,05 por minuto de vídeo (OpenRouter): chame sob demanda, nunca em lote. GIF/meme ou só uma olhada rápida: prefira 'ver_video' (grátis). Vídeo do chat: `grupo` + `id` (campo 'id' de ler_mensagens) ou `mediaPath`; sem os dois, o ÚLTIMO vídeo do grupo. Link: `url` (grupo opcional). `pergunta` foca a resposta. Teto: 20 min de vídeo.
buscar
Busca um texto nas mensagens e transcrições. Sem 'grupo', procura em todos. Retorna os trechos que casam (mais recentes primeiro), limitado a 'limite' (default 50) pra não estourar — se truncar, o retorno avisa em 'truncado'. Pra ler a conversa em volta de um resultado, use 'ler_mensagens' com 'desde'.
caixa_de_entrada
Quem está esperando resposta e de qual projeto, em todos os chats coletados (o operador não precisa abrir o WhatsApp). Use pra 'quem me mandou mensagem?', 'tem cliente esperando?', 'o que rolou hoje?'. Cada item traz o chat, o `projeto` (cliente, pasta do repo e GitHub, quando o chat está linkado) e, se alguém espera, `esperando` (quem, prévia, desde quando, há quanto tempo); pendentes vêm primeiro, quem espera há mais tempo no topo. Esperando = a última fala é de cliente (ou te mencionaram) e ninguém da conta respondeu depois; chat silenciado ou marcado resolvido não entra. Só lê: não marca nada como visto (ao contrário de `novidades`). `todos: true` inclui os chats em que cliente escreveu desde `desde` mesmo já respondidos, com `do_cliente_desde`. Conversa que o cliente fechou (ok, combinado, valeu, figurinha) não entra: vem só a contagem em `encerrados`. Espera cuja última fala do cliente passou de `dias` (default 7) vem resumida em `antigos` (nome e tempo). Ao responder o operador, agrupe por projeto, diga em uma linha o que cada um quer e ainda descarte o que for só social; cite os `antigos` numa linha. Num repositório ligado a um chat (`.claude/whatsapp.json`, bloco wa-link no CLAUDE.md), passe `grupos` com o(s) slug(s) dele em vez de ler a caixa inteira; pra 'teve mensagem nova?' esta tool basta, e `ler_mensagens` (bem mais caro) só entra se precisar do conteúdo. Se vier `avisos` (serviço de IA falhando), mostre ANTES de tudo, numa linha cada. Mostre a data e hora de Brasília da última mensagem (`ultima_brt`) com quanto tempo faz em relação a `agora_brt` (ex: 28/10 09:34, há 2h). Pra ler a conversa, `ler_mensagens(grupo)`.
cancelar_envio
Cancela uma entrega humanizada AGENDADA ou EM ANDAMENTO: o balão que ainda não saiu não sai; o que já saiu fica. Use na hora, SEM confirmar, quando o operador disser 'cancela'/'para'/'não manda'. Por chat (grupo) ou por ticket. Depois chame ler_mensagens no chat pra ver o que chegou a sair antes de reenviar.
dashboard
Visão de negócio por cliente: atividade 30 d, contrato, entregas 30 d/total, mensagens e valor por entrega, e SINAIS (encerrado-ativo, sem-contrato-ativo, pausado-ativo, renovacao-30d, sem-entrega-30d) com uma frase explicando cada um. Use pra responder 'quem está ativo demais pro contrato', 'quem renova este mês', 'quantas entregas o cliente X recebeu'. `so_sinais: true` devolve só as linhas com sinal. Contratos e entregas refletem na hora; atividade de mensagens pode ter até 60 s de atraso.
definir_contrato
Define o estado comercial de um chat: estado (ativo/encerrado/pausado/sem), início e fim (YYYY-MM-DD), valor mensal e nota. Só os campos passados mudam. O dashboard cruza isso com a atividade pra apontar cliente ativo demais pro contrato, renovação próxima e custo por entrega. Pra ler, use a tool dashboard. limite_mensagens = mensagens do cliente em 30 dias que o plano comporta (null tira o limite); acima dele o dashboard aponta acima-do-contrato.
definir_modo
Define se um chat está em modo AUTÔNOMO (a IA envia sem confirmar) ou CONFIRMAR (default: a IA mostra o texto e espera OK do operador antes de enviar). Persiste por chat — você liga uma vez e vale até desligar, sem depender de re-combinar a cada msg. O `responder` lê esse modo. É convenção respeitada pela IA, não trava de código. Também liga o agente de triagem do chat (agente: off/issue/pr) e escolhe o executor (claude/copilot).
editar_mensagem
Edita uma mensagem JÁ ENVIADA por você/pela IA (o WhatsApp marca 'editada'). Use pra corrigir erro ou atualizar info numa msg recente. Só funciona em mensagem PRÓPRIA (fromMe) — ATENÇÃO: mensagens que o OPERADOR mandou do celular também são fromMe (mesma conta) e são editáveis por esta tool. Por isso NUNCA escolha o msgId por posição ('a última'): pegue via ler_mensagens e CONFIRA que o texto da msg alvo é exatamente o que você quer substituir antes de chamar. CONFIRMAÇÃO: mesma convenção do responder — no modo 'confirmar', mostre o texto novo e espere OK antes de chamar.
editar_perfil
Edita o PERFIL do WhatsApp do operador: nome, recado/'sobre' (status) e/ou foto. Passe só os campos que quer mudar. 'foto' é caminho absoluto de imagem OU o mediaPath de uma mensagem recebida. CONFIRMAÇÃO: o perfil é PÚBLICO (todo contato vê). Você DEVE mostrar ao operador o que vai mudar e ter o OK ANTES de chamar — mesma convenção do 'responder'. Não é trava de código; não burle. LIMITE: catálogo, localização, link e horário-oficial do business são read-only no WhatsApp (não editáveis por aqui).
estado_triagem
Retorna o estado de triagem inteiro (resolved/muted/notes/lastSeen/copilot/alertar/autonomo/etiquetas/agente/executor) pra IA saber o que já foi tratado, quais chats acompanha (copilot), quais alertam, e o modo de envio de cada um (autonomo: true = envia direto; ausente = confirmar antes). Contrato de cliente não vem aqui: ele fica nas tools dashboard e definir_contrato.
etiquetar
Define as ETIQUETAS de um chat (empresa/contrato/pessoal — ex.: 'Empresa A', 'Freelance'). É o rótulo que diz de qual contexto de trabalho aquele grupo/contato é — use pra saber COM QUEM está falando antes de redigir. Lista vazia remove todas. Pra LER as etiquetas de todos os chats, use estado_triagem (campo `etiquetas`).
gerar_voz
Gera a skill de voz do operador (como ele escreve no WhatsApp) medindo as mensagens que ele mesmo digitou no histórico do coletor: tamanho do balão, pontuação, abreviações, tratamento, aberturas, emoji, risada e exemplos reais por situação, separados em modo trabalho e pessoal. O que a automação mandou fica de fora (campo `origem`; WhatsApp Web e mensagens sem origem só contam antes do primeiro envio automático). Use quando o operador pedir pra criar ou atualizar a voz dele, ou quando a skill de voz ainda for o molde com placeholders. Devolve `skill` (o SKILL.md completo), `resumo` e `triagem` (cada chat, score e modo). Mostre o resumo e a triagem ao operador; se ele disser que um chat está no modo errado, chame de novo com `trabalho`/`pessoal`. Depois grave `skill` em ~/.claude/skills/<nome>/SKILL.md (e ~/.agents/skills/<nome>/ para Codex/Qwen; no Antigravity, num plugin local) e, se o nome não for voz-do-operador, ponha WAC_SKILL_VOZ=<nome> no env deste MCP. Nunca publique a skill: os exemplos são conversas reais. Só lê o histórico.
ler_documento
Lê o conteúdo de texto de um documento que o cliente mandou (PDF, .docx, .txt, .csv...). Use quando precisar entender o que diz um arquivo recebido — ex.: contrato, orçamento, planilha exportada. Se vier 'note' avisando que não há texto extraível (PDF escaneado), tente 'ver_imagem' no mesmo arquivo. Sem mediaPath, lê o ÚLTIMO documento do grupo.
ler_mensagens
Lê o histórico de UM chat, grupo ou DM (texto + transcrições já feitas). Pra 'quem está esperando' em todos os chats use 'caixa_de_entrada'; o que chegou desde a última checagem nos chats com alerta, 'novidades'; um dia inteiro pra resumir, 'resumo_do_dia'; achar um termo, 'buscar'. Filtra por data inicial e limita a quantidade. Default: as 50 mais recentes (passe 'limite' maior, ou 'desde', pra ir além) — evita despejar o grupo inteiro quando você só quer o contexto recente. Cada msg traz `timestamp` (UTC) e `hora_brt` (hora de Brasília já convertida) — use a hora_brt pra falar de horário com o operador, NÃO leia o UTC como se fosse local. Mídia com texto junto traz esse texto em `legenda` (descreve a mídia), não em `texto` (que é msg de texto solta) — assim você sabe que a legenda se refere ÀQUELE vídeo/imagem, e não confunde com um texto enviado depois. Mensagens coladas do mesmo remetente (rajada: vídeo+texto+áudio numa tacada) compartilham um `rajada` (id) — trate-as como um bloco do mesmo assunto, não itens soltos.
ler_notas
Lê as notas livres (mini-CRM) gravadas com 'anotar'. Com 'grupo', só a daquele chat; sem, todas. Só lê.
listar_contatos
Acha QUEM é quem: nome, papel (me = você, team = seu time, client = cliente), jid de DM e o slug da DM pronto pra ler_mensagens. Telefone e LID da mesma pessoa vêm numa linha só. PASSE `busca` (pedaço do nome ou o número, com ou sem formatação/nono dígito) — a conta pode ter milhares de contatos e sem filtro só vêm os 100 primeiros. Se você JÁ TEM o número, nem precisa: a DM é o slug `dm-<55DDDnúmero>` direto em ler_mensagens/responder.
listar_grupos
Lista todos os chats coletados, grupos e DMs (slug, nome, nº de mensagens, data da última), mais os grupos monitorados e os renomeados. Comece por aqui: o slug é o identificador que as outras ferramentas pedem. Pra achar uma pessoa por nome ou número, use 'listar_contatos'.
marcar_resolvido
Tira um chat (grupo ou DM) da fila de pendências marcando-o como resolvido até um momento: mensagem de cliente que chegar DEPOIS faz ele voltar pra fila. Não envia nada nem avisa o cliente. Sem 'ate', usa agora. Pra parar de alertar o chat de vez, use 'silenciar_grupo'.
novidades
Puxa as mensagens novas dos chats marcados com alerta desde a última vez que você viu, e marca como visto. Pra ver quem espera em todos os chats sem marcar nada, use 'caixa_de_entrada'. FILTRA só mensagens de CLIENTE (descarta as suas e as do time) — em grupo interno isso pode voltar vazio mesmo tendo msg nova; nesse caso o retorno traz `ignoradas_por_papel` e uma nota sugerindo ler_mensagens. Use ao ser notificado de mensagem nova. Avança o checkpoint (não repete na próxima) a menos que marcar=false. Com 'grupo', restringe a um chat.
reagir
Reage com um emoji a uma mensagem (👍, ❤️, 😂...). Às vezes a resposta humana é SÓ uma reação — prefira isso a um balão de 'ok!' quando couber. Emoji vazio ('') REMOVE a reação. O msgId vem do ler_mensagens. A tool resolve sozinha a key completa (autor/fromMe) pelo histórico — participant/fromMe manuais só como override raro.
registrar_feature
Registra uma funcionalidade ENTREGUE pra um cliente (chame ao concluir uma entrega). Alimenta o contador de entregas por cliente do dashboard. Se passar `ref` (URL do PR/issue) e ela já estiver registrada NESTE chat, não duplica (a mesma ref em outro cliente é outra entrega). PRs mergeados que fecham issues da triagem entram sozinhos; use esta tool pro que não passou por PR.
responder
responder_midia
Envia um arquivo para um grupo no WhatsApp: imagem com legenda, documento/PDF, áudio (nota de voz) ou vídeo. REGRA: só chame DEPOIS de confirmar com o usuário o destinatário e o arquivo. Se houver legenda (caption), o texto deve passar pela skill de voz do operador e ser confirmado, igual ao 'responder'. O 'path' pode ser absoluto (arquivo novo no disco) OU o mediaPath de uma mensagem já recebida (campo 'midia') para reenviar.
resumo_do_dia
Devolve TODAS as mensagens de um chat num dia (texto + transcrições, transcrevendo os áudios que faltam) pra você resumir. Default: hoje (data em UTC). Pras mensagens recentes sem recorte por dia, use 'ler_mensagens'.
silenciar_grupo
Silencia (true) ou reativa (false) um chat, grupo ou DM: as mensagens continuam sendo coletadas e lidas, mas o chat sai da fila de pendências e não alerta. Use em grupo de aviso ou conversa que não pede resposta. Reversível. Pra tirar da fila só até agora (volta se o cliente escrever), use 'marcar_resolvido'.
status_envio
Estado de uma entrega humanizada: por chat (grupo) ou por ticket. Devolve estado (agendado/entregando/entregue/cancelado/interrompido), motivo, balões enviados/total e previsão. Use depois do 'responder' pra saber se a mensagem já saiu: 'entregando 0/N' por alguns minutos é o ritmo humano, não travamento. Passe grupo OU ticket; pra cancelar, 'cancelar_envio'.
transcrever
Transcreve áudio/vídeo (MLX local, large-v3) e devolve o texto; reusa cache. UMA mídia específica: passe `mediaPath` (campo 'midia' de ler_mensagens) OU `id` (campo 'id' da mensagem) — os dois funcionam; qualquer outro nome de parâmetro é ignorado. SEM os dois: transcreve um lote dos pendentes do grupo (até 8 NOVOS por chamada; o que já tem transcrição não ocupa vaga e vem em `em_cache`; os que só estão na nuvem baixam em paralelo). Se sobrar além do teto, o retorno traz `restantes` — chame de novo e o lote AVANÇA. Em modo remoto a transcrição é publicada na nuvem, então ler_mensagens passa a trazer `transcricao`.
ver_imagem
Mostra de fato uma imagem (print/screenshot/sticker) de um grupo para a IA enxergar. Use quando precisar entender o conteúdo visual — ex.: print de um bug que o cliente mandou. Sem mediaPath, mostra a ÚLTIMA imagem/figurinha do grupo (atalho pra 'vê a imagem que acabou de chegar', sem precisar de ler_mensagens antes).
ver_video
Tira alguns quadros (imagens paradas) de um vídeo ou GIF do chat, sem áudio e sem custo (ffmpeg local). Use pra GIF/meme ou pra uma olhada rápida no visual. Não ouve nada: pra entender o que é mostrado E falado (ex.: cliente gravando um erro na tela) use 'assistir_video' (pago); pra só a fala, 'transcrever'. Sem mediaPath, usa o ÚLTIMO vídeo/GIF do grupo.
Versions
3- 0.1.4Scanned Nov 17, 2026, 11:21 PMHigh
- 0.1.3Scanned Nov 14, 2026, 11:22 PMNone known
- 0.1.2Scanned Nov 14, 2026, 11:22 PMNone known