# Botbaba — how to use (mcp.ai)

Connect your Botbaba account and use 42 tools for AI chatbots straight from your AI agent. Connect with your own API key. Botbaba provides APIs for building and managing chatbots, including conversational AI and messaging integrations.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_botbaba?ms=1787293380000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `botbaba_cart_creation_event_simulator`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/botbaba`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/botbaba/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/botbaba/cart/creation/event/simulator` — Tool to simulate a Shopify cart creation webhook payload. Use when generating test payloads for BOTBABA_CART_CREATION_SHOPIFY_WEBHOOK.
- `POST https://api.mcp.ai/api/botbaba/cart/creation/shopify/webhook` — Tool to receive Shopify Cart Creation webhooks. Use when configuring Shopify webhook for Cart Creation events and forwarding the payload to Botbaba. Must be called upon receiving Shopify payload.
  - body: { payload: object, X-Shopify-Topic?: string, X-Shopify-Webhook-Id?: string, X-Shopify-API-Version?: string, X-Shopify-Hmac-SHA256?: string, X-Shopify-Shop-Domain?: string, X-Shopify-Triggered-At?: string }
- `POST https://api.mcp.ai/api/botbaba/cart/update/shopify/webhook` — Tool to forward Shopify cart update events to BotBaba. Use when processing Shopify Cart Update webhook after configuring the webhook in your store.
  - body: { payload: object, x_shopify_topic?: string, x_shopify_webhook_id?: string, x_shopify_api_version?: string, x_shopify_hmac_sha256?: string, x_shopify_shop_domain?: string, x_shopify_triggered_at?: string }
- `POST https://api.mcp.ai/api/botbaba/checkout/creation/shopify/webhook` — Tool to receive Shopify checkout creation webhook events. Use when configuring your Shopify store to notify BotBaba of checkout creation events.
  - body: { payload: object, X-Shopify-Topic?: string, X-Shopify-Webhook-Id?: string, X-Shopify-API-Version?: string, X-Shopify-Hmac-SHA256?: string, X-Shopify-Shop-Domain?: string, X-Shopify-Triggered-At?: string }
- `POST https://api.mcp.ai/api/botbaba/checkout/update/shopify/webhook` — Tool to forward Shopify checkout/update events to Botbaba. Use when handling Shopify checkout update notifications.
  - body: { webhook_payload: object, x_shopify_topic?: string, x_shopify_webhook_id?: string, x_shopify_api_version?: string, x_shopify_hmac_sha256?: string, x_shopify_shop_domain?: string, x_shopify_triggered_at?: string }
- `POST https://api.mcp.ai/api/botbaba/delete/broadcast` — Tool to delete a broadcast campaign. Use when you need to permanently remove a Botbaba broadcast by its ID after confirming it exists.
  - body: { broadcast_id: string }
- `POST https://api.mcp.ai/api/botbaba/delete/contact` — Tool to delete a contact. Use when you have the contact ID and want to remove it from Botbaba.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/botbaba/delete/flow` — Tool to delete a conversation flow. Use when you need to permanently remove a Botbaba flow by its ID after confirming it exists.
  - body: { flow_id: string }
- `POST https://api.mcp.ai/api/botbaba/delete/tag` — Tool to delete a tag. Use when you have a tag ID and want to remove it from Botbaba. Tries multiple known Botbaba endpoint variations to improve compatibility across deployments.
  - body: { tag_id: string }
- `POST https://api.mcp.ai/api/botbaba/delete/template` — Tool to delete a message template. Use when you have the template ID and want to remove it from Botbaba. Tries multiple known Botbaba endpoint variations to improve compatibility across deployments.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/botbaba/delete/webhook` — Tool to delete a webhook subscription. Use when you have the webhook ID and want to remove it from Botbaba.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/botbaba/execute/bot/action` — Tool to execute a bot action or workflow. Use when triggering automated actions or workflows for a specific conversation.
  - body: { action?: string, conv_id?: string, tag_ids?: string, action_id?: integer }
