About Wacon MCP
Wacon MCP is an MCP server published by JOSETRA44 in the Communication category: permite a tus agentes leer, enviar, ordenar mensajes de whatsapp.
The repository has 2 stars and 0 forks, with the last commit 4 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
From source
git clone https://github.com/JOSETRA44/wacon-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (70)
add_taskAdd a to-do for the user/agent. Optional due date and linked chat.
Parameters not published.
analysis_statusLive status of the last/current run_bulk_analysis job: processed/total chats, current chat, and counts of facts, episodes and suggestions found. Poll this to show progress.
Parameters not published.
analyze_contactRe-run the deterministic style analysis over the user
Parameters not published.
analyze_group_membersMass ingestion: analyzes each participant
Parameters not published.
cancel_eventCancel a scheduled event by id.
Parameters not published.
complete_eventMark an event as completed by id.
Parameters not published.
complete_taskMark a task done by id.
Parameters not published.
confirm_suggested_eventTurn a suggested actionable into a scheduled calendar event (so the proactive engine can remind about it). Confirm the date makes sense first — if the suggestion had no parseable date it defaults to tomorrow and you should adjust.
Parameters not published.
consult_playbookFor a chat tagged special (ventas, seducción, debate…), consult the mapped NotebookLM notebook (e.g. persuasion books) for concrete, sourced advice tailored to the situation and to what
Parameters not published.
dismiss_suggested_eventDiscard an actionable suggestion that isn
Parameters not published.
Show all 70 tools
find_linksFind links and files people shared, by what they point to — Google Sheets/Excel, forms to fill (Google Forms, Microsoft Forms, Typeform), docs, slides, Drive/Dropbox, Meet/Zoom — across ALL chats and groups (or one). Full-text search cannot find these: URLs are split into tokens. Example:
Parameters not published.
forget_factRemove a fact that turned out to be wrong or outdated (use the fact id from get_contact_facts / get_contact_profile).
Parameters not published.
get_agendaGet the current date/time (so you can resolve
Parameters not published.
get_analysis_bundleEverything Tier-1 already extracted for a chat, so you ENRICH instead of reading raw history: style stats + summary, dynamics notes, confirmed facts, CANDIDATE facts (machine-guessed — confirm the good ones with remember_fact, ignore the rest), episodes with (often auto) summaries, and — for groups — actionable suggestions. The token-efficient starting point for deepening a contact
Parameters not published.
get_briefingOne call that answers
Parameters not published.
get_commitmentsFinds messages where the user promised something (
Parameters not published.
get_contact_factsReturn the structured facts known about this contact, grouped by category, plus
Parameters not published.
get_contact_profileREQUIRED before send_message. Returns the full two-dimensional memory of this contact: (1) FACTS about the person (facts, grouped by category — who they are, likes, dates) plus factGaps (high-value things still unknown, worth learning or asking), (2) interaction DYNAMICS and writing STYLE (the profile: emojis, formality, tuteo/usted, recurring phrases, inside jokes, what to avoid), plus (3) the us
Parameters not published.
get_digestWhat arrived recently, grouped per chat: counts, last timestamp and a short preview — instead of dumping every message. Use this to catch up after being away (or at the start of a session) and then read in full only the chats worth it. Far cheaper than list_chats + read_messages across the board.
Parameters not published.
get_error_logShow recent internal Wacon errors (media downloads, transcription, external calls). These are logged instead of being surfaced raw to chats. Use this to understand why a media tool returned guidance, or to audit what
Parameters not published.
get_group_infoGet a WhatsApp group
Parameters not published.
get_inbox⭐ The productivity core: chats where the LAST message came from the other person, so the ball is in the user
Parameters not published.
get_personaRead the user
Parameters not published.
get_presenceOnline, typing, or last-seen state for ONE contact, straight from WhatsApp. Use for
Parameters not published.
list_analysis_targetsReturns the chats most worth analyzing (ranked by how much the user writes there), each with its resolved display name, message counts, whether it
Parameters not published.
list_chatsList recent WhatsApp chats ordered by last activity, with names, JIDs, unread counts and last-message time.
Parameters not published.
list_episodesSegment a chat
Parameters not published.
list_eventsList upcoming (or all) calendar events.
Parameters not published.
list_group_membersList a group
Parameters not published.
list_special_chatsList every chat that has special tags, with those tags.
Parameters not published.
list_stickersList sendable stickers, optionally filtered by mood (risa, carino, saludo, ok, travieso, beso, sorpresa, disculpa, molesto, neutral). Two origins:
Parameters not published.
list_suggested_eventsList deadline/exam/deliverable items the analyzer found in group chats (suggestions only — not on the calendar). Review them and promote the real ones with confirm_suggested_event.
Parameters not published.
list_tasksList pending (or all) tasks.
Parameters not published.
mark_readExplicitly mark a chat
Parameters not published.
prepare_replyTHE tool to call before replying. In one shot it bundles the full reasoning context so you don
Parameters not published.
propose_eventSuggest an event (exam, meeting, deadline, appointment) for the user
Parameters not published.
propose_replyShow the user a draft message for this chat. Wacon never lets you send from here: the user sees the draft in the app and decides to send, edit or discard it. Use this whenever you suggest what to write.
Parameters not published.
propose_taskSuggest a task the user has to do (fill a form, send a document, pay something), optionally with a due date. Shown as a card the user accepts — you never write the list directly.
Parameters not published.
react_to_messageAdd the user
Parameters not published.
read_episodeRead all messages of one episode (by episodeId from list_episodes). Use before writing its summary.
Parameters not published.
read_messagesRead recent messages from one chat (oldest first in the result). Accepts a JID (from list_chats/search_contacts) or a bare phone number. Use before_timestamp (ms) to page further back.
Parameters not published.
recall_contextThe strongest retrieval tool: hybrid search over the whole history combining keyword match (BM25), semantic similarity (robust to typos/slang, e.g.
Parameters not published.
remember_factRecord a concrete fact ABOUT the contact (not about how you talk to them — that
Parameters not published.
resolve_contactIMPORTANT for analysis: WhatsApp stores 1:1 chats under a privacy
Parameters not published.
run_bulk_analysisKick off the deterministic analysis pipeline over many chats at once — it builds style/dynamics profiles, segments episodes with extractive summaries, extracts CANDIDATE facts (low-confidence, flagged) from 1:1 chats, and collects actionable SUGGESTIONS (exams/deadlines) from groups. Returns immediately with the job state; poll analysis_status to watch progress. This is the heavy lifting so you do
Parameters not published.
schedule_eventCreate an event so Wacon becomes proactive about it. At notify time (default 60 min before start) the proactive engine wakes any listening agent via wait_for_triggers. Link it to a chat to enable a proactive message (e.g.
Parameters not published.
search_contactsSearch contacts and chats by name or phone number fragment. Returns JIDs to use with other tools.
Parameters not published.
search_messagesSearch the entire synced message history — ALL chats and groups — or one chat with full-text search. Omit
Parameters not published.
send_fileSend a local file to a chat. The kind is inferred from the extension: images and videos preview inline, audio can be sent as a real voice note (set as_voice_note), and anything else (PDF, Word, Excel, zip, txt…) goes as a document card keeping its filename. Use it to share a report, a photo, a recording, or homework. Same guardrails as send_message (rate limit, dry-run, allowlist) and it degrades
Parameters not published.
send_messageSend a text message impersonating the user. MANDATORY workflow before calling this: 1) get_contact_profile for this chat to learn tone/emojis/formality and the user
Parameters not published.
send_stickerSend a sticker by its library id (from list_stickers). WHEN to use one: at the emotional beat of a conversation — closing a joke (risa), greeting (saludo), warmth (carino), acknowledging (ok), softening a no or an apology (disculpa). Check the contact
Parameters not published.
send_voice_messageSpeak instead of typing: the text is synthesized and sent as a REAL voice note — the round bubble with a waveform that plays inline, not an audio file attachment. Use it when a voice note is the natural answer (a long explanation, something warm or urgent, or a chat where this contact usually sends audio). Write what you would SAY, not what you would write: short, spoken, no markdown, no emoji, no
Parameters not published.
set_presenceControl whether the user appears online to their contacts.
Parameters not published.
start_watchDeclare a filter so the daemon only wakes you (via wait_for_messages) for messages that matter, evaluating rules for free instead of spending your tokens on noise. Filter by chats, keywords, groups, and a minimum priority score. Priority is computed deterministically: direct chats and group messages that mention the user score high; frequent contacts, replies and questions add points. A watch expi
Parameters not published.
stop_watchStop one watch session (or all of them if no id is given). Good hygiene when you finish a vigil early.
Parameters not published.
suggest_watch_windowAnswers
Parameters not published.
summarize_episodeStore a concise summary of a conversation episode (what happened, decisions, emotional tone, open threads). Summaries are semantically indexed and surface in recall_context, so THIS is how conversations become durable memory. Write in third person, past tense, max ~3 sentences, in the user
Parameters not published.
sync_stickersIndex the bundled packs and the stickers the user has sent (tagging each with the mood inferred from the text before it). Run once, or after a big history sync, so list_stickers has fresh options.
Parameters not published.
tag_chatTag a chat (e.g.
Parameters not published.
transcribe_audioProcess a voice note / audio a contact sent. read_messages shows a
Parameters not published.
untag_chatRemove a special tag from a chat.
Parameters not published.
update_contact_profileAppend a qualitative observation to a contact
Parameters not published.
view_imageDownload an image (or video thumbnail) a contact sent and return it so you can SEE it with your own vision. read_messages shows a
Parameters not published.
wacon_doctorCheck that everything Wacon depends on is healthy: WhatsApp session, local database, daemon, NotebookLM (nlm CLI auth + mapped notebooks exist), and disk space. Returns each check with ok/warn/fail and a suggested fix. Run this when something isn
Parameters not published.
wacon_initOne-time (or occasional) bulk pass: builds the user
Parameters not published.
wait_for_messagesWait efficiently for incoming messages instead of polling. The daemon blocks server-side and returns the moment a message arrives (or when the timeout expires) — one call replaces an entire poll loop and costs a fraction of the tokens. Returns each message already triaged with a priority score (0-100) and the reasons behind it. Pass the returned
Parameters not published.
wait_for_triggersThe proactive long-poll. Blocks server-side and returns when either a new message arrives OR a scheduled event
Parameters not published.
watch_statusList active watch sessions with their filters and minutes left, plus the current event cursor. Use the cursor as
Parameters not published.
whatsapp_loginGet the current login QR code as an image. Show it to the user and tell them to scan it from WhatsApp on their phone (Settings > Linked Devices > Link a Device). If already connected, reports that instead. The QR rotates every ~30s, so call again if it expired.
Parameters not published.
whatsapp_statusCheck the WhatsApp session state (connected / waiting_qr / logged_out) and local database stats. Call this first if any other tool fails.
Parameters not published.
Ask AI
✦
Ask AI about Wacon MCP
Powered by Claude
Ask about Wacon MCP — answers draw on its README.
Security checks
6 checks have not been run yet.