AI Assistants (MCP)

Tool Reference

All 44 Wably MCP tools — what each does, and which ones only read, send, change or delete data.

Your AI app shows these tools and asks before using the ones that send or change data.

Type	Meaning
Read	Only looks things up
Send	Sends a real WhatsApp message, note or sequence
Write	Changes data in Wably
Destructive	Removes or blocks something — the app warns you first

Messaging#

Tool	Type	What it does
`send_text_message`	Send	Sends a plain-text WhatsApp message to one customer.
`send_template_message`	Send	Sends an approved WhatsApp template to one customer, filling its variables.
`send_interactive_buttons`	Send	Sends a message with up to 3 tappable reply buttons, optionally with a text or media header.
`send_file`	Send	Sends a file to a customer, from a public HTTPS URL or a media_id returned by upload_media.
`upload_media`	Write	Uploads a file to WhatsApp once and returns a reusable media_id (use with send_file or send_interactive_buttons).
`get_conversation`	Read	Reads the recent message history with one customer as short readable lines (newest first as returned by Wably).
`get_message_status`	Read	Checks whether a message was sent, delivered, read or failed, using the wa_message_id returned when it was sent.
`list_templates`	Read	Lists the WhatsApp message templates on a number with their short template_id, name, category, status, language, body, placeholders and buttons.
`create_template`	Write	Creates a new MARKETING or UTILITY template and submits it to WhatsApp for approval.
`get_template_status`	Read	Checks live with WhatsApp whether a template is approved, in review, rejected or paused, with its quality rating and any rejection reason.
`list_postbacks`	Read	Lists the postback (button) IDs configured on a number — used for template quick-reply buttons.
`list_bot_flows`	Read	Lists the keyword chatbot flows on a number with their unique IDs (needed for trigger_bot_flow).
`trigger_bot_flow`	Send	Starts one of your chatbot flows for a customer, as if they had sent its keyword.

Contacts#

Tool	Type	What it does
`get_subscriber`	Read	Looks up one contact by phone number: name, labels, assigned agent, and whether bot/AI replies are on.
`list_subscribers`	Read	Lists contacts on a number, optionally with the most recent conversations first.
`create_subscriber`	Write	Adds a new contact without waiting for them to message first.
`update_subscriber`	Write	Changes a contact's first name, last name, gender or labels.
`delete_subscriber`	Destructive	Permanently deletes a contact and their chat history from Wably.
`mark_conversation_status`	Destructive	Marks a conversation as resolved, reopen, archived, unarchived, blocked or unblocked in the Shared Inbox.
`assign_chat_to_team_member`	Write	Assigns a customer's conversation to a team member (team_member_id from list_team_members).
`add_subscriber_note`	Send	Adds an internal note to a contact.
`get_subscriber_notes`	Read	Reads the internal notes saved on a contact.
`reset_user_input_flow`	Send	Resets a contact who is stuck part-way through a User Input Flow, so they can start it again.

Labels, fields & sequences#

Tool	Type	What it does
`list_labels`	Read	Lists your labels with their IDs.
`create_label`	Write	Creates a new label (subscriber segment).
`assign_labels`	Write	Adds one or more labels to a contact (label IDs from list_labels).
`remove_labels`	Destructive	Removes one or more labels from a contact.
`list_custom_fields`	Read	Lists the custom fields on your account (e.g.
`assign_custom_fields`	Write	Stores custom field values on a contact, e.g.
`list_sequences`	Read	Lists the follow-up sequences on a number with their IDs.
`assign_sequences`	Send	Enrols a contact in one or more follow-up sequences.
`remove_sequences`	Destructive	Removes a contact from one or more sequences, cancelling their pending messages.

Team#

Tool	Type	What it does
`list_team_members`	Read	Lists your team members with their IDs, roles and whether each is active.
`list_team_roles`	Read	Lists the team roles (permission packages) and what each can use.

Deals (CRM)#

Tool	Type	What it does
`get_crm_overview`	Read	Shows a contact's CRM deal: pipeline, stage, value, currency, expected close date, owner, lead score, source and status (and the pipeline/stage IDs needed to update it).
`update_crm_overview`	Write	Creates a deal for a contact or changes its stage, value, owner, lead score or close date.

Shop & orders#

Tool	Type	What it does
`list_catalogs`	Read	Lists the WhatsApp product catalogs connected to your account, with their IDs and checkout settings.
`sync_catalog`	Write	Pulls the latest products into Wably from your Meta catalog.
`list_orders`	Read	Lists orders placed through your WhatsApp catalog: totals, payment method, status and shipping address.
`update_order_status`	Write	Moves a WhatsApp catalog order to approved, completed, shipped, delivered or refunded.

Help guides#

Tool	Type	What it does
`list_documentation`	Read	Lists every Wably help guide, grouped by section, with links.
`search_documentation`	Read	Finds Wably help guides that mention a phrase (e.g.
`read_documentation`	Read	Reads the full text of one or more Wably help guides by slug (from list_documentation or search_documentation).

Account#

Tool	Type	What it does
`get_account_info`	Read	Shows your Wably plan, usage limits and connected WhatsApp numbers with their phone_number_id.

How the assistant finds IDs#

You never need to type IDs. The assistant uses the matching list tool first — list_templates before sending a template, list_labels before tagging, get_account_info to pick the right WhatsApp number.

Need help? Email support@wably.in with a screenshot and your WhatsApp number — we're happy to help.