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.

Cursor
Claude
ChatGPT
Codex CLI
Manus

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.

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_today_message_stats`	Chat / message / unique-people counts for a date
`get_today_assistant_ratio`	AI-vs-human message ratio for a date
`get_conversation_duration`	Avg/min/max conversation duration for a date
`get_conversation_breakdown`	Per-conversation breakdown for a date
`search_today_messages`	Keyword search over a date’s messages

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)

Contacts & WhatsApp messaging

Tool	Purpose
`list_contacts`	List contacts on the account
`list_whatsapp_templates`	List approved WhatsApp message templates
`send_whatsapp_message`	Send a WhatsApp text message (write)
`send_whatsapp_template_message`	Send an approved WhatsApp template message (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_today_messages is rate-limited per user per day.
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

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

​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

Broadcast transmissions

Notes