Free with every API plan

MCP · Streamable HTTP

Connect WhatsApp Business API to any AI tool
via LetsBot MCP — free

An official MCP server that lets ChatGPT, Claude, Cursor, and Gemini read your WhatsApp conversations, build daily reports, surface frustrated customers, and analyse team performance. Live the moment you start an API plan — no extra setup, no extra cost.

Start an API plan Set up MCP in 3 steps

Meta Business Partner

∞ MCP calls per API plan

5+ Compatible AI clients

< 90s end-to-end setup

OAuth 2.1 fully RFC-compliant

The primer

What is the Model Context Protocol?

MCP is an open protocol from Anthropic that lets any AI client (ChatGPT, Claude, Cursor, Gemini, or any AI-aware IDE) talk to an external server and invoke real tools instead of hallucinating. LetsBot's MCP server exposes tools to read conversations, send messages, build reports, drive the bot, and manage contacts — all gated by strict per-API-key permissions.

Per-key authentication

Every MCP call validates a Bearer token (lb_api_key). Permissions ride with the key, so a ChatGPT user only sees their own data.

Native Streamable HTTP

POST for messages, GET for SSE streaming, DELETE for session teardown — fully aligned with the official MCP spec so any MCP-aware client connects without an adapter.

Free with API

No separate MCP bill. Any customer with an active WhatsApp Business API plan gets it automatically, with no extra cap on calls beyond their existing plan.

Compatibility

Plug into any AI tool you already use

A single MCP URL works across every client below. Paste the JSON snippet for your tool of choice, drop in your key, save — and start talking to your bot from inside that tool directly.

Claude Desktop

Anthropic — via the mcp-remote bridge in claude_desktop_config.json

{
  "mcpServers": {
    "letsbot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://letsbot.net/mcp",
        "--header",
        "Authorization: Bearer YOUR_LB_API_KEY"
      ]
    }
  }
}

ChatGPT (OpenAI Apps)

OpenAI Apps — MCP via OAuth flow

// In ChatGPT Apps → Add a server
URL: https://letsbot.net/mcp
Auth: OAuth 2.1 (PKCE auto-detected)
Bearer scope: workspace_read, conv_read, msg_send

Cursor

Cursor IDE — Settings → MCP (native HTTP)

{
  "mcpServers": {
    "letsbot": {
      "url": "https://letsbot.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LB_API_KEY"
      }
    }
  }
}

Continue.dev

Continue extension for VS Code / JetBrains

experimental:
  modelContextProtocolServers:
    - name: letsbot
      transport:
        type: http
        url: https://letsbot.net/mcp
        headers:
          Authorization: Bearer YOUR_LB_API_KEY

Gemini CLI / Code

Google Gemini — via the MCP-Gateway adapter

gemini mcp add letsbot \
  --url https://letsbot.net/mcp \
  --auth-header "Authorization: Bearer YOUR_LB_API_KEY"

VS Code Copilot Chat

GitHub Copilot Chat (Insider) — MCP since 1.95

// .vscode/mcp.json
{
  "servers": {
    "letsbot": {
      "type": "http",
      "url": "https://letsbot.net/mcp",
      "headers": { "Authorization": "Bearer YOUR_LB_API_KEY" }
    }
  }
}

Real-world prompts

Ask in plain language, get the result

Six real scenarios that play out daily in support and sales teams. Each pairs the prompt you'd type into ChatGPT or Claude with the expected AI reply after it calls LetsBot's MCP and pulls the real data.

Daily conversation report

Build me a report of every WhatsApp conversation from yesterday — new conversations, bot replies, human handoffs, and how many are still open.

Done. Called get_conversations(date="2026-05-06"). 142 new conversations, 1,287 bot replies (avg 4s response), 38 human handoffs (27%), and 12 still open after 24h.

Surface frustrated customers

Are any customers frustrated or upset with our replies today? Send me the top 5 with conversation context.

Found 7 conversations with negative sentiment. Top 5 ranked: 1) Ahmad A — order delayed 48h+; 2) Sara M — repeated "haven't heard back" 3×; 3) Mohamed K — rejected bot reply; 4) Fatima — refund complaint; 5) Layla A — repeated agent request.

Abandoned cart tracking

How many Salla store carts were abandoned in the last 7 days, and how many recovered through WhatsApp messages?

Called get_abandoned_carts(days=7). 247 abandoned carts, 61 recovered (24.7%) through the auto-message chain. Recovered revenue: SAR 27,400.

Support-team performance compare

Compare this team's performance this week vs last week — avg response time, conversations closed, and CSAT.

This week: avg response 2m (-42%), 432 conversations closed (+18%), CSAT 4.7/5. Last week: 3m 32s, 366 conversations, CSAT 4.4. Solid lift across every metric.

