WACrew

Guide

The 36 WACrew WhatsApp MCP tools, one by one

Reference for every tool in the WACrew WhatsApp MCP server: reading chats, transcribing voice notes, viewing images and video, reviewed human-paced replies, CRM and Google Calendar.

Updated 4 min read
On this page
  1. All tools
  2. How the tools chain together
  3. Safety built into the tools
  4. How this compares
  5. FAQ

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

AreaToolWhat it does
Readlistar_gruposLists every collected chat, groups and direct messages, with the slug other tools use. Start here.
Readler_mensagensReads the history of one chat, text plus existing transcripts, filtered by date.
ReadbuscarSearches text in messages and transcripts, in one chat or all of them.
Readlistar_contatosFinds who is who: name, role (you, team, client) and the DM slug. Phone and LID of the same person are merged.
Readcaixa_de_entradaWho is waiting for an answer, across every chat, with the linked project.
ReadnovidadesNew client messages in alert-enabled chats since the last check.
Readresumo_do_diaAll messages of one chat on one day, transcribing missing audio, ready to summarize.
Readler_notasReads the free-form CRM notes saved with anotar.
Readestado_triagemThe whole triage state: resolved, muted, notes, modes, tags.
MediatranscreverTranscribes voice notes and video audio (Whisper large-v3 via MLX, or an API), with cache.
Mediaver_imagemShows an image, screenshot or sticker to the model.
Mediaver_videoExtracts still frames from a video or GIF with FFmpeg, no audio, no cost.
Mediaassistir_videoHas a Gemini model watch a whole video with audio, attached or from a link, with timestamps.
Medialer_documentoReads text from PDF, docx, txt and csv files a client sent.
Replypreparar_respostaStep 1 of sending: your recent style in that chat and what the client left open.
Replyrevisar_textoStep 2: reviews a draft against repetition and robotic tells without sending.
ReplyresponderSends text to a group or contact; returns a ticket for human-paced delivery.
Replyresponder_midiaSends an image with caption, document, voice note or video.
Replyeditar_mensagemEdits a message you or the AI already sent.
ReplyreagirReacts with an emoji, or removes a reaction.
Replystatus_envioState of a delivery: scheduled, delivering, delivered, cancelled, interrupted.
Replycancelar_envioCancels a scheduled or in-progress delivery.
Triage and CRMmarcar_resolvidoClears a chat from the queue until the client writes again.
Triage and CRMsilenciar_grupoKeeps collecting a chat but removes it from the queue and alerts.
Triage and CRManotarSaves a private note about a chat (mini CRM).
Triage and CRMetiquetarSets tags such as company or contract for a chat.
Triage and CRMalertar_chatTurns macOS notifications for a chat on or off (an alert for you, not a trigger for the agent).
Triage and CRMdefinir_modoSets a chat to confirm (default) or autonomous sending.
Triage and CRMdefinir_contratoSets contract state, dates and monthly value.
Triage and CRMregistrar_featureLogs a delivered feature for a client, deduplicated by PR or issue URL.
Triage and CRMdashboardBusiness view per client: activity, contract, deliveries and signals.
Triage and CRMeditar_perfilEdits your WhatsApp profile name, about text or photo, after confirmation.
Calendaragenda_verReads your Google Calendar for a date window.
Calendaragenda_marcarCreates an event for something actually agreed.
Calendaragenda_editarChanges an event.
Calendaragenda_apagarDeletes an event you asked to delete.

How the tools chain together

A typical reply uses five of them:

  1. caixa_de_entrada finds who has waited longest.
  2. ler_mensagens (and transcrever or ver_imagem if there is media) gets the context.
  3. preparar_resposta returns how you write in that chat and what is still open.
  4. responder with 2 or 3 candidatos; the least out-of-character one is sent, after a review of more than 25 rules.
  5. status_envio follows the ticket; cancelar_envio stops it if you change your mind.

Safety built into the tools

  • Confirm mode by default. definir_modo is per chat and persists. In confirm mode the agent must show you the text before responder.
  • Profile changes need an OK. editar_perfil changes what every contact sees, so it requires confirmation.
  • Deletes only when asked. agenda_apagar and cancelar_envio are 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.