Skip to main content
The iZap Analytics MCP server exposes analytics and assistant-management tools over Streamable HTTP at {origin}/mcp. Connect Claude, ChatGPT, or your own agent and call the tools directly — same business logic and auth as the REST API.
EnvironmentMCP URL
Productionhttps://api.izap.ai/mcp
Staginghttps://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}" }
    }
  }
}

​
Tool catalog

All tools accept an optional business_id (UUID); omit it to use your first business.
ToolPurpose
list_connected_assistantsList the AI assistants on the account
get_today_message_statsChat / message / unique-people counts for a date
get_today_assistant_ratioAI-vs-human message ratio for a date
get_conversation_durationAvg/min/max conversation duration for a date
search_today_messagesKeyword search over a date’s messages
get_assistant_instructionsRead an assistant’s prompt and instructions
create_ai_assistantCreate a new assistant
update_ai_assistant_instructionsUpdate an assistant’s prompt/instructions

​
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.