waiaconnect

Documentation / Getting started

⑧ Let your AI check your Meta account (read-only)

Markdown

Building with AI? Connect it to your account over MCP: it checks your setup, creates webhooks and templates with your confirmation and writes the code for you. See how →

Meta has published an official MCP server, “WhatsApp Business Tools”. It connects an AI (Claude, ChatGPT, Codex, Cursor) to your Meta account: the AI can read your payment status, your verification, your numbers and your templates. It is the same information we would look at in a screenshot, without the screenshots or the back and forth. It is a diagnostic aid only; you do not need it to use WAIA Connect.

What it can see (read-only, for the businesses you administer). Your businesses and whether they are verified · your WhatsApp accounts and their numbers, with status · the payment status of each account, with the link to Billing Hub · the onboarding checklist (profile, app, number, webhook, subscription) · your templates (category, status and rejection reason). It does not read your conversations.

What it cannot do. Add the card (it only checks and gives you the link) · start business verification (it only reports the status and the link) · remove another provider's line of credit · remove partners · lift a block from Meta. It helps you see quickly where the problem is; it does not fix it by itself.

Before you connect (Meta's requirements). Terms of service accepted, a payment method added and the business verified: Meta warns that these often fail silently, so the AI checks them first and sends you to whatever is missing. You must be an admin of a Meta app with a business attached: if you have no app, the tool will say so and this route does not work (we carry on with screenshots). It is a beta tool, designed by Meta for development and testing, and it may not be available to everyone yet.

How to connect it. Server address (streamable HTTP; you sign in with your Meta account):

https://mcp.facebook.com/whatsapp_business_tools

Meta has validated these clients: Claude Desktop, Claude Code, ChatGPT (web), Codex (App and CLI) and Cursor (App and CLI). Menus may differ by version and plan. The general steps:

· 1) Add the address under Connectors or MCP in your AI.

· 2) Sign in with your Meta account.

· 3) On the permissions screen, choose the app and leave it on “Read”, never “Manage”.

· 4) Check by asking the AI which tools it has: the WhatsApp Business ones should appear.

In each AI:

· Claude (desktop or claude.ai): Settings › Connectors › Add custom connector › paste the address.

· Claude Code:

claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools

Then type /mcp, choose whatsapp_business_tools and authenticate.

· ChatGPT (web): Settings › Connectors or Apps › add an MCP server with the address. The menu varies by plan and may require developer mode; Meta gives no steps of its own for ChatGPT, so confirm on your screen.

· Codex (App): Settings › MCP servers › Add servers › Streamable HTTP › URL = the address.

· Cursor: Settings › MCP › Add new MCP server › paste the address (confirm in your version).

Security. Leave the permission on “Read”: the AI cannot change anything. Do not paste tokens or keys into the chat. To revoke access at any time: facebook.com › Settings › Business Integrations; it is worth reviewing now and then. If your AI reads content that is not yours (webhooks, pages, documents), do not give it permission to manage.

🔴 Warning if your number is already on WAIA Connect. This MCP can also register numbers, change webhooks, generate tokens, send messages and edit templates. With your number already connected, do not use it for that: it can overwrite the connection or the webhooks and leave you unable to receive messages. Use it only to look.

Text to paste (English). Paste it into the chat of your AI, once connected:

Work in READ-ONLY mode with the WhatsApp Business MCP. Do not use any tool that changes anything: do not add, verify or register phone numbers; do not configure or subscribe webhooks; do not generate tokens; do not send messages; do not create, edit or delete templates. 1) List my businesses (name, id, verified yes/no). 2) For each business: its WhatsApp accounts and each account's phone numbers with their status. 3) The payment status of each account. 4) The onboarding checklist for each number (read only). 5) The templates of each account: name, category, status and, if rejected, the reason. If a tool returns an error or says something is missing (app, terms, payment, verification), copy the exact message. Answer with a short table and, at the end, a one-line-each list 'What is missing or failing'. Do not include tokens, keys or the content of my customers' messages.

Texto para pegar (español). AIs understand both languages; use whichever you prefer:

Trabajá en SOLO LECTURA con el MCP de WhatsApp Business. No uses ninguna herramienta que cambie algo: no agregues, verifiques ni registres números; no configures ni suscribas webhooks; no generes tokens; no envíes mensajes; no crees, edites ni borres plantillas. 1) Listá mis negocios (nombre, id y si están verificados). 2) Para cada negocio: sus cuentas de WhatsApp y los números de cada una, con su estado. 3) El estado de pago de cada cuenta. 4) El checklist de alta de cada número (solo lectura). 5) Las plantillas de cada cuenta: nombre, categoría, estado y, si fue rechazada, el motivo. Si una herramienta devuelve un error o dice que falta algo (app, términos, pago, verificación), copiá el mensaje exacto. Respondé con una tabla corta y, al final, una lista «Qué falta o falla» de una línea cada una. No incluyas tokens, claves ni el contenido de mensajes de mis clientes.

What we do with what you send us. If payment is missing, we guide you to add the card in the WhatsApp account of your number (not the ad account). If the business is not verified, we guide you to the documents. If a template was rejected or moved to Marketing, we guide you to rewrite it. What depends on Meta or on another provider, we review together.

The paperwork this check usually finds pending is in Meta paperwork, in order of urgency.

Sources: Meta's official documentation and blog (developers.facebook.com/documentation/mcp), and our own test of the connector on 12 November 2026.