A WhatsApp MCP server for your AI agent
Spaces lets your AI agent read and reply to chats on your own WhatsApp account through one MCP server or a REST API. Customers who message you get an answer in the same chat. Please read WhatsApp's rules below before you connect.
Conversations your customers start
The best fit is replying to people who message you first: questions, bookings and order updates they asked for. A webhook delivers a signed POST for every new message, or your agent can check unread chats. It then reads the conversation and replies in the same chat. WhatsApp's Business Messaging Policy also expects an easy way to reach a person. Keep a human hand-off in your agent.
What your agent can do
These tools are listed in the Spaces docs:
- List chats, with an option for unread only.
- Read messages and download attachments.
- Reply in a chat.
- Start a chat with a phone number in international format. Use this only with people who expect to hear from you.
- Look up a profile.
- Check usage against Spaces' per-account limits.
Pacing and safe retries
Spaces enforces per-account limits for every key and every agent. New accounts warm up over their first week, and replies are never held back by first-week limits. Over a limit, the API returns 429 with Retry-After, and nothing was sent. Every send needs an Idempotency-Key, and the same key never sends twice.
Set up
- Sign up with your email and the 6-digit code Spaces sends. An agent can do this for you through the onboarding MCP server at https://api.spacesos.com/mcp/start.
- Add a card at checkout. Don't connect an account until checkout is finished.
- Connect WhatsApp: open the connect link ("channel": "whatsapp") and scan the QR code with your phone.
- Create an API key. It starts with spc_live_ and is shown only once, so store it safely.
- Add the MCP server https://api.spacesos.com/mcp to your agent, or call the REST API at https://api.spacesos.com/v1.
Claude Code:
claude mcp add --transport http spaces https://api.spacesos.com/mcp --header "Authorization: Bearer spc_live_xxxxxxxxxxxxxxxx"Is this allowed on WhatsApp?
Read the caveat box above and the guides on whether WhatsApp automation is allowed and how the Business Platform compares with a QR-code connection.
Who you message
Pricing
FAQ
How do I connect WhatsApp to Spaces?
Open the connect link from the dashboard, API or MCP and scan the QR code with your phone.
Is Spaces part of the WhatsApp Business Platform?
No. Spaces connects your own WhatsApp account by QR code, not through the WhatsApp Business Platform, and is not affiliated with Meta or WhatsApp.
Does WhatsApp allow automated messaging?
WhatsApp's Terms of Service prohibit bulk messaging, auto-messaging and non-personal use unless WhatsApp has authorised it. WhatsApp's Business Platform allows automation when replying within the 24-hour customer service window, with escalation paths to a person.
Can I send promotions to a list of numbers?
No. Spaces' Terms forbid bulk unsolicited messages and bought or scraped lists, and WhatsApp's Terms prohibit bulk messaging.