Overview
MCP Server

Get started with SheetWA MCP

Run your WhatsApp API workspace from an AI assistant. Claude, Cursor, VS Code and any other MCP client can search contacts, send templates, run broadcasts, answer the inbox and manage auto replies for you.

urlMCP server URL
https://backend.sheetwa.com/api/v3/mcp

Prerequisites#

  • A SheetWA workspace with a WhatsApp number connected through the WhatsApp API.
  • A key from the workspace owner or an admin. The owner can give a key to anyone in the workspace. An admin can give one to themselves or a member. Members can't create keys.
  • An API Growth or API Max plan, or the 7-day free trial. MCP is not part of API Lite.
  • An AI client that supports MCP, such as Claude Code, Claude Desktop, Cursor or VS Code.

Create an API key#

  1. 1

    Open MCP Server

    In the SheetWA dashboard, open MCP Server in the sidebar (https://app.sheetwa.com/waca-mcp).

  2. 2

    Create a key

    The owner or an admin clicks Give a key, names it, like "Ravi's Claude", picks who will use it and an expiry. Keys have all access unless they narrow it under Advanced access.

  3. 3

    Copy it now

    The full key starts with sk_live_. Copy it into your client's config. The person it was given to can copy it again later from MCP Server.

Treat the key like a password

Anyone holding it can act in your workspace with your role. Keep it out of shared files and screenshots. If it leaks, revoke it on the API Keys page and it stops working on the next request.

Server URL#

Every client connects to the same Streamable HTTP endpoint. Send the key in the Authorization header.

textMCP server URL
https://backend.sheetwa.com/api/v3/mcp
textHeader
Authorization: Bearer sk_live_your_key_here

Keys go in the header only

A key passed in the URL query string is refused, so it never ends up in server logs or browser history.

Connect your client#

Pick your client, paste the snippet and swap in your key. Restart the client if it was already open.

Configure in Terminal

  1. 1Run this once in your terminal.
  2. 2Start Claude Code and type /mcp to check SheetWA shows as connected.
bashTerminal
claude mcp add --transport http sheetwa https://backend.sheetwa.com/api/v3/mcp \
  --header "Authorization: Bearer sk_live_your_key_here"

Step-by-step guides

Try it#

Once connected, ask in plain words. The assistant picks the right tools on its own. A few prompts to start with:

  • "Is my WhatsApp number connected, and what is its quality rating?"
  • "Show my approved templates and the placeholders each one needs."
  • "Find contacts tagged VIP who have not chatted in 30 days."
  • "Summarise unread inbox conversations and draft replies for me to check."
  • "Add an auto reply that answers 'price' with a link to our pricing page, paused for now."

Keep a human in the loop for sends

Tools that reach a customer's phone are marked as outbound, so most clients ask before running them. Leave that confirmation on until you trust the workflow.

Check the connection#

A good first call. It confirms the number is live and shows its quality rating and sending quota.

waca_connection_status#

WhatsApp connection status

Read only

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.