- `POST https://api.mcp.ai/api/botbaba/execute/bot/action/by/user` — Tool to execute a bot action for specific users. Use when you need to trigger actions for one or multiple bot users.
  - body: { action?: string, bot_id?: integer, action_id?: integer, bot_user_id?: integer[], json_payload?: string }
- `POST https://api.mcp.ai/api/botbaba/get/bot/widget/settings` — Tool to retrieve widget configuration settings for a bot. Use when you need to check or verify the widget display settings, styling, or behavior configuration for a specific bot.
  - body: { bot_id: integer }
- `POST https://api.mcp.ai/api/botbaba/get/broadcast` — Tool to retrieve details of a specific broadcast. Use when you need to confirm broadcast settings or status after creating or scheduling a broadcast.
  - body: { broadcast_id: string }
- `POST https://api.mcp.ai/api/botbaba/get/contact` — Tool to fetch a BotBaba contact by its ID. Use when you need to retrieve the full details of a contact after creation or update.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/botbaba/get/contact/analytics` — Tool to retrieve analytics data for contacts. Use when you need summary metrics (e.g., new or active contacts) over a date range. Note: BotBaba API does not have a dedicated contact analytics endpoint
  - body: { end_date?: string, start_date?: string }
- `POST https://api.mcp.ai/api/botbaba/get/filename` — Tool to extract the filename from a file path. Use when you need to parse a file path and retrieve just the filename component.
  - body: { path: string }
- `POST https://api.mcp.ai/api/botbaba/get/flow` — Tool to retrieve details of a specific flow. Use when you need the full configuration for a given flow ID.
  - body: { flow_id: string }
- `POST https://api.mcp.ai/api/botbaba/get/message` — Tool to retrieve status of a specific message. Use after sending a message to check its delivery status.
  - body: { message_id: string }
- `POST https://api.mcp.ai/api/botbaba/get/message/analytics` — Tool to retrieve analytics data for a specific message. Use after sending a message to analyze its delivery and engagement statistics.
  - body: { message_id: string }
- `POST https://api.mcp.ai/api/botbaba/get/template` — Tool to retrieve details of a specific template. Use when you need to confirm template details before sending a message using a template.
  - body: { template_id: string }
- `POST https://api.mcp.ai/api/botbaba/get/webhook` — Tool to retrieve details of a specific webhook. Use when you need to confirm webhook configuration before debugging event deliveries.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/botbaba/list/broadcasts` — Tool to list all broadcast campaigns. Use when retrieving BotBaba broadcast campaigns with pagination.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/botbaba/list/flows` — Tool to list all conversation flows with their IDs and metadata. Use when you need to retrieve all available flows from your BotBaba account.
- `POST https://api.mcp.ai/api/botbaba/list/tags` — Tool to list all tags. Use when you need to retrieve all tags available in your Botbaba account.
- `POST https://api.mcp.ai/api/botbaba/list/templates` — Tool to retrieve a paginated list of templates. Use when you need to browse or manage existing templates; supports optional search filtering.
  - body: { page?: integer, limit?: integer, search?: string }
- `POST https://api.mcp.ai/api/botbaba/list/webhook/event/types` — Tool to list available webhook event types. Use before creating or updating a webhook to ensure you subscribe to valid event identifiers.
- `POST https://api.mcp.ai/api/botbaba/list/webhooks` — Tool to list all registered webhooks. Use when you need to retrieve and manage webhook subscriptions in your BotBaba account.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/botbaba/order/cancellation/shopify/webhook` — Tool to receive Shopify order cancellation webhooks. Use when handling Shopify orders/cancelled events from your store.
  - body: { payload: object, X-Shopify-Topic: string, X-Shopify-Webhook-Id: string, X-Shopify-API-Version?: string, X-Shopify-Hmac-SHA256: string, X-Shopify-Shop-Domain: string, X-Shopify-Triggered-At: string }
- `POST https://api.mcp.ai/api/botbaba/order/fulfillment/event/simulator` — Tool to simulate a Shopify order fulfillment webhook payload. Use when generating test payloads for BOTBABA_ORDER_FULFILLMENT_SHOPIFY_WEBHOOK.
  - body: { variant?: string }
