# Your agent reads and answers WhatsApp from any MCP client.

URL: https://samva.dev/mcp-server/whatsapp

WhatsApp MCP server

Samva's hosted WhatsApp MCP server puts a WhatsApp Business number in a mailbox your agent can work. It reads each customer's chat, replies inside the service window, and sends an approved template outside it.

[Start building](https://samva.dev/signup?entry=agent_mailboxes)

[Read the WhatsApp docs](https://samva.dev/docs/channels/whatsapp)

Your customers write on WhatsApp. Your agent has no number to answer from, you do not want to run another server to give it one, and you want to read some replies before they go out.

## From your number to your agent's first reply.

1. **Connect your number.** Connect a WhatsApp Business number through Meta's signup in the dashboard. It joins a shared mailbox.
2. **Add the server.** Point your MCP client at https://mcp.samva.dev and connect your account.
3. **Read the chat.** Each customer's messages arrive as one thread your agent can read.
4. **Reply.** Your agent answers in plain text while the service window is open, and with an approved template once it has closed.

## What stays in your control.

- **A person approves what you choose**: A reply on WhatsApp follows the mailbox's decision rules, so it can wait for a person before it is sent.
- **Templates when the window has closed**: A customer's message opens a 24-hour service window. After it, your agent lists the approved templates the number can send and uses one.
- **Email in the same mailbox**: When a contact has both an email address and that WhatsApp number, their messages on both land in one conversation.
- **A number for each of your customers**: A platform sends each customer a setup link. The customer connects their own WhatsApp Business number, without a Samva account, and it lands in their own namespace.
- **Two bills, kept apart**: Samva charges sending credits by the message's category, and received messages cost nothing. Meta bills its own fee to your WhatsApp Business Account.
- **For conversations**: Built for customers who write to you. It is not for bulk WhatsApp marketing or purchased lists.

## Common questions.

### Is this a WhatsApp Business number or a personal WhatsApp session?

A WhatsApp Business number, connected through Meta's signup. Samva is a Meta Tech Provider.

### Can I keep using the WhatsApp Business app on the number?

Yes. You connect the number you already use and your team keeps the WhatsApp Business app on it.

### What can my agent send after the 24 hours?

Only a template Meta has approved. Plain text outside the service window is refused, and your agent can list the templates the number may send.

### Which MCP clients work with it?

Any MCP client that supports OAuth. A client that cannot run OAuth can send an API key in a header instead.

### Can my agent send without asking me?

You decide. Decision rules on each mailbox, key, and sender let a send go ahead or wait for a person. A held send comes back as waiting for approval and goes out only when someone approves it.

### Which plans include WhatsApp?

Every paid plan. Connecting a WhatsApp Business number and sending on it need a paid plan; the free plan covers email.

## Put your agent on WhatsApp.

[Start building](https://samva.dev/signup?entry=agent_mailboxes)

[Read the MCP docs](https://samva.dev/docs/developers/mcp)