ChatMaxima Docs

ChatMaxima MCP - Build Chatbots from Claude, Gemini and ChatGPT

ChatMaxima MCP lets Claude, Gemini, Codex and ChatGPT build chatbots, WhatsApp templates and WhatsApp Flows in your workspace through one secure connection.

Overview

ChatMaxima MCP is a Model Context Protocol server that lets external AI assistants such as Claude, Gemini, Codex and ChatGPT work directly inside your ChatMaxima workspace. Once you connect a client, its own AI can build chatbots, design WhatsApp message templates and create WhatsApp Flows for you through plain conversation, without copying anything by hand.

MCP is an open standard for connecting AI assistants to external tools and data. ChatMaxima exposes a hosted MCP server so the assistant you already use becomes a hands-on builder for your account. You describe what you want ("build a lead qualification bot for my real estate agency"), and the assistant calls ChatMaxima tools to create it, block by block, on the real builder canvas.

This is complementary to MaxIA, the AI assistant built into the ChatMaxima dashboard. With MCP the inference is paid by your AI client, so no MaxIA credits are consumed on this path.

Connection endpoint

The MCP server lives at a single URL:

https://chatmaxima.com/mcp

You paste this URL into your AI client once, sign in to ChatMaxima, pick the workspace to connect, and approve access. The client remembers the connection for future chats.

How it works

  1. Your AI client connects to https://chatmaxima.com/mcp and discovers the available tools.
  2. You ask the assistant to build or change something in plain language.
  3. The assistant calls ChatMaxima MCP tools (create a bot, add blocks, compose a template, design a Flow).
  4. ChatMaxima performs the action in your workspace and returns the result, which the assistant uses to keep building.
  5. You open the ChatMaxima dashboard and see the finished bot, template or Flow ready to review and publish.

Secure one-click connect

ChatMaxima MCP uses OAuth 2.1 for authentication, the same pattern used by trusted "Connect with..." buttons across the web. You never paste an API key or password into the AI client.

  • Sign in once. The client opens a ChatMaxima consent screen where you log in.
  • Pick your workspace. If you belong to more than one team, you choose which workspace the client may access.
  • Approve scoped access. You see exactly what the client can do before you allow it.
  • Revoke any time. Go to Settings then Connected Apps in your dashboard to disconnect a client. The connection stops working immediately.

Note: Access is bound to the workspace you select and to your own role in that workspace. A client can never reach a team you did not approve.

What you can do

CapabilityWhat the assistant can buildPage
ChatbotsCreate bots and add, connect, update, delete and organize builder blocks, then run a scripted testCreate Chatbot
WhatsApp TemplatesBrowse the template library and compose new WhatsApp message templatesCreate Templates
WhatsApp FlowsCreate and update interactive WhatsApp FlowsCreate WhatsApp Flows

Tools at a glance

The assistant sees a catalog of ChatMaxima tools. The most used are:

  • Discovery: list_block_types, get_block_schema, list_bots, get_bot
  • Build a bot: create_bot, add_block, connect_blocks, update_block, delete_block, organize_bot, run_test
  • WhatsApp accounts: list_whatsapp_accounts
  • WhatsApp Templates: list_whatsapp_templates, get_whatsapp_template, browse_template_library, compose_whatsapp_template, get_template_schema
  • WhatsApp Flows: list_whatsapp_flows, get_whatsapp_flow, create_whatsapp_flow, update_whatsapp_flow, get_flow_schema

Access is controlled by your role

The tools a client can use mirror your permissions in the dashboard. You can only do through MCP what you can already do in the ChatMaxima UI.

  • If your role has access to the bot builder, the bot tools are available.
  • If your role has access to WhatsApp templates, the template tools are available.
  • If your role has access to WhatsApp Flows, the Flow tools are available.
  • If your role has no access to a section, those tools are hidden, and any attempt to call one returns a clear "you do not have access" message instead of failing silently.

Note: A Free or expired workspace cannot save builder changes anywhere, including through MCP. Renew the plan to enable building.

Prerequisites

Before you connect, ensure you have:

  • A ChatMaxima account with a role that can use the builder, templates or Flows.
  • An AI client that supports custom MCP connectors, such as Claude, the Gemini CLI, Codex or ChatGPT.
  • An active plan if you intend to save bots, templates or Flows.

Connect your AI client

Pick your client and follow the step-by-step guide:

Next Steps

في هذه الصفحة