Skip to content

MCP server for AI agents

Wabot runs a Model Context Protocol server. Once you connect it, an AI agent can create templates, send WhatsApp messages, read replies and build simple automations in your account.

URL https://api.wabot.shop/mcp (Streamable HTTP)
Auth Your Client ID and Client Secret, sent as headers
Rate limit 60 requests per minute per Client ID

Copy your credentials from Settings → Developer → Client Settings. That page also has a Copy MCP config button.

Open Customize in Cursor and add an MCP server, or edit ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Paste the following, then restart Cursor.

{
"mcpServers": {
"wabot": {
"url": "https://api.wabot.shop/mcp",
"headers": { "clientid": "<Client ID>", "clientsecret": "<Client Secret>" }
}
}
}

Once connected, ask your agent something like:

  • “List my WhatsApp numbers and approved templates.”
  • “Create a utility template called order_shipped that says ‘Hi {{name}}, your order has shipped.’ and tell me when it’s approved.”
  • “Send the order_shipped template to +91 94002 94110 with name Asha, then wait for her reply.”
  • “Create an automation: when someone sends ‘price’, reply with the price_list template.”
  1. get_account or list_channels gets the whatsappPhoneId.
  2. find_contact, or create_contact if the contact doesn’t exist.
  3. send_template_message for a first message or when more than 24 hours have passed. send_session_message while the 24-hour window is open.
  4. To create a new template, call create_template, then call get_template_status with sync: true until it is APPROVED.
  5. To receive replies, call subscribe_replies for live notifications, or wait_for_reply for a one-off wait.
Tool What it does
get_account Organisation details and connected phone numbers
list_channels Enabled WhatsApp numbers
list_workspaces The Wabot accounts this login may use: own accounts, the team-member account and, for agencies, every client account; marks the current one
select_workspace account_id → every later call in this session works on that account (agencies: move between clients without reconnecting)
get_setup_status What is set up (number, approved templates, contacts, automations, campaigns) and the single best next step, with the prompt to ask for it
get_plan_status Current plan, trial end date, last 30 days of usage, and the pricing page link

Results of some tools carry a short hint when it is useful: a trial that ends within 5 days, or a free plan at the volume paid plans usually run (200+ messages in 30 days, 500+ contacts, or a campaign draft to 100+ people). Hints point to the pricing page and never state prices.

Tool Parameters
list_templates status?, search?, page?, pageSize?
get_template name
create_template template_name, category (MARKETING, UTILITY or AUTHENTICATION), language, body (with {{1}}-style variables), body_examples? (one per variable), header_text? or header_image_url? / header_video_url? / header_document_url?, footer?, buttons? (quick_reply, url, phone), whatsappPhoneId? (defaults to the first enabled number), categoryChangeAllowed?. Meta-style components? is accepted as an alternative to the content fields.
get_template_status template_name, sync? (fetch the latest status from Meta first)
update_template template_name, body
Tool Parameters
create_contact contact_number, name?, email?, group_ids?
find_contact phone
search_contacts search? (name, phone or email), tag?, limit? (1–50, default 20), page?
list_tags
tag_contacts tag, contact_ids?, phones? (creates the tag if missing)
import_contacts contacts: up to 200 of { phone, name?, email?, tags? }; existing numbers are updated, new ones created. Import only people who agreed to hear from you on WhatsApp
send_template_message whatsappPhoneId, to, templateName, receipentName?, variables?, mediaUrl?, documentName?, carouselData?
send_session_message whatsappPhoneId, receipentPhone, message, mediaUrl?, fileType?, fileName?
Tool Parameters
list_campaigns limit? (1–50)
get_campaign_results campaign_id → audience, sent, delivered, read, replies (within 48 hours), failed
create_campaign_draft name, template_name (approved), tag? and/or contact_ids?, whatsappPhoneId?, variables?, description?

create_campaign_draft only creates a draft and returns the link to it. Reviewing the audience and launching the campaign happens in the Wabot app, because each conversation is billed by Meta to your account.

Tool Parameters
list_recent_chats page?, pageSize?
get_messages contactId? or phone?, since?, page?, pageSize?
wait_for_reply contactId? or phone?, since?, timeoutMs? (2–30 s, default 25 s)
subscribe_replies contactId? or phone? (no filter means all replies)
unsubscribe_replies contactId? or phone? (no filter removes all subscriptions)
list_reply_subscriptions

After subscribe_replies, replies arrive on the session’s event stream as notifications:

{
"method": "notifications/wabot_reply",
"params": {
"contactId": 123,
"phone": "919400294110",
"messageType": "text",
"text": "Thanks",
"waMessageId": "wamid.HBgN…",
"timestamp": "2026-10-01T09:37:05.353Z"
}
}
Tool What it does
list_workflow_triggers, list_workflow_actions Which triggers, conditions and actions you can use
list_workflows, get_workflow Browse existing workflows
preview_workflow_schematic Get a Mermaid diagram of a workflow
create_master_workflow Create an empty workflow
create_simple_autoflow “When a message matches X, send template Y” in one call
append_autoflow_child Add another rule to an existing workflow
create_chained_autoflow A sequence of 2–10 steps that each wait for the previous one
update_simple_autoflow Change the match text, template, delay and other settings
set_workflow_status Turn a workflow or one of its steps on or off

New automations are created inactive. Pass activate: true or call set_workflow_status to turn them on.

Tool What it does
list_whatsapp_flow_categories, list_whatsapp_flow_field_types What you can build
list_whatsapp_flows, get_whatsapp_flow Browse flows
create_whatsapp_flow, update_whatsapp_flow Build a form from a list of fields (drafts only)
publish_whatsapp_flow, deprecate_whatsapp_flow Publish, or retire a flow

Launching or scheduling a campaign (drafts only through MCP), deleting workflows, and advanced workflow steps (branching, webhooks, agent handoff, code). Use the Wabot app for these.

Problem Fix
Missing credentials / Invalid credentials Check that both headers are set and copied exactly from Developer Credentials
Unauthorized … required_grant: /x Your client is missing that grant. Contact support
“24-hour customer-care window is closed” Send an approved template instead of a session message
Template stuck in PENDING Meta review can take from minutes to hours. Poll get_template_status with sync: true
“Template name already exists” Use a unique name, e.g. offer_20261002_1030
No reply notifications arrive Make sure your client keeps the event stream (GET) open, and call list_reply_subscriptions