Give an AI assistanta real WhatsApp number.
An MCP server lets Claude, ChatGPT or Cursor use WhatsApp directly: list your numbers, check their health, send messages and templates, and point webhooks at your own systems. Ours runs on Meta's official Cloud API, so the number your customers already message is never at risk.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}What the connector actually connects to
One remote server, reached over OAuth, calling Meta's documented Cloud API on a number that is still live in the WhatsApp Business app. There is no session held anywhere and nothing runs on your machine.
- 1Your assistantClaude, ChatGPT, Cursor or Claude Code, over MCP
- 2easycoexistence.com/api/mcpRemote, authorised by OAuth. No key is pasted anywhere
- 3Meta Cloud APIThe documented Graph endpoints, with the account's own token
- 4The business numberConnected through Coexistence, app still working on the phone
The alternative most WhatsApp automation takes is to sign in as a linked device and drive the WhatsApp Web session. That is against WhatsApp's terms and Meta detects it from the shape of the traffic rather than the code sending it, which is why an anti-ban claim describes something the vendor cannot control. Nothing here uses that mechanism.
How to install it
One remote endpoint, the same for every number on the account. There is no package to install and no key to generate: each client signs in with OAuth the first time it calls a tool.
- Open Settings and go to Connectors.
- Choose Add custom connector and paste the endpoint below.
- Save, then ask Claude to list your numbers. It opens a sign in the first time.
https://easycoexistence.com/api/mcp- Open Settings, go to Connectors, then Advanced, and turn on Developer mode.
- Add a connector with the endpoint below.
- Start a chat and ask it to list your numbers to trigger the sign in.
https://easycoexistence.com/api/mcp- Run the command below in any terminal.
- Run /mcp inside Claude Code and authenticate.
- The eleven tools are available in every session from then on.
claude mcp add --transport http easycoexistence https://easycoexistence.com/api/mcp- Open Settings and find the MCP section.
- Add a server using the configuration below.
- Reload, then ask Cursor to list your numbers.
{
"mcpServers": {
"easycoexistence": {
"url": "https://easycoexistence.com/api/mcp"
}
}
}Connecting a number is a separate, one time step that needs a browser, because Meta's onboarding uses its own popup and a QR scan. get_connect_link returns that link if you would rather the assistant hand it to you.
Rules the tools enforce, so the assistant does not learn them the hard way
send_message works when the recipient has messaged the number in the last 24 hours. Those replies are free. Outside it, send_template with an approved template is the only thing that delivers, and the tool description says so, so the assistant reaches for the right one without being told.
The phone app cannot send a template on a Coexistence number. Anything scheduled, transactional or outside the window has to go through the API, which is a large part of why a number gets connected at all.
Marketing sends are charged by Meta to the payment method on the WhatsApp Business Account, set up in WhatsApp Manager. It never passes through us and we cannot add a card through the API.
HTTPS, and on a GET carrying hub.mode=subscribe and your hub.verify_token the endpoint has to echo hub.challenge back. We validate before the call, so a bad URL fails immediately instead of looking connected.
Eleven tools, and what each one is actually for
One connector exposes all of them across every number on the account. list_numbers comes first because every other tool takes a connection_id from it.
list_numbersConnected numbers with status, quality rating and messaging tier. The starting point for everything else.get_number_healthA live Meta snapshot plus the recent monitoring timeline: webhook events and poller checks together.get_api_credentialsGraph API base URL, WABA id, phone number id, and the account's own access token where one is available.
send_messageFree text, and only inside the 24 hour customer service window. Replies inside that window are free.send_templateHow a conversation is started with someone who has not written first.list_templatesTemplates on the account with their review status.create_templateSubmits to Meta for review. UTILITY, MARKETING or AUTHENTICATION, with {{1}} style variables that need example values.get_template_statusAPPROVED, PENDING or REJECTED, by template name.
set_webhook_destinationRoutes incoming messages and phone app echoes from Meta straight to your system. Pass null to reset it.get_connect_linkReturns the dashboard link and steps for connecting a new number, since onboarding needs a browser.get_docsThe full product documentation as markdown, so the assistant answers from our docs instead of guessing.
What still works when billing lapses
Only the tools that act on the outside world are gated. Reading stays open, on purpose.
list_numbersget_number_healthget_template_statuslist_templatesget_api_credentialsget_connect_linkget_docs
send_messagesend_templatecreate_templateset_webhook_destination
An account that cannot see why it is blocked, or cannot check whether its numbers are healthy, has no way back except a support ticket. Those two reads are also what the health monitoring itself depends on.
The pair that matters if you serve other businesses
get_connect_link returns the link a client opens to attach their own number, and set_webhook_destination points that number at your system the moment it connects. Together they mean an agent can onboard a client end to end without anyone opening a dashboard.
One account holds as many numbers as you need, each billed on its own, and list_numbers returns all of them with the connection_id every other tool takes.
Ferramentas de leitura, envio, template, ligação e documentação, todas listadas logo abaixo.
Throughput fixo de envio para um número em Coexistência, definido pela Meta. Não dá para aumentar, nem por nós nem por você.
Por quanto tempo a resposta de um cliente mantém a sessão aberta. Fora dela, só um template aprovado pode ser enviado.
O servidor é remoto, então nada roda na sua máquina e nenhuma sessão fica guardada em lugar nenhum.
Perguntas frequentes
O número do meu cliente pode ser banido por causa disso?
Não. Esta é a Cloud API oficial da Meta, alcançada pelo recurso de Coexistência da própria Meta. O risco de ban de que as pessoas falam vem de gateways não oficiais que entram como dispositivo conectado, que é um mecanismo completamente diferente.
Com quais assistentes o conector funciona?
Qualquer um que fale MCP por HTTP com OAuth: Claude, ChatGPT, Cursor, Claude Code e Codex hoje. É um endpoint remoto só, então nada roda na sua máquina.
As minhas conversas passam pelos servidores de vocês?
Não. As mensagens recebidas são roteadas da Meta direto para o webhook que você indicar, e nós nunca guardamos conteúdo de conversa. Guardamos o status da conta e do número de telefone necessário para monitorar a conexão, nada além disso.
Posso usar um conector só para vários clientes?
Pode. Uma conta comporta quantos números você precisar, cada um cobrado como a própria conexão dele, e o conector lista todos eles. Não há restrição nenhuma para usá-lo com negócios que você atende.
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Start Free Trial7 days free. Nothing is charged until the trial ends.