Send a campaign blast

Send "Eid 20% discount" to every customer who purchased in the last 3 months, personalised with their first name.

Filtered 2,418 customers who purchased since 2026-02-07. Calling send_bulk_campaign() with template "eid_2026". Throttled at 500/hour, 12% complete, full progress in dashboard.

Most-asked product insight

What are the top 5 products customers asked about on WhatsApp this month? Plus how many turned into actual orders.

1) Brand X perfume — 412 questions, 87 orders (21%); 2) Watch Y — 298 questions, 41 orders (14%); 3) Jacket Z — 254 questions, 38 orders; 4) Bag W — 207 questions, 23 orders; 5) Sneaker V — 185 questions, 19 orders.

Reference

54 tools the AI auto-discovers

The complete catalogue of every tool LetsBot's MCP server exposes — grouped into 7 categories. These are the exact names the AI sees when it queries the server, so every example above maps directly onto one of these tools.

Messages & Sending

16 tools

send_text_message Send a plain-text WhatsApp message

send_image Send an image with optional caption

send_video Send a video with optional caption

send_audio Send an audio file or voice note

send_file Send a document or PDF

send_location Send a geo location pin

send_contact_card Send a vCard contact card

send_template Send a Meta-approved template (outside the 24h window)

send_buttons Interactive message with up to 3 buttons

send_list Interactive list / menu message

reply_to_message Reply to a specific message

send_reaction Add an emoji reaction to a message

forward_message Forward a message to another chat

get_messages Read messages from a conversation

search_messages Search across all chats or within one

mark_as_read Mark every message in a chat as read

Contacts

11 tools

get_contacts Paginated contacts with search + filters

get_contact Full contact details + labels + last message

create_contact Create a new contact

update_contact Update contact info (name, email, etc.)

get_my_chats Conversations assigned to the current agent

get_unread_contacts Contacts with unread messages

pin_contact Pin / unpin a conversation

archive_contact Archive / unarchive a conversation

block_contact Block / unblock a contact

assign_label Toggle a label on a contact

assign_moderator Toggle a moderator on a contact

Labels & Team

6 tools

get_labels List every label / tag in the account

create_label Create a new label

get_label_contacts Contacts within a specific label

get_moderators Available moderators / agents

get_quick_replies Pre-built canned replies

create_quick_reply Create a new quick reply template

AI Insights

9 tools

ai_suggest_reply Suggest a reply for the current conversation

ai_summarize_conversation Summarise a full conversation history

ai_analyze_contact Analyse a contact + conversation patterns

ai_improve_message Polish a message before sending

ai_translate_message Translate a message into any language

ai_sentiment_analysis Score customer sentiment (positive/negative/neutral)

ai_employee_performance Per-agent performance breakdown

ai_team_report Whole-team performance report

ai_dashboard_summary One-shot dashboard summary

E-commerce

2 tools

get_order_status Order status + details on Salla or Zid

search_products Search the Salla / Zid product catalogue

Bulk Campaigns

3 tools

create_campaign Create a label-targeted bulk message campaign

get_campaigns List campaigns + delivery stats

get_campaign_status Per-contact delivery breakdown for one campaign

Bot & Automation

7 tools

get_bot_status Bot status + AI mode + match settings

toggle_bot Toggle the bot per contact

get_bot_conversations All configured auto-reply conversations

create_simple_conversation Simple auto-reply rule (trigger → text)

create_interactive_conversation Interactive button-based conversation tree

get_bot_settings Read every bot + AI setting

update_bot_settings Update bot / AI settings (partial)

54 tools total — the catalogue grows weekly. Full reference in the developer docs.

Setup

Get MCP running in 3 steps

Any customer with an active WhatsApp Business API plan on LetsBot can finish setup in under 90 seconds. Zero libraries to install, zero files to configure outside your AI client.

Generate an API key

In the LetsBot dashboard: Settings → API Keys → New Key. Pick the read/write scope you need and store the key somewhere safe.
Add MCP to your AI client

Copy the snippet for your client from the compatibility section and replace YOUR_LB_API_KEY with your key. The MCP URL is the same everywhere: https://letsbot.net/mcp.
Ask in any language

Open ChatGPT or Claude and try "Build me a report of today's conversations" — the client auto-discovers the tools, calls them, and answers from your real data. No extra prompting scaffolding needed.

Frequently asked

What customers ask about MCP

Ready to plug WhatsApp into AI?

Subscribe to an API plan, use MCP free for life. 14-day trial, no credit card, official Meta Business Partner, 24/7 Arabic support.

Start free trial See API plans

Connect WhatsApp Business API to any AI tool via LetsBot MCP — free