The WACrew MCP server (wacrew-mcp, source in web/mcp/server.ts) exposes 36 tools to Claude Code, Codex, Cursor or any MCP client. Names are in Portuguese because the project started in Brazil; each description tells the model when to use it and which tool to pick instead, so English prompts work.
All tools
| Area | Tool | What it does |
|---|---|---|
| Read | listar_grupos | Lists every collected chat, groups and direct messages, with the slug other tools use. Start here. |
| Read | ler_mensagens | Reads the history of one chat, text plus existing transcripts, filtered by date. |
| Read | buscar | Searches text in messages and transcripts, in one chat or all of them. |
| Read | listar_contatos | Finds who is who: name, role (you, team, client) and the DM slug. Phone and LID of the same person are merged. |
| Read | caixa_de_entrada | Who is waiting for an answer, across every chat, with the linked project. |
| Read | novidades | New client messages in alert-enabled chats since the last check. |
| Read | resumo_do_dia | All messages of one chat on one day, transcribing missing audio, ready to summarize. |
| Read | ler_notas | Reads the free-form CRM notes saved with anotar. |
| Read | estado_triagem | The whole triage state: resolved, muted, notes, modes, tags. |
| Media | transcrever | Transcribes voice notes and video audio (Whisper large-v3 via MLX, or an API), with cache. |
| Media | ver_imagem | Shows an image, screenshot or sticker to the model. |
| Media | ver_video | Extracts still frames from a video or GIF with FFmpeg, no audio, no cost. |
| Media | assistir_video | Has a Gemini model watch a whole video with audio, attached or from a link, with timestamps. |
| Media | ler_documento | Reads text from PDF, docx, txt and csv files a client sent. |
| Reply | preparar_resposta | Step 1 of sending: your recent style in that chat and what the client left open. |
| Reply | revisar_texto | Step 2: reviews a draft against repetition and robotic tells without sending. |
| Reply | responder | Sends text to a group or contact; returns a ticket for human-paced delivery. |
| Reply | responder_midia | Sends an image with caption, document, voice note or video. |
| Reply | editar_mensagem | Edits a message you or the AI already sent. |
| Reply | reagir | Reacts with an emoji, or removes a reaction. |
| Reply | status_envio | State of a delivery: scheduled, delivering, delivered, cancelled, interrupted. |
| Reply | cancelar_envio | Cancels a scheduled or in-progress delivery. |
| Triage and CRM | marcar_resolvido | Clears a chat from the queue until the client writes again. |
| Triage and CRM | silenciar_grupo | Keeps collecting a chat but removes it from the queue and alerts. |
| Triage and CRM | anotar | Saves a private note about a chat (mini CRM). |
| Triage and CRM | etiquetar | Sets tags such as company or contract for a chat. |
| Triage and CRM | alertar_chat | Turns macOS notifications for a chat on or off (an alert for you, not a trigger for the agent). |
| Triage and CRM | definir_modo | Sets a chat to confirm (default) or autonomous sending. |
| Triage and CRM | definir_contrato | Sets contract state, dates and monthly value. |
| Triage and CRM | registrar_feature | Logs a delivered feature for a client, deduplicated by PR or issue URL. |
| Triage and CRM | dashboard | Business view per client: activity, contract, deliveries and signals. |
| Triage and CRM | editar_perfil | Edits your WhatsApp profile name, about text or photo, after confirmation. |
| Calendar | agenda_ver | Reads your Google Calendar for a date window. |
| Calendar | agenda_marcar | Creates an event for something actually agreed. |
| Calendar | agenda_editar | Changes an event. |
| Calendar | agenda_apagar | Deletes an event you asked to delete. |
How the tools chain together
A typical reply uses five of them:
caixa_de_entradafinds who has waited longest.ler_mensagens(andtranscreverorver_imagemif there is media) gets the context.preparar_respostareturns how you write in that chat and what is still open.responderwith 2 or 3candidatos; the least out-of-character one is sent, after a review of more than 25 rules.status_enviofollows the ticket;cancelar_enviostops it if you change your mind.
Safety built into the tools
- Confirm mode by default.
definir_modois per chat and persists. In confirm mode the agent must show you the text beforeresponder. - Profile changes need an OK.
editar_perfilchanges what every contact sees, so it requires confirmation. - Deletes only when asked.
agenda_apagarandcancelar_envioare explicit actions. - Interruptible delivery. A ticket stops on its own if the client writes again or you reply from your phone.
How this compares
lharries/whatsapp-mcp has 12 tools and whatsapp-mcp-extended 26, focused on messaging primitives (send, react, edit, groups, polls). WACrew's set is smaller on WhatsApp admin features (no polls or group creation) and larger on the work around a reply: triage, media understanding, style, review and CRM. See WhatsApp MCP servers compared.
FAQ
Can I hide some tools? Your MCP client can restrict which tools the agent may call. Claude Code and Cursor both let you allow or deny tools individually.
Do the tools work offline? They read the collector's data. Local transcription with MLX works offline; video watching and API transcription need an OpenRouter key.
Where is the source? web/mcp/server.ts, Apache 2.0.



