SheetWA MCP

Shows the WhatsApp Business number connected to this workspace: status, phone number, quality rating, the 24-hour messaging quota and whether sends are currently blocked. Call this first when a send fails or before planning a broadcast. Reads SheetWA's cached state only; it never contacts Meta.

Takes no parameters.

Finds contacts in the CRM by name or phone text, status, tags and chat activity. Returns a page with names, phones, tag names and last-chat time. Use detailed when you need contact_id/tag_ids for a follow-up call. Narrow the search rather than paging through everything.

Full profile of one contact: name, phone, status, opt-out state, tags, custom attributes and chat activity.

Normalises a phone number and reports whether a contact with it already exists. Call before waca_contacts_create to avoid a PHONE_DUPLICATE error.

Adds one contact to the CRM. Every contact needs at least one tag: pass existing tag_ids from waca_tags_list or create one with waca_tags_create first. Fails with PHONE_DUPLICATE when the number already exists (the error carries existingId).

Creates many contacts in one call (max 100). Each row is validated on its own; the answer lists what was created and what failed with the reason, so a duplicate does not stop the rest. Same tag rule as waca_contacts_create.

Changes name, phone, tags or custom attributes of one contact. Omitted fields stay as they are. tag_ids, when given, replaces the whole tag set (at least one). Opt-out is not changed here: use waca_contacts_set_opt_out.

Marks a contact as opted out of messages (opted_out: true) or re-enables them (false). Broadcasts skip opted-out contacts and single sends refuse them. Use this when a customer asks to stop receiving messages. Idempotent.

The custom attribute keys this workspace accepts on contacts (key, label, type). Use the key values in the attributes object of create/update.

Takes no parameters.

Every contact tag in the workspace with its id and how many contacts carry it. Tags group contacts for broadcasts and searches.

Takes no parameters.

Creates a contact tag by name. If a tag with that name already exists, its id is returned with already_existed: true.

Adds one or more tags to one or more contacts. Existing tags on those contacts are kept.

Removes tags from contacts. A contact always keeps at least one tag; the tool refuses with CANNOT_UNASSIGN_LAST_TAG and lists the contacts that would be left without one.

Templates registered with Meta for this workspace, with status (APPROVED templates are the only ones that can be sent), body text and the list of placeholders each needs. Use detailed for the raw components and version.

One template by name and language, with its body, placeholders, buttons, status and rejection reason. Check placeholders before any template send.

Local drafts not yet submitted to Meta. A draft becomes a real template with waca_templates_submit.

Takes no parameters.

Writes a template draft locally without submitting it to Meta, so a person can review it in the dashboard. Pass draft_id to update an existing draft. Body placeholders are positional {{1}}, {{2}}. Nothing is sent to Meta.

Submits a template to Meta. Approval usually takes minutes to hours; the template cannot be sent until its status is APPROVED. Either pass draft_id alone to submit an existing draft, or the full fields. Owner/admin only.

Ready-made template ideas from Meta's utility library and SheetWA's community library, searchable by words, category and industry. Use one as the starting point for waca_templates_save_draft. Read-only; importing is done by a person in the dashboard.

Images, videos, documents and audio already uploaded to the workspace's media library. Use an asset_id as a template media header (waca_templates_save_draft) or as the file of a media broadcast (waca_broadcasts_create). Uploading new files is done by a person in the dashboard.

Campaigns in this workspace, newest first, with status and delivery counts. Filter by status. Use waca_broadcasts_stats for the failure breakdown of one campaign.

One campaign with its template or text, schedule, counts, error and retry history.

Delivery counts of one campaign plus every failure reason grouped by Meta error code, each with a plain-language label, a class (transient / blocked / permanent / unknown) and whether a retry can work. retry_suggestion lists the codes worth passing to waca_broadcasts_retry.

Per-recipient rows of one campaign, filterable by status or error code (use unknown for failures without a code). Each row carries the phone, status, error and timestamps.

Creates and queues a campaign. Recipients come either from recipients (explicit phones with per-recipient variables) or from tag_ids (every opted-in contact carrying any of those tags, at most 500 per call). For template sends, check placeholders with waca_templates_get; supply variables (same for everyone) or variables_from_contact (per-contact fields such as first_name). Text and media broadcasts only reach people who messaged in the last 24 hours. Pass scheduled_at (ISO) to send later. This reaches real phones and is billed.

Pauses a running, queued or scheduled campaign. Resume with waca_broadcasts_resume.

Continues a paused campaign from where it stopped.

Stops a campaign for good; pending recipients are closed as cancelled. Cannot be undone. Owner/admin only.

Re-sends a finished campaign to recipients that failed with the given Meta error codes (use unknown for failures without a code). Get the codes and retry_suggestion from waca_broadcasts_stats; permanent failures such as 131026 (number not on WhatsApp) never succeed. Optionally schedule the retry for later, which is what transient limits need.

Counts of unassigned, mine, open, closed and unread conversations. The quickest way to see whether anything needs attention.

Takes no parameters.

WhatsApp threads with the contact name, phone, unread count, who holds it, the last message preview and whether the free-text reply window is open. view picks the queue: unassigned, mine (held by this key's owner), all, closed or unread. Page with cursor.

One thread's header: contact, state, assignee, unread count, tags and reply-window state. Read the messages with waca_inbox_list_messages.

Messages of one thread, oldest to newest within the page, with direction, text, type, status and who sent it. Page backwards in time with cursor.

Changes a thread's state. assign needs assignee_account_id (from waca_workspace_members_list). claim takes the thread for this key's owner; release gives it back to the unassigned queue; close ends it; reopen brings a closed thread back; mark_read clears the unread count.

Sends a free-text WhatsApp reply on a thread. Only works while the 24-hour reply window is open (reply_window_open on the conversation); otherwise use waca_inbox_reply_template. Claims an unassigned thread for this key's owner. Reaches a real phone.

Sends an APPROVED template on a thread, which is the only way to reach the customer after the 24-hour window closes. variables fill the body placeholders in order (check with waca_templates_get). Claims an unassigned thread. Reaches a real phone and is billed.

Status of one outbound message (queued, sent, delivered, read, failed) with Meta's error code and text when it failed. Use the message_id a send tool returned.

Sends one APPROVED template to one recipient, outside or inside the 24-hour window. Give contact_id or a phone with country code. variables fill the body placeholders in order; check the count with waca_templates_get first. Refuses opted-out contacts (CONTACT_OPTED_OUT). For many recipients use waca_broadcasts_create. This reaches a real phone and is billed.

Every auto-reply rule on the connected number: its trigger words, reply text, and whether it is active. A dormant rule is over the plan's limit and does not fire.

Takes no parameters.

Adds a rule that answers incoming WhatsApp messages automatically when they match its triggers. Pass active: false to save it paused. Fails with DUPLICATE_RULE when another rule already replies to the same word.

Changes a rule's triggers, match mode or reply text, or switches it on or off with active. Only the fields given change. Turning a rule on needs an active plan; pausing never does.

Removes a rule for good. To stop it for now, use waca_auto_replies_update with active: false instead.

Private team notes on an inbox thread or a CRM contact. Notes are never sent to the customer. A thread's list also includes notes written on its contact.

Writes a private note on an inbox thread or a CRM contact for the team to read. The customer never sees it. Good for summaries, hand-over context and follow-up reminders.

People in this workspace with their role (owner, admin, member) and account_id. Use an account_id to assign an inbox conversation with waca_inbox_set_state.

Takes no parameters.

The team's saved canned replies for the inbox (name and message text). Reuse their wording in waca_inbox_reply so replies match how the team already talks to customers.

Takes no parameters.