Analytics MCP

The iZap MCP server lets an AI agent operate your WhatsApp business end to end — not just send a message. iZap is an official WhatsApp BSP that also owns the app layer (CRM, chatbots, orders, analytics), and this server exposes that layer to any agent over Streamable HTTP at {origin}/mcp: read analytics, manage your AI assistants, and send messages and broadcasts. Same business logic and auth as the REST API. Every tool is scoped to your business over OAuth and carries read-only / destructive hints, so the agent knows what’s safe to call before it calls it. Titles and descriptions ship in English and Portuguese. Connect Claude, ChatGPT, or Cursor in one click.

Choosing WhatsApp tooling for AI agents?

How iZap compares to transport-only APIs (Twilio, Cloud API, 360dialog) and no-code inboxes — and when each is the right pick.

Environment	MCP URL
Production	`https://api.izap.ai/mcp`
Staging	`https://api-staging.izap.ai/mcp`

Connect

Authentication is OAuth 2.0 (interactive clients bootstrap it automatically) or a Bearer JWT for server-to-server code. Register it as a remote HTTP MCP server:

{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}

Add to your AI client

Point any MCP-capable client at the URL above — interactive clients run the OAuth login for you.

One-click: open Add iZap to Cursor and confirm the install — or paste this link into your browser:

cursor://anysphere.cursor-deeplink/mcp/install?name=izap&config=eyJ1cmwiOiJodHRwczovL2FwaS5pemFwLmFpL21jcCJ9

Manual — add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{ "mcpServers": { "izap": { "url": "https://api.izap.ai/mcp" } } }

In claude.ai, go to Settings → Connectors → Add custom connector, paste https://api.izap.ai/mcp, and complete the OAuth login. Works on Pro, Max, Team, and Enterprise.

Enable Settings → Connectors → Advanced → Developer mode, then Add custom connector and paste https://api.izap.ai/mcp.

Individual Plus/Pro accounts get read-only tools. The WhatsApp / transmission (write) tools require a Business, Enterprise, or Edu workspace.

codex mcp add izap --url https://api.izap.ai/mcp

Or add to ~/.codex/config.toml:

[mcp_servers.izap]
url = "https://api.izap.ai/mcp"

Verify with /mcp inside Codex.

Go to Settings → Connectors → + Add Connectors → Custom MCP → Import by JSON and paste:

{ "izap": { "url": "https://api.izap.ai/mcp" } }

Or use Direct Configuration with transport Streamable HTTP and URL https://api.izap.ai/mcp.Cue, the Manus personal-agent app, takes the same server: add a custom MCP server with URL https://api.izap.ai/mcp.

grok.com: go to grok.com/connectors, click New Connector → Custom, paste https://api.izap.ai/mcp, and complete the sign-in.Grok Bot: go to Settings → Plugins, add a custom connector, and paste https://api.izap.ai/mcp.

