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 WhatsApp MCP server https://api.spacesos.com/mcp/whatsapp to your agent, or call the REST API at https://api.spacesos.com/v1. The server at https://api.spacesos.com/mcp covers every channel.
Connect Claude, ChatGPT, Cursor or Grok
Every client uses the same MCP URL, https://api.spacesos.com/mcp/whatsapp, with your API key as a Bearer token. Grok, Grok Bot and Cursor can also sign in with OAuth instead of a key.
| Client | How it connects |
|---|---|
| Claude Code | Run claude mcp add with the URL and an Authorization header (below). |
| Claude Desktop | Settings, then Developer, then Edit Config: add the server with mcp-remote and your key, then restart Claude. |
| Claude API | Pass the URL in mcp_servers with your key as authorization_token, and add an mcp_toolset. |
| ChatGPT | Add a custom MCP connector with the URL and the Authorization header. |
| Cursor | Add an MCP server named spaces with the URL and header, or sign in with OAuth. |
| Grok | Use the xAI API's MCP tool with the URL and header, or sign in with OAuth. |
| Grok Bot | Connect with OAuth: no key needed. Grok Bot finds Spaces through the OAuth discovery document and you approve access. |
Claude Code, in one line:
claude mcp add --transport http spaces https://api.spacesos.com/mcp/whatsapp --header "Authorization: Bearer spc_live_xxxxxxxxxxxxxxxx"OAuth discovery is at https://api.spacesos.com/.well-known/oauth-authorization-server. API keys keep working alongside OAuth.
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.