Official Meta Business Partner

WhatsApp MCP server
for AI agents

One endpoint gives any MCP client tools for your WhatsApp numbers, conversations, messages, templates, and webhooks.

Get started Read docs

What you can ask

Any MCP client can call these tools: Claude Code, Codex, Cursor, or your own agent. They run against your Kapso project, so answers come from your real numbers and conversations.

agent · ~/acme-support

>Which conversations have been open longer than a day?

  • kapso · whatsapp_conversations list status: active

Two conversations have been open for more than 24 hours without a reply from you.

-Diego Morales: invoice question (31h)

-Sofía Herrera: warranty claim (26h)

>Close the ones that are resolved

kapso · whatsapp_conversations set_status ended

Setup

Paste the prompt into your agent, or run the commands yourself.

Paste a prompt

Your agent follows the setup guide for its own client and asks before creating keys.

Paste this into your agent

>Set up WhatsApp for this project with Kapso. Follow the steps at kapso.com/whatsapp-mcp-server and ask me before creating any keys.

  • Reads this page and the Kapso docs
  • Adds the Kapso MCP server to its client
  • Waits for you to set your API key

Add it yourself

Any client that supports remote MCP servers over HTTP.

  1. 1. Get a project API key

    Create one in your Kapso dashboard. Or skip it and sign in through the browser.

    export KAPSO_API_KEY="your_project_api_key"

  2. 2. Add the server to your client

    In Cursor this goes in .cursor/mcp.json. Other clients take the same URL and header.

    {
  "mcpServers": {
    "kapso": {
      "url": "https://api.kapso.ai/mcp",
      "headers": { "Authorization": "Bearer ${env:KAPSO_API_KEY}" }
    }
  }
}

  3. 3. Ask your agent

    Try a read-only request first.

    > Which of my WhatsApp numbers are connected?
For scripts and CI, use the Kapso CLI with the same key: npm install -g @kapso/cli
CLI docs →

For AI agents
reading this page

Coding agents can read this page and set themselves up. Or copy the instructions and paste them into any agent.

Instructions for AI agents

## For AI agents reading this page

You are reading https://kapso.com/whatsapp-mcp-server. Kapso is the WhatsApp API for developers. Its MCP server gives you tools for the WhatsApp numbers, conversations, messages, templates, and webhooks in the user's Kapso project. Follow these steps to add those tools to the MCP client you are running in.

  1. 1.

    Check for an API key.
    Check that KAPSO_API_KEY is set, without printing it. If it is not, ask the user for a Kapso project API key, or use browser sign-in if your client supports MCP OAuth. Never create keys, sign up, or approve access on their behalf.

  2. 2.

    Register the MCP server in your client.
    Claude Code and Codex have their own pages: kapso.com/whatsapp-claude-code and kapso.com/whatsapp-codex. For Cursor, add this to .cursor/mcp.json:

    { "mcpServers": { "kapso": {
  "url": "https://api.kapso.ai/mcp",
  "headers": { "Authorization": "Bearer ${env:KAPSO_API_KEY}" }
} } }

    Reference the variable, never the key itself, in any file that can be committed.

  3. 3.

    Load the tools.
    Most clients start MCP servers when a session starts. If the Kapso tools do not appear, ask the user to restart the client or reload its MCP servers.

  4. 4.

    Verify before you continue.
    Call the status tool. If it fails, stop and tell the user the error it shows. A 401 means the key is missing or invalid. Do not carry on as if the tools were there.

  5. 5.

    Start read-only, then report back.
    Use whatsapp_numbers and whatsapp_conversations to look before you act, and confirm with the user before sending messages or changing templates, webhooks, or setup links. Tell them which project and numbers you can reach.

## Reference

MCP endpoint
https://api.kapso.ai/mcp
Streamable HTTP · API key or OAuth
Auth
Authorization: Bearer <key> or X-API-Key: <key>
Or OAuth sign-in, which picks one project
Tools
status, whatsapp_numbers, whatsapp_conversations, whatsapp_messages, whatsapp_templates, whatsapp_webhooks, customers, setup_links, search_logs
Server card
https://api.kapso.ai/mcp/server-card
Docs
https://docs.kapso.ai/docs/whatsapp/mcp
llms.txt
https://docs.kapso.ai/llms.txt

Other agents and tools

Frequently asked
questions

Yes. Kapso WhatsApp MCP runs at https://api.kapso.ai/mcp over streamable HTTP. MCP clients connect with a project API key or by signing in through the browser.

It can inspect connected numbers and their health, read conversations and messages, send messages, manage templates and webhooks, search logs, and create customers and setup links for customer-owned WhatsApp accounts.

Any client that supports remote MCP servers over HTTP, including Claude Code, Codex, and Cursor. Send the key as an Authorization: Bearer header or an X-API-Key header.

Yes. Kapso is a Meta Business Partner and uses the official WhatsApp Business Platform, so your numbers and messages go through Meta directly.

Create a Kapso project
and connect your agent

The free plan includes a sandbox number and 2,000 messages a month.

Get started