- `POST https://api.mcp.ai/api/botbaba/order/fulfillment/shopify/webhook` — Tool to receive Shopify Order Fulfillment webhooks. Use when handling Shopify fulfillments/create or fulfillments/update events from your store. This action acknowledges receipt of the webhook and ext
  - body: { payload: object, X-Shopify-Topic?: string, X-Shopify-Webhook-Id?: string, X-Shopify-API-Version?: string, X-Shopify-Hmac-SHA256?: string, X-Shopify-Shop-Domain?: string, X-Shopify-Triggered-At?: string }
- `POST https://api.mcp.ai/api/botbaba/order/payment/shopify/webhook` — Tool to receive Shopify Order Payment webhooks. Use when handling Shopify orders/paid events from your store. This action acknowledges receipt of the webhook and extracts key payment details from the 
  - body: { payload: object, X-Shopify-Topic?: string, X-Shopify-Event-Id?: string, X-Shopify-Webhook-Id?: string, X-Shopify-API-Version?: string, X-Shopify-Hmac-SHA256?: string, X-Shopify-Shop-Domain?: string, X-Shopify-Triggered-At?: string }
- `POST https://api.mcp.ai/api/botbaba/send/whatsapp/template/messages` — Tool to forward/send a WhatsApp template message via Botbaba. Use after copying the full message JSON from the Template UI.
  - body: { payload: object }
- `POST https://api.mcp.ai/api/botbaba/shopify/checkout/creation/event/simulator` — Tool to simulate a Shopify checkout creation webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_CREATION_SHOPIFY_WEBHOOK.
- `POST https://api.mcp.ai/api/botbaba/shopify/checkout/update/event/simulator` — Tool to simulate a Shopify checkout update webhook payload. Use when generating test payloads for BOTBABA_CHECKOUT_UPDATE_SHOPIFY_WEBHOOK.
- `POST https://api.mcp.ai/api/botbaba/update/contact` — Tool to update an existing contact. Use when needing to modify contact details after confirming contact_id.
  - body: { tags?: string[], email?: string, phone?: string, last_name?: string, contact_id: string, first_name?: string, custom_fields?: object }
- `POST https://api.mcp.ai/api/botbaba/update/tag` — Tool to update an existing tag. Use when renaming a tag after confirming its tag ID.
  - body: { name: string, tag_id: string }
- `POST https://api.mcp.ai/api/botbaba/update/template` — Tool to update an existing message template. Use when you need to modify template details after confirming its template ID. Tries multiple base URLs, HTTP methods, and path variants to be resilient ac
  - body: { name?: string, type?: string, content?: string, parameters?: object[], template_id: string }
- `POST https://api.mcp.ai/api/botbaba/update/webhook` — Tool to update an existing webhook. Use when modifying webhook URL, events, or activation status after confirming the webhook ID.
  - body: { url?: string, active?: boolean, events?: string[], webhook_id: string }
- `POST https://api.mcp.ai/api/botbaba/wa/gupshup/event/simulator` — Tool to simulate Gupshup WhatsApp webhook events. Use when testing BOTBABA_WA_GUPSHUP_MESSAGE dispatcher with different event types.
  - body: { text?: string, sender: string, recipient: string, timestamp?: integer, event_type: string, message_id?: string, interactive?: object }
- `POST https://api.mcp.ai/api/botbaba/wa/gupshup/message` — Tool to forward inbound WhatsApp webhook events from Gupshup to Botbaba. Use when handling the POST callback from Gupshup's WhatsApp integration.
  - body: { payload: object }

## Example prompts
- "What can I do in Botbaba?"
- "Show me a summary of my Botbaba account"

## More
- Page: https://mcp.ai/botbaba
- Agent spec (llms.txt): https://mcp.ai/botbaba/llms.txt
- Postman collection: https://mcp.ai/botbaba/postman.json