CMSCommercial ยท Digital 9 Labs (Singapore)

Qweaver WhatsApp MCP

A hosted Model Context Protocol server for a WhatsApp number you pair yourself. Connect once by scanning a QR, then Claude, ChatGPT, Cursor or any MCP client can read your chats, search history and send messages. Unlike servers built on Meta's Business API, it reads your normal WhatsApp conversations; unlike the open-source alternatives, there is nothing to install and no bridge to keep running.

How to authenticate

5 stops to a working call

  1. 1Create a free workspace at https://app.qweaver.com/signup.
  2. 2Pair your WhatsApp number: Settings > Connections > WhatsApp lines, then scan the QR with your phone. The number stays yours.
  3. 3Get your agent key (qwa_...) from Settings > Workspaces, or as JSON from /api/admin/user-kit?format=json.
  4. 4Point your MCP client at https://app.qweaver.com/api/mcp/whatsapp with header Authorization: Bearer qwa_YOUR_KEY.
  5. 5Streamable HTTP transport, stateless: no session to manage, no local install.

Example request

Request
curl https://app.qweaver.com/api/mcp/whatsapp -H "Authorization: Bearer qwa_YOUR_KEY" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_session_status","arguments":{}}}'

Example response

Response (truncated)
{"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"{\"connected\":true,\"phone\":\"65XXXXXXXX\",\"send_budget\":{\"remaining_today\":60}}"}]}}

Notes for AI agents

Seven tools: get_session_status, list_chats, search_messages, list_messages, search_contacts, send_message, mark_read. Deliberately small: servers exposing 165-280 tools measurably degrade a model's tool selection. get_session_status reports connection health AND the remaining send budget, so an agent can pace itself instead of discovering a limit by hitting it. send_message reaches a real person from a real number: confirm recipient and wording with your human first. This uses the WhatsApp Web method, not Meta's official Business API, so it can read personal chats but no provider on this method can guarantee a number is never restricted. Use it for your own conversations and replies, never cold outreach or bulk campaigns.

Machine-readable version: /api/apis/qweaver-whatsapp-mcp

On the same line