Swap the host for the staging URL (https://api-staging.izap.ai/mcp) to test against staging.

Tool catalog

All tools accept an optional business_id (UUID); omit it to use your first business. Read-only tools are safe to call freely; the ones marked write create, change, or send.

Analytics (read-only)

Tool	Purpose
`get_message_stats`	Chat / message / unique-people counts for a date or, with `end_date`, a date range (totals plus per-day breakdown in one call, up to 92 days) (legacy name `get_today_message_stats` is still accepted but no longer listed)
`get_assistant_ratio`	AI-vs-human message ratio for a date (legacy name `get_today_assistant_ratio` is still accepted but no longer listed)
`get_conversation_duration`	Avg/min/max conversation duration for a date
`get_conversation_breakdown`	Per-conversation breakdown for a date
`search_messages`	Keyword search over a date or date range (legacy name `search_today_messages` is still accepted but no longer listed)

AI assistants

Tool	Purpose
`list_connected_assistants`	List the AI assistants on the account
`get_assistant_instructions`	Read an assistant’s prompt and instructions
`create_ai_assistant`	Create a new assistant (write)
`update_ai_assistant_instructions`	Update an assistant’s prompt/instructions (write)
`update_assistant_settings`	Update an assistant’s settings — active/paused, name, model, language, tone, greetings, off-hours reply (write)

Contacts & WhatsApp messaging

Tool	Purpose
`list_contacts`	List contacts on the account
`list_chats`	List the business’s WhatsApp conversations
`get_chat_messages`	Read a conversation’s messages, including media metadata
`download_media`	Download a photo, audio, or document a customer sent
`get_whatsapp_message_status`	Check an outbound message’s delivery status and Meta error code
`connect_whatsapp_number`	Get a one-hour link to Meta’s official flow for connecting a WhatsApp number (write)
`get_whatsapp_connection_status`	Diagnose the WhatsApp connection: number, WABA id, registration, webhook health, history sync, and the last Meta error in plain language
`list_whatsapp_templates`	List approved WhatsApp message templates
`create_whatsapp_template`	Create a template and submit it to Meta for approval (write)
`get_whatsapp_template_status`	Check a created template’s approval status and rejection reason
`send_whatsapp_message`	Send a WhatsApp text message (write)
`send_whatsapp_template_message`	Send an approved WhatsApp template message (write)

Media library

Tool	Purpose
`list_library_images`	List the business’s curated image library
`upload_library_image`	Add a base64-encoded image to the library (write)
`delete_library_image`	Permanently remove a library image (write)
`list_library_documents`	List the business’s documents and videos (PDF, DOCX, MP4)
`upload_library_document`	Add a base64-encoded document or video (write)
`delete_library_document`	Permanently remove a library document (write)

Broadcast transmissions

Tool	Purpose
`create_transmission_preview`	Build a broadcast preview (audience + content) (write)
`confirm_transmission`	Send a previewed broadcast (write)
`list_transmissions`	List broadcast transmissions
`get_transmission_status`	Check a transmission’s delivery status

Notes

Dates are ISO-8601 strings (e.g. 2026-04-15); timezone is an IANA name (e.g. America/Sao_Paulo).
search_messages (and its legacy name search_today_messages) is rate-limited per user per day.
create_whatsapp_template returns as soon as Meta accepts the template for review; approval is asynchronous, so poll get_whatsapp_template_status for the verdict. A template only appears in list_whatsapp_templates once Meta holds it — that tool reads Meta’s catalog, not local drafts.
send_whatsapp_template_message needs a file for a template approved with a media header (document, image or video), named exactly one of three ways:
- header_media_image_id — an image already in the media library, from upload_library_image or list_library_images. Preferred for anything reused: iZap reads it straight from storage, so nothing expires and no URL is involved.
- header_media_document_id — the same for a document or video, from upload_library_document or list_library_documents. Its header_kind (document or video) says which template header format it fits.
- header_media_url — a publicly reachable https:// URL that iZap fetches.
- header_media_base64 — the bytes themselves, for a one-off file. Not saved to the library; call upload_library_image first if it should be reusable. The type is read from the content, so JPEG, PNG, PDF, MP4 and 3GPP work and a text or Office document needs header_media_url.
Add header_media_filename to control the name a document shows the recipient. The file may differ on every send — only the header format is fixed by the approved template. Documents accept PDF, plain text, Word, Excel and PowerPoint up to 100 MB; images accept JPEG/PNG up to 5 MB and videos MP4/3GPP up to 16 MB. Passing a header for a template without a media header — or omitting it for one with — fails before anything is sent.
The media library stores GIF and WebP, which WhatsApp will not accept as a template header image. list_library_images reports usable_as_template_header per image so you can pick a valid one instead of discovering it at send time.
Templates with a media header must be created in Meta’s WhatsApp Manager; create_whatsapp_template cannot submit one yet.
Server errors surface as MCP tool errors (isError: true) with the message Error <status>: <detail>; a 401 means refresh the token.

Build with the MCP in your code

Get a token, then use the Python or TypeScript MCP SDK to call these tools from your own app or agent.

Overview

Endpoints

Choosing WhatsApp tooling for AI agents?

Connect

Add to your AI client

Tool catalog

Analytics (read-only)

AI assistants

Contacts & WhatsApp messaging

Media library

Broadcast transmissions

Notes

Build with the MCP in your code

Choosing WhatsApp tooling for AI agents?

​Connect

​Add to your AI client

​Tool catalog

​Analytics (read-only)

​AI assistants

​Contacts & WhatsApp messaging

​Media library

​Broadcast transmissions

​Notes

Build with the MCP in your code

Connect

Add to your AI client

Tool catalog

Analytics (read-only)

AI assistants

Contacts & WhatsApp messaging

Media library

Broadcast transmissions

Notes