# Chatbotkit — how to use (mcp.ai)

Connect your Chatbotkit account and use 284 tools for AI chatbots straight from your AI agent. Connect with your own API key. ChatBotKit is a platform that enables developers to build and manage AI-powered chatbots, offering comprehensive APIs and SDKs for seamless integration into applications.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_chatbotkit?ms=1787293320000`
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. `chatbotkit_attach_dataset_file`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/chatbotkit`
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/chatbotkit/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/chatbotkit/attach/dataset/file` — Tool to attach a file to a dataset as a source. Use when you need to link a specific file to a dataset to provide knowledge content.
  - body: { type: string, fileId: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/authenticate/secret` — Tool to authenticate a secret by its ID. Use when you need to generate an authentication URL for a specific secret.
  - body: { secretId: string }
- `POST https://api.mcp.ai/api/chatbotkit/clone/blueprint` — Tool to clone an existing blueprint. Use when you need to create a duplicate of a blueprint with all its associated resources.
  - body: { blueprintId: string }
- `POST https://api.mcp.ai/api/chatbotkit/clone/bot` — Tool to clone an existing bot. Use when you need to create a duplicate copy of a bot with all its settings and configurations.
  - body: { botId: string }
- `POST https://api.mcp.ai/api/chatbotkit/clone/platform/example` — Tool to clone a platform example. Use when you need to create instances of all resources defined in a platform example template.
  - body: { exampleId: string }
- `POST https://api.mcp.ai/api/chatbotkit/clone/widget/integration` — Tool to clone an existing widget integration. Use when you need to duplicate a widget integration while preserving its tested configurations.
  - body: { widgetIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/complete/conversation` — Send a message to a ChatBotKit conversation and receive the bot's AI-generated reply. This is the primary action for interacting with a chatbot. It sends user text to an existing conversation and retu
  - body: { text: string, accept?: string, conversation_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/blueprint` — Tool to create a new blueprint in ChatBotKit. Use when you need to create a reusable template or configuration blueprint.
  - body: { meta?: object, name?: string, alias?: string, visibility?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/blueprint/graphql` — Tool to create a new blueprint template via GraphQL mutation. Use when you need to create a reusable bot configuration template via the GraphQL API.
  - body: { meta?: object, name: string, alias?: string, visibility?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/bot` — Tool to create a new AI bot with configurable settings. Use when you need to create a new chatbot with specific name, personality, model, and connected resources like datasets or skillsets.
  - body: { name?: string, model?: string, backstory?: string, datasetId?: string, skillsetId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/bot/graphql` — Tool to create a new bot using GraphQL mutation. Use when you need to create a bot with specified name, description, and other configuration via the GraphQL API.
  - body: { name?: string, model?: string, backstory?: string, datasetId?: string, skillsetId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/bot/session` — Creates a new bot session with an associated conversation and authentication token. Use this when you need to start a new chat session with a bot, optionally with pre-populated messages.
  - body: { meta?: object, botId: string, messages?: object[], durationInSeconds?: number }
- `POST https://api.mcp.ai/api/chatbotkit/create/contact` — Tool to create a new contact. Use when you need to track users interacting with bots. Contacts can have associated memories, secrets, and conversations.
  - body: { meta?: object, name?: string, nick?: string, email?: string, phone?: string, verifiedAt?: integer, description?: string, fingerprint: string, preferences?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/conversation` — Tool to create a new conversation. Use when you need to start a new chat session with a bot. Conversations store message history between users and bots. You can either reference an existing bot by ID 
  - body: { meta?: object, name?: string, botId?: string, model?: string, taskId?: string, privacy?: boolean, spaceId?: string, messages?: object[], backstory?: string, contactId?: string, datasetId?: string, moderation?: boolean, skillsetId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/conversation/message` — Tool to create a new message in an existing conversation. Use this to add user messages, bot messages, or other message types to a conversation.
  - body: { meta?: object, name?: string, text: string, type: string, entities?: object[], description?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/conversation/message/batch` — Tool to create multiple messages in a conversation in a single batch operation. Use this when you need to add multiple messages at once, which is more efficient than creating them individually.
  - body: { items: object[], conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/conversation/session` — Tool to create a new conversation session with an authentication token. Use when you need to generate a temporary access token for a conversation.
  - body: { conversationId: string, durationInSeconds?: number }
- `POST https://api.mcp.ai/api/chatbotkit/create/dataset/graphql` — Tool to create a new dataset using GraphQL mutation. Use when you need to create a dataset to store knowledge and information for bots.
  - body: { meta?: object, name?: string, alias?: string, store?: string, reranker?: string, separators?: string, visibility?: string, blueprintId?: string, description?: string, searchMinScore?: number, recordMaxTokens?: integer, searchMaxTokens?: integer, matchInstruction?: string, searchMaxRecords?: integer, mismatchInstruction?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/dataset/record` — Tool to create a new record in a dataset. Use when you need to add text data to an existing dataset for knowledge retrieval by bots.
  - body: { meta?: object, text: string, source?: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/discord/integration` — Tool to create a Discord integration for a ChatBotKit bot. Use when you need to connect a bot to Discord by providing Discord Application ID, Bot Token, and Public Key.
  - body: { appId: string, botId: string, handle?: string, botToken: string, publicKey: string, sessionDuration?: integer, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/email/integration` — Tool to create a new email integration for a ChatBotKit bot. Email integrations enable your bot to receive and respond to emails, making it accessible through email communication channels. Use when yo
  - body: { name?: string, botId: string, allowFrom?: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: integer, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/extract/integration` — Tool to create a new Extract integration for a ChatBotKit bot. Extract integrations enable your chatbot to automatically pull and extract structured data from conversations based on a predefined JSON 
  - body: { meta?: object, name?: string, botId: string, model?: string, schema: object, request?: string|object, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/file` — Tool to create a new file resource in ChatBotKit. Use when you need to create a file that can be attached to datasets for processing and indexing. Note: This creates the file record; use the upload ac
  - body: { meta?: object, name?: string, visibility?: string, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/instagram/integration` — Tool to create an Instagram integration for a ChatBotKit bot. Use when you need to connect a bot to Instagram by providing an Instagram access token.
  - body: { meta?: object, name?: string, botId: string, accessToken: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: integer, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/integration` — Creates a new support integration for a ChatBotKit bot. Support integrations enable your chatbot to handle customer support inquiries and optionally forward conversation summaries to a specified email
  - body: { meta?: object, name: string, botId: string, email?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/mcpserver/integration` — Tool to create a new MCP Server integration for ChatBotKit. Use when you need to set up an MCP (Model Context Protocol) Server integration to extend bot capabilities with custom server-side functional
  - body: { meta?: object, name: string, skillsetId?: string, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/memory` — Tool to create a new memory entry. Use when you need to store information for later retrieval, such as user preferences, conversation context, or important facts associated with a bot or contact.
  - body: { meta?: object, name?: string, text: string, botId?: string, contactId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/messenger/integration` — Tool to create a Facebook Messenger integration for a ChatBotKit bot. Use when you need to connect a bot to Facebook Messenger by providing a Facebook Page Access Token.
  - body: { meta?: object, name?: string, botId: string, accessToken: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/create/notion/integration` — Tool to create a Notion integration for a ChatBotKit dataset. Use when you need to connect a dataset to Notion for syncing content between Notion pages and ChatBotKit.
  - body: { token: string, datasetId: string, expiresIn?: integer, description?: string, syncSchedule?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/rating` — Tool to create a rating in ChatBotKit. Use when you need to submit a numeric rating value for tracking purposes.
  - body: { value: integer }
- `POST https://api.mcp.ai/api/chatbotkit/create/secret` — Tool to create a new secret in ChatBotKit. Secrets store credentials that bots use to access external services via skillset abilities. Use when you need to securely store API keys, tokens, or other au
  - body: { kind: string, name: string, type: string, value?: string, visibility?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/secret/graphql` — Tool to create a new secret via GraphQL mutation. Use when you need to securely store credentials, API keys, or authentication tokens via the GraphQL API.
  - body: { kind: string, name: string, type: string, value?: string, visibility: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/sitemap/integration` — Tool to create a sitemap integration for a ChatBotKit dataset. Sitemap integrations automatically crawl and index website content from a sitemap.xml file, keeping your dataset synchronized with your w
  - body: { url: string, glob?: string, name?: string, datasetId: string, expiresIn?: integer, selectors?: string, javascript?: boolean, description?: string, syncSchedule?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/skillset` — Tool to create a new skillset. Use when you need to group multiple skills into a single reusable unit.
  - body: { meta?: object, name: string, visibility?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/slack/integration` — Tool to create a Slack integration for a ChatBotKit bot. Use when you need to connect a bot to Slack by providing signing secret and bot token from Slack Developer Portal.
  - body: { meta?: object, name?: string, botId?: string, ratings?: boolean, botToken?: string, userToken?: string, references?: boolean, autoRespond?: string, description?: string, signingSecret?: string, sessionDuration?: integer, visibleMessages?: integer, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/space` — Tool to create a new space in ChatBotKit. Use when you need to create a workspace or organizational container for related resources.
  - body: { name?: string, contactId?: string }
- `POST https://api.mcp.ai/api/chatbotkit/create/task` — Tool to create a new background task that can be triggered to perform automated operations. Use when you need to set up scheduled or on-demand tasks with configurable bot and contact associations.
  - body: { name?: string, botId?: string, maxTime?: number, schedule?: string, contactId?: string, description?: string, maxIterations?: number, sessionDuration?: number }
- `POST https://api.mcp.ai/api/chatbotkit/create/telegram/integration` — Tool to create a Telegram integration for a ChatBotKit bot. Use when you need to connect a bot to Telegram by providing a Telegram bot token from BotFather.
  - body: { name?: string, botId: string, botToken: string, attachments?: boolean, description?: string, sessionDuration?: integer, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/trigger/integration` — Tool to create a Trigger integration for a ChatBotKit bot. Use when you need to set up automated triggers that can process events and execute bot actions on a schedule or based on specific conditions.
  - body: { name?: string, botId: string, maxTime?: integer, description?: string, authenticate?: boolean, maxIterations?: integer, sessionDuration?: integer, triggerSchedule?: object }
- `POST https://api.mcp.ai/api/chatbotkit/create/twilio/integration` — Tool to create a Twilio integration for a ChatBotKit bot. Use when you need to connect a bot to Twilio for SMS or messaging capabilities. All parameters are optional.
  - body: { botId?: string, sessionDuration?: integer, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/whats/app/integration` — Creates a new WhatsApp integration for a ChatBotKit bot. WhatsApp integrations enable your chatbot to communicate with users through WhatsApp messaging. Use this when you need to connect a bot to What
  - body: { meta?: object, name: string, botId?: string, accessToken?: string, attachments?: boolean, blueprintId?: string, description?: string, phoneNumberId?: string, sessionDuration?: number, contactCollection?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/widget/integration` — Tool to create a Widget integration for a ChatBotKit bot. Use when you need to create a web widget that can be embedded on websites to enable conversations with a bot.
  - body: { form?: boolean, math?: boolean, botId: string, intro?: string, theme?: string, title?: string, tools?: boolean, layout?: string, origin?: string, stream?: boolean, unfurl?: boolean, initial?: string, plugins?: string, verbose?: boolean, voiceIn?: boolean, carousel?: boolean, language?: string, maximize?: boolean, voiceOut?: boolean, poweredBy?: boolean, autoScroll?: boolean, startFirst?: boolean, attachments?: boolean, messagePeek?: boolean, placeholder?: string, sessionDuration?: number, contactCollection?: boolean, exportConversation?: boolean, restartConversation?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/create/widget/integration/session` — Creates a new widget integration session for interactive chat. Use this when you need to initialize a widget chat session with optional contact information, initial messages, and custom session durati
  - body: { meta?: object, contact?: object, messages?: object[], durationInSeconds?: integer, widget_integration_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/blueprint` — Tool to permanently delete a blueprint from ChatBotKit. Use when you need to remove a blueprint and optionally its associated resources.
  - body: { blueprintId: string, deleteResources?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/delete/blueprint/graphql` — Tool to permanently delete a blueprint template via GraphQL mutation. Use when you need to remove a blueprint from the platform using the GraphQL API.
  - body: { blueprintId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/bot` — Tool to delete a bot. Use when you need to permanently remove a bot from the system.
  - body: { botId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/bot/graphql` — Tool to delete a bot via GraphQL mutation. Use when you need to permanently remove a bot from the system using the GraphQL API.
  - body: { botId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/contact` — Tool to permanently delete a contact from ChatBotKit. Use when you need to remove a contact from the system.
  - body: { contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/conversation` — Tool to permanently delete a conversation from ChatBotKit. Use when you need to remove a conversation and all its associated messages.
  - body: { conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/conversation/message` — Tool to permanently delete a message from a conversation in ChatBotKit. Use when you need to remove a specific message from a conversation.
  - body: { messageId: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/dataset` — Tool to permanently delete a dataset from ChatBotKit. Use when you need to remove a dataset and all its associated data.
  - body: { datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/dataset/graphql` — Tool to delete a dataset via GraphQL mutation. Use when you need to permanently remove a dataset and all its associated records using the GraphQL API.
  - body: { datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/dataset/record` — Tool to permanently delete a record from a dataset. Use when you need to remove a specific record from a ChatBotKit dataset.
  - body: { recordId: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/discord/integration` — Tool to delete a Discord integration. Use when you need to permanently remove a Discord integration from the system.
  - body: { discordIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/email/integration` — Tool to permanently delete an Email integration from ChatBotKit. Use when you need to remove an Email integration from the system.
  - body: { emailIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/extract/integration` — Tool to delete an Extract integration. Use when you need to permanently remove an Extract integration from the system.
  - body: { extractIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/file` — Tool to permanently delete a file from ChatBotKit. Use when you need to remove a file from the system.
  - body: { fileId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/instagram/integration` — Tool to permanently delete an Instagram integration from ChatBotKit. Use when you need to remove an Instagram integration from the system.
  - body: { instagramIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/integration/graphql` — Tool to delete an integration via GraphQL mutation. Use when you need to permanently remove an integration from the system using the GraphQL API.
  - body: { integration_id: string, integration_type: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/mcp/server/integration` — Tool to delete an MCP Server integration. Use when you need to permanently remove an MCP Server integration from the system.
  - body: { mcpserverIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/memory` — Tool to permanently delete a memory from ChatBotKit. Use when you need to remove a memory from the system.
  - body: { memoryId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/messenger/integration` — Tool to permanently delete a Messenger integration from ChatBotKit. Use when you need to remove a Messenger integration from the system.
  - body: { messengerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/notion/integration` — Tool to permanently delete a Notion integration from ChatBotKit. Use when you need to remove a Notion integration from the system.
  - body: { notionIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/partner/user` — Tool to permanently delete a partner user account. Use when you need to clean up test or inactive accounts.
  - body: { userId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/rating` — Tool to permanently delete a rating from ChatBotKit. Use when you need to remove a rating from the system.
  - body: { ratingId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/secret` — Tool to permanently delete a secret from ChatBotKit. Use when you need to remove a secret from the system.
  - body: { secretId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/sitemap/integration` — Tool to permanently delete a Sitemap integration from ChatBotKit. Use when you need to remove a Sitemap integration from the system.
  - body: { sitemapIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/skillset` — Tool to delete a skillset. Use when you need to permanently remove a skillset from the system.
  - body: { skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/skillset/ability` — Tool to delete an ability from a skillset. Use when you need to remove a specific ability from a skillset.
  - body: { abilityId: string, skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/slack/integration` — Tool to delete a Slack integration. Use when you need to permanently remove a Slack integration from the system.
  - body: { slackIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/space` — Tool to permanently delete a space from ChatBotKit. Use when you need to remove a space from the system.
  - body: { spaceId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/support/integration` — Tool to delete a Support integration. Use when you need to permanently remove a Support integration from the system.
  - body: { supportIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/task` — Tool to permanently delete a task from ChatBotKit. Use when you need to remove a task from the system.
  - body: { taskId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/telegram/integration` — Tool to permanently delete a Telegram integration from ChatBotKit. Use when you need to remove a Telegram integration from the system.
  - body: { telegramIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/trigger/integration` — Tool to permanently delete a Trigger integration from ChatBotKit. Use when you need to remove a Trigger integration from the system.
  - body: { triggerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/twilio/integration` — Tool to delete a Twilio integration. Use when you need to permanently remove a Twilio integration from the system.
  - body: { twilioIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/whats/app/integration` — Tool to permanently delete a WhatsApp integration from ChatBotKit. Use when you need to remove a WhatsApp integration from the system.
  - body: { whatsappIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/delete/widget/integration` — Tool to delete a Widget integration. Use when you need to permanently remove a Widget integration from the system.
  - body: { widgetIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/detach/dataset/file` — Tool to detach a file from a dataset. Use when you need to remove a file's association with a dataset, optionally deleting its records.
  - body: { fileId: string, datasetId: string, deleteRecords?: boolean }
- `POST https://api.mcp.ai/api/chatbotkit/download/file` — Tool to download a file by its ID. Use when you need to retrieve a file's content from ChatBotKit.
  - body: { fileId: string }
- `POST https://api.mcp.ai/api/chatbotkit/downvote/bot` — Tool to downvote a bot in ChatBotKit. Use when you need to register negative feedback on a bot's performance or quality.
  - body: { botId: string, value?: integer, reason?: string }
- `POST https://api.mcp.ai/api/chatbotkit/downvote/conversation` — Tool to downvote a conversation in ChatBotKit. Use when you need to register negative feedback on a conversation's quality or outcome.
  - body: { value?: integer, reason?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/downvote/conversation/message` — Tool to downvote a conversation message in ChatBotKit. Use when you need to register negative feedback on a message's quality or appropriateness.
  - body: { value?: integer, reason?: string, messageId: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/ensure/contact` — Tool to ensure a contact exists or create a new one. Use when you need to create or retrieve a contact by fingerprint, ensuring idempotent contact management.
  - body: { nick?: string, email?: string, phone?: string, verifiedAt?: integer, fingerprint: string, preferences?: string }
- `POST https://api.mcp.ai/api/chatbotkit/execute/graphql/query` — Tool to execute a GraphQL query or mutation against the ChatBotKit API. Use when you need to run custom GraphQL queries to retrieve or modify data in flexible ways not covered by other actions.
  - body: { query: string, variables?: object, operationName?: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/contacts` — Tool to export contacts with pagination support. Use when you need to retrieve or export contact information from ChatBotKit.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/conversations` — Tool to export conversations with pagination support. Use when you need to retrieve and export conversation data in bulk for analysis, backup, or migration purposes.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/dataset/records` — Tool to export dataset records with pagination support. Use when you need to retrieve or export record data from a specific ChatBotKit dataset.
  - body: { take?: integer, order?: string, cursor?: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/event/logs` — Tool to export event logs with pagination support. Use when you need to retrieve and export event log data for monitoring, auditing, or analysis purposes.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/memories` — Tool to export memories with pagination support. Use when you need to retrieve or export memory information from ChatBotKit.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/skillset/abilities` — Tool to export all abilities from a specific skillset with pagination support. Use when you need to retrieve the complete list of abilities within a skillset.
  - body: { take?: integer, order?: string, cursor?: string, skillset_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/spaces` — Tool to export spaces with pagination support. Use when you need to retrieve or export space data in bulk for analysis, backup, or migration purposes.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/export/tasks` — Tool to export tasks with pagination support. Use when you need to retrieve and export task data in bulk for analysis, backup, or migration purposes.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/blueprint` — Tool to fetch a blueprint by ID. Use when you need to retrieve detailed information about a specific blueprint.
  - body: { blueprintId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/blueprint/graphql` — Tool to fetch a single blueprint by ID using GraphQL. Returns detailed blueprint information including template configuration. Use when you need structured GraphQL response format with complete bluepr
  - body: { blueprint_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/bot` — Tool to fetch a specific bot by its ID. Use when you need detailed information about a particular bot including configuration, model, dataset, and skillset associations.
  - body: { botId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/bot/graphql` — Tool to fetch a single bot by ID using GraphQL query. Use when you need to retrieve bot configuration, backstory, model, and other details via the GraphQL API.
  - body: { botId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/bot/usage` — Tool to fetch bot usage statistics for a specific bot. Use when you need to retrieve metrics like conversations, messages, and token usage for a given time period.
  - body: { bot_id: string, to_date?: string, from_date?: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/contact` — Tool to retrieve detailed information about a specific contact by ID. Use when you need to access contact details including email, phone, fingerprint, and preferences.
  - body: { contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/conversation` — Tool to retrieve full details of a specific conversation by its ID. Use when you need complete information about a conversation including its configuration, metadata, and associated resources.
  - body: { conversation_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/conversation/message` — Tool to retrieve full details of a specific message within a conversation. Use when you need complete information about a particular message including its content, type, and metadata.
  - body: { message_id: string, conversation_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/conversation/usage` — Tool to fetch usage statistics for a specific conversation. Use when you need to retrieve token and message counts for billing, monitoring, or analytics purposes.
  - body: { to?: string, from?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/conversation/with/messages/graphql` — Tool to fetch a single conversation by ID with messages and metadata using GraphQL. Returns detailed conversation information including all messages, associated bot, contact, space, and task. Use when
  - body: { after?: string, first?: integer, conversation_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/dataset` — Tool to fetch a specific dataset by its ID. Use when you need detailed information about a particular dataset including configuration, storage, search settings, and content instructions.
  - body: { datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/dataset/graphql` — Tool to fetch a single dataset by ID using GraphQL. Use when you need to retrieve dataset details (name, description, timestamps) via the GraphQL endpoint.
  - body: { dataset_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/dataset/record` — Tool to fetch a specific record from a dataset by its ID. Use when you need to retrieve detailed information about a particular dataset record including its text content, source, and metadata.
  - body: { recordId: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/discord/integration` — Tool to fetch a specific Discord integration by its ID. Use when you need detailed information about a particular Discord integration including configuration, bot association, and metadata.
  - body: { discordIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/email/integration` — Tool to fetch a specific Email integration by its ID. Use when you need detailed information about a particular Email integration including configuration, bot association, and settings.
  - body: { emailIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/extract/integration` — Tool to fetch a specific Extract integration by its ID. Use when you need detailed information about a particular Extract integration including configuration, bot association, request template, and ex
  - body: { extractIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/file` — Tool to retrieve detailed metadata about a specific file by its ID. Use when you need file information including name, type, size, and visibility settings. Note: This returns file metadata, not the ac
  - body: { fileId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/file/graphql` — Tool to fetch a single file by ID using GraphQL. Returns detailed file information including name, description, timestamps, and metadata. Use when you need structured GraphQL response format.
  - body: { file_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/instagram/integration` — Tool to fetch a specific Instagram integration by its ID. Use when you need detailed information about a particular Instagram integration including access token, configuration, and metadata.
  - body: { instagramIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/mcpserver/integration` — Tool to fetch a specific MCP Server integration by its ID. Use when you need detailed information about a particular MCP Server integration including configuration, skillset, and blueprint association
  - body: { mcpserverIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/memory` — Tool to retrieve detailed information about a specific memory by ID. Use when you need to access the content and metadata of a particular memory entry.
  - body: { memoryId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/messenger/integration` — Tool to fetch a specific Messenger integration by its ID. Use when you need detailed information about a particular Messenger integration including configuration, bot association, and settings.
  - body: { messengerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/notion/integration` — Tool to fetch a specific Notion integration by its ID. Use when you need detailed information about a particular Notion integration including dataset association, sync status, and metadata.
  - body: { notionIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/platform/doc` — Tool to fetch a specific platform documentation by its ID. Use when you need to retrieve documentation content for ChatBotKit platform features.
  - body: { docId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/platform/example` — Tool to fetch a specific platform example with full configuration details by its ID. Use when you need to retrieve complete information about a ChatBotKit example including its type, config, and assoc
  - body: { exampleId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/platform/manual` — Tool to fetch a specific platform manual by its ID. Use when you need documentation or help content for a particular platform feature or resource type (e.g., datasets, skillsets, bots).
  - body: { manualId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/platform/manuals/graphql` — Tool to fetch platform manuals using GraphQL query by search query or specific IDs. Use when you need to retrieve documentation manuals for ChatBotKit platform features via GraphQL.
  - body: { take?: integer, search?: string, platformManualIds?: string[] }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/platform/tutorial` — Tool to fetch a specific platform tutorial by its ID. Use when you need to retrieve tutorial content for ChatBotKit platform features.
  - body: { tutorialId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/platform/tutorials` — Tool to fetch platform tutorials by search query or IDs. Use when you need to search for tutorials or retrieve specific tutorials to help with ChatBotKit platform features.
  - body: { take?: integer, search?: string, platformTutorialIds?: string[] }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/rating` — Tool to retrieve detailed information about a specific rating by ID. Use when you need to access rating details including value, reason, and associated entities.
  - body: { id: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/secret` — Tool to fetch a secret by ID. Use when you need to retrieve detailed information about a specific secret.
  - body: { secretId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/sitemap/integration` — Tool to fetch a specific Sitemap integration by its ID. Use when you need detailed information about a particular Sitemap integration including configuration, dataset association, URL patterns, and sy
  - body: { sitemapIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/skillset` — Tool to fetch a specific skillset by its ID. Use when you need detailed information about a particular skillset.
  - body: { skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/skillset/ability` — Tool to fetch detailed information about a specific ability from a skillset. Use when you need to retrieve ability configuration, instructions, and associated resources.
  - body: { abilityId: string, skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/skillset/graphql` — Tool to fetch a single skillset by ID using GraphQL. Use when you need to retrieve skillset details via the GraphQL API.
  - body: { skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/slack/integration` — Tool to fetch a specific Slack integration by its ID. Use when you need detailed information about a particular Slack integration including configuration, bot association, and metadata.
  - body: { slackIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/space` — Tool to retrieve detailed information about a specific space by ID. Use when you need to access space details including name, description, blueprint, and associated contact.
  - body: { spaceId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/support/integration` — Tool to fetch a specific Support integration by its ID. Use when you need detailed information about a particular Support integration including configuration, bot association, and metadata.
  - body: { supportIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/task` — Tool to retrieve details of a specific task by its ID. Use when you need to check the status, outcome, or configuration of a particular task.
  - body: { taskId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/telegram/integration` — Tool to fetch a specific Telegram integration by its ID. Use when you need detailed information about a particular Telegram integration including configuration, bot association, and metadata.
  - body: { telegramIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/trigger/integration` — Tool to fetch a specific trigger integration by its ID. Use when you need detailed information about a particular trigger integration including configuration, schedule, authentication, and associated 
  - body: { triggerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/twilio/integration` — Tool to fetch a specific Twilio integration by its ID. Use when you need detailed information about a particular Twilio integration including configuration, bot association, and metadata.
  - body: { twilioIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/usage` — Tool to fetch account-wide usage statistics including tokens, conversations, messages, and database resources. Use when you need overall usage metrics for billing, monitoring, or analytics purposes.
- `POST https://api.mcp.ai/api/chatbotkit/fetch/usage/series` — Tool to fetch usage series data for the last 90 days. Use when you need to analyze token usage, conversation counts, or message counts over time.
- `POST https://api.mcp.ai/api/chatbotkit/fetch/whatsapp/integration` — Tool to fetch a specific WhatsApp integration by its ID. Use when you need detailed information about a particular WhatsApp integration including configuration, bot association, and settings.
  - body: { whatsappIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/fetch/widget/integration` — Tool to fetch a specific Widget integration by its ID. Use when you need detailed information about a particular Widget integration including configuration, bot association, and widget settings.
  - body: { widgetIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/generate/report` — Tool to generate a specific report with time-series breakdowns. Use when you need usage statistics, event metrics, or analytics data for a specific time period.
  - body: { reportId: string, periodDays?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/generate/reports` — Tool to generate multiple reports simultaneously. Use when you need to retrieve analytics, metrics, or statistical data from ChatBotKit. Report IDs can be obtained from the platform report list endpoi
  - body: { report_configs: object }
- `POST https://api.mcp.ai/api/chatbotkit/get/audit/log/export` — Tool to export audit log entries showing user actions and system events. Use when you need to retrieve audit records for monitoring, compliance, or security analysis.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/get/event/metric/series` — Tool to fetch event metric time series data for a specific metric type. Use when you need to retrieve historical metric data points for analytics, monitoring, or reporting purposes.
  - body: { type: string }
- `POST https://api.mcp.ai/api/chatbotkit/get/rating/export` — Tool to export ratings with pagination support. Use when you need to retrieve and export rating data in bulk for analysis, backup, or migration purposes.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/get/rating/list` — Tool to retrieve a paginated list of ratings. Use when you need to browse, filter, or analyze ratings data.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/invoke/trigger/integration` — Tool to invoke a trigger integration in ChatBotKit. Use when you need to manually trigger a specific trigger integration.
  - body: { triggerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/audit/logs` — Tool to retrieve a paginated list of audit logs. Use when you need to review system activity, security events, or compliance tracking.
  - body: { limit?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/blueprint/resources` — Tool to list the resources of a blueprint. Use when you need to retrieve all resources associated with a specific blueprint.
  - body: { blueprintId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/blueprints` — Tool to retrieve a list of blueprints. Use when you need to browse or paginate through available blueprint templates.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/blueprints/graphql` — Tool to list all blueprints using GraphQL with cursor-based pagination. Use when you need to browse blueprint templates via GraphQL endpoint with edges/node connection pattern.
  - body: { last?: integer, after?: string, first?: integer, before?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/bots` — Tool to retrieve a paginated list of all bots. Use when you need to browse or manage multiple bots, and iterate pages via cursor.
  - body: { take?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/bots/graphql` — Tool to query bots via GraphQL with pagination support. Use when you need to retrieve a list of bots using the GraphQL API.
  - body: { after?: string, first?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/list/contact/conversations` — Tool to retrieve a paginated list of conversations for a specific contact. Use when you need to view all conversations associated with a contact.
  - body: { take?: integer, order?: string, cursor?: string, contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contact/memories` — Tool to retrieve a paginated list of memories for a specific contact. Use when you need to browse or access memory entries associated with a contact.
  - body: { take?: integer, order?: string, cursor?: string, contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contact/ratings` — Tool to retrieve ratings submitted by a specific contact. Use when you need to monitor conversation quality, identify areas for improvement, and track user satisfaction with AI-generated responses.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string, contact_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contact/secrets` — Tool to retrieve a paginated list of secrets for a specific contact. Use when you need to browse or access secret entries associated with a contact.
  - body: { take?: integer, order?: string, cursor?: string, contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contact/spaces` — Tool to retrieve a paginated list of spaces for a specific contact. Use when you need to fetch all spaces associated with a particular contact ID.
  - body: { take?: integer, order?: string, cursor?: string, contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contact/tasks` — Tool to retrieve a paginated list of tasks for a specific contact. Use when you need to view all tasks associated with a particular contact.
  - body: { take?: integer, order?: string, cursor?: string, contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contacts` — Tool to retrieve a paginated list of contacts. Contacts represent users interacting with bots. Use when you need to browse, filter, or manage multiple contacts.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/contacts/with/pagination` — Tool to list contacts with full pagination support using GraphQL. Returns contact information including ID, name, email, metadata, and timestamps, along with pagination details. Use when you need to r
  - body: { after?: string, first?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/list/conversation/messages` — Tool to list messages in a conversation with pagination. Use after obtaining a conversation ID to fetch messages page by page.
  - body: { take?: integer, order?: string, cursor?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/conversations` — Tool to retrieve a paginated list of conversations. Use when you need to page through conversation history.
  - body: { take?: integer, order?: string, accept?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/conversations/graphql` — Tool to retrieve conversations using GraphQL with cursor-based pagination. Use when you need to list all conversations with Relay-style pagination support.
  - body: { after?: string, first?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/list/dataset/files` — Tool to retrieve a list of files in a dataset. Use when you need to browse or paginate through dataset files.
  - body: { take?: integer, order?: string, cursor?: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/dataset/records` — Tool to list records in a dataset with pagination. Use after obtaining a dataset ID to retrieve all records or paginate through them.
  - body: { take?: integer, order?: string, cursor?: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/datasets` — Tool to list datasets. Use when you need to browse or paginate through available datasets.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/datasets/graphql` — Tool to list all datasets using GraphQL with cursor-based pagination. Use when you need to browse datasets via GraphQL endpoint. Supports forward pagination with 'first' and 'after', or backward pagin
  - body: { last?: integer, after?: string, first?: integer, before?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/discord/integrations` — Tool to retrieve a list of Discord integrations. Use when you need to browse or manage configured Discord integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/email/integrations` — Tool to retrieve a list of email integrations. Use when you need to browse or manage configured email integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/event/logs` — Tool to retrieve a paginated list of event logs. Use when you need to browse system events, audit activity, or analyze event history.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/event/metrics` — Tool to list event metrics for the authenticated account. Use when you need to retrieve analytics and monitoring data about platform events.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/extract/integrations` — Tool to retrieve a list of Extract integrations. Use when you need to browse or manage configured Extract integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/files` — Tool to retrieve a list of files. Use when you need to browse or paginate through available files that can be attached to datasets.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/files/graphql` — Tool to list files using GraphQL query with connection-based pagination. Use when you need to retrieve files via GraphQL endpoint with edges/nodes structure.
  - body: { last?: integer, after?: string, first?: integer, before?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/instagram/integrations` — Tool to retrieve a list of Instagram integrations. Use when you need to browse or manage configured Instagram integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/integrations/graphql` — Tool to list integrations with pagination using GraphQL query. Use when you need to retrieve multiple integration records with cursor-based pagination support.
  - body: { first?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/list/magic/prompts` — Tool to retrieve a list of magic prompts. Use when you need to browse or enumerate available magic prompts in the system.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/mcp/server/integrations` — Tool to retrieve a list of MCP Server integrations. Use when you need to browse or manage configured MCP Server integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/memories` — Tool to retrieve a paginated list of memories. Use when you need to browse or access memory entries across the system.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/messages/graphql` — Tool to list messages for one or more conversations using GraphQL. Returns messages in GraphQL connection pattern with edges/node structure. Use when you need to fetch messages across multiple convers
  - body: { after?: string, first?: integer, conversationIds: string[] }
- `POST https://api.mcp.ai/api/chatbotkit/list/messenger/integrations` — Tool to retrieve a list of Messenger integrations. Use when you need to browse or manage configured Messenger integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/notion/integrations` — Tool to retrieve a list of Notion integrations. Use when you need to browse or manage configured Notion integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/partners` — Tool to retrieve a list of all partner accounts associated with the main account. Use when you need to view or manage all sub-accounts under your partner umbrella.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/abilities` — Tool to retrieve a list of platform abilities. Use when you need to browse available abilities or capabilities provided by the platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/actions` — Tool to retrieve a paginated list of platform actions. Use when you need to browse available actions or discover what actions are supported by the platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/docs` — Tool to retrieve a list of platform documentation items. Use when you need to browse available documentation or discover what documentation is available for the ChatBotKit platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/examples` — Tool to retrieve a list of platform examples from ChatBotKit. Use when you need to browse available example templates and resources.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/guides` — Tool to retrieve a list of platform guides. Use when you need to browse available guides or tutorials for the platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/manuals` — Tool to retrieve a list of platform manuals. Use when you need to browse available documentation and help resources for the ChatBotKit platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/models` — Tool to retrieve a list of available platform models. Use when you need to browse AI models available on the platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/reports` — Tool to retrieve a list of available platform reports. Use when you need to view or analyze system-generated reports.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/secrets` — Tool to retrieve a paginated list of platform secrets. Use when you need to browse or access secret entries at the platform level.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/platform/tutorials` — Tool to retrieve a list of platform tutorials. Use when you need to browse or discover available tutorials for learning how to use the ChatBotKit platform.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/policies` — Tool to retrieve a list of policies. Use when you need to browse available policies or filter by metadata.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/portals` — Tool to retrieve a list of portals. Use when you need to browse or paginate through available portals.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/portals/graphql` — Tool to retrieve a paginated list of portals using GraphQL. Use when you need to query portals via GraphQL with cursor-based pagination.
  - body: { after?: string, first?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/list/secrets` — Tool to retrieve a list of secrets. Use when you need to browse or access credentials for external service integrations.
  - body: { take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/secrets/graphql` — Tool to list all secrets using GraphQL with cursor-based pagination. Use when you need to retrieve secrets stored in ChatBotKit. Supports forward pagination with 'first' and 'after', or backward pagin
  - body: { last?: integer, after?: string, first?: integer, before?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/sitemap/integrations` — Tool to retrieve a list of Sitemap integrations. Use when you need to browse or manage configured Sitemap integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/skillset/abilities` — Tool to retrieve a list of abilities within a specific skillset. Use when you need to enumerate abilities for a given skillset.
  - body: { take?: integer, order?: string, cursor?: string, skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/skillsets` — Tool to retrieve a list of all skillsets available in the system. Use when you need to enumerate existing skillsets.
  - body: { take?: integer, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/skillsets/graphql` — Tool to list skillsets using GraphQL query with connection-based pagination. Use when you need to retrieve skillsets via GraphQL endpoint with edges/nodes structure.
  - body: { last?: integer, after?: string, first?: integer, before?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/slack/integrations` — Tool to retrieve a list of Slack integrations. Use when you need to browse or manage configured Slack integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/spaces` — Tool to retrieve a paginated list of spaces. Spaces are containers for organizing bot resources. Use when you need to browse or manage multiple spaces.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/support/integrations` — Tool to retrieve a list of support integrations. Use when you need to browse or manage configured support integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/tasks` — Tool to retrieve a paginated list of tasks. Use when you need to view all tasks, optionally filtered by bot, contact, status, or metadata.
  - body: { meta?: object, take?: integer, botId?: string, order?: string, cursor?: string, status?: string, contactId?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/teams` — Tool to retrieve a paginated list of teams. Use when you need to browse or manage multiple teams.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/telegram/integrations` — Tool to retrieve a list of Telegram integrations. Use when you need to browse or manage configured Telegram integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/tokens` — Tool to retrieve a list of all API tokens. Use when you need to audit or manage existing tokens.
- `POST https://api.mcp.ai/api/chatbotkit/list/twilio/integrations` — Tool to retrieve a list of Twilio integrations. Use when you need to browse or manage configured Twilio integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/whats/app/integrations` — Tool to retrieve a list of WhatsApp integrations. Use when you need to browse or manage configured WhatsApp integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/list/widget/integrations` — Tool to retrieve a list of widget integrations. Use when you need to browse or manage configured widget integrations and iterate pages via cursor.
  - body: { meta?: object, take?: integer, order?: string, cursor?: string }
- `POST https://api.mcp.ai/api/chatbotkit/publish/channel/message` — Publish a message to a ChatBotKit channel. Use this action when you need to send messages to a specific channel identified by its channel ID.
  - body: { message: object, channel_id: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/bot/memory` — Tool to search memories for a specific bot. Use when you need to retrieve stored memories that match a keyword or phrase.
  - body: { botId: string, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/contact/memory` — Tool to search memories for a specific contact by keyword or phrase. Use when you need to find specific information stored in a contact's memory.
  - body: { search: string, contactId: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/dataset` — Tool to search a dataset for records matching a given search query. Uses semantic search for finding relevant records. Use when you need to retrieve stored data from a dataset based on a keyword or ph
  - body: { filter?: object, search: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/memory` — Tool to search memories for records matching a given search query. Use when you need to find specific memories, optionally filtered by bot or contact.
  - body: { botId?: string, search: string, contactId?: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/abilities` — Tool to search platform abilities using semantic similarity. Use when you need to find relevant abilities or tools based on a query.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/docs` — Tool to search platform documentation using semantic similarity. Use when you need to find relevant documentation, guides, or help articles based on a query.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/docs/graphql` — Tool to search platform documentation by search query via GraphQL and retrieve docs with id, name, excerpt, and link. Use when you need to find relevant ChatBotKit documentation using the GraphQL API.
  - body: { take?: integer, search?: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/examples` — Tool to search platform examples using semantic similarity. Use when you need to find relevant examples, templates, or code snippets from the platform's example library.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/guides` — Tool to search platform guides using semantic similarity. Use when you need to find relevant documentation, tutorials, or guides based on a search query.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/manuals` — Tool to search platform manuals using semantic similarity. Use when you need to find documentation, guides, or help resources related to a specific topic or question.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/secrets` — Tool to search platform secrets using semantic similarity. Use when you need to find secrets that match a particular topic or keyword using intelligent matching.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/search/platform/tutorials` — Tool to search platform tutorials using semantic similarity. Use when you need to find relevant tutorials, documentation, or guides on specific topics.
  - body: { take?: integer, search: string }
- `POST https://api.mcp.ai/api/chatbotkit/set/up/email/integration` — Tool to setup an email integration in ChatBotKit. Use when you need to activate or configure an existing email integration for use with a bot.
  - body: { emailIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/set/up/trigger/integration` — Tool to setup a trigger integration in ChatBotKit. Use when you need to activate or configure an existing trigger integration for use with a bot.
  - body: { triggerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/set/up/twilio/integration` — Tool to setup a Twilio integration in ChatBotKit. Use when you need to activate or configure an existing Twilio integration for use with a bot.
  - body: { twilioIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/set/up/whats/app/integration` — Tool to setup a WhatsApp integration in ChatBotKit. Use when you need to activate or configure an existing WhatsApp integration for use with a bot.
  - body: { whatsappIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/set/up/widget/integration` — Tool to setup a Widget integration in ChatBotKit. Use when you need to activate or configure an existing Widget integration for use with a bot.
  - body: { widgetIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/subscribe/channel` — Tool to subscribe to messages from a ChatBotKit channel. Use this when you need to monitor and receive messages from a specific channel. The subscription works by first replaying historical messages (
  - body: { channel_id: string, history_length?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/sync/dataset/file` — Tool to sync a dataset file. Use when you need to synchronize a file within a dataset to ensure its content is up-to-date and available for use by the bot.
  - body: { fileId: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/sync/file` — Tool to sync a file. Use when you need to synchronize a file to ensure its content is up-to-date and available for use.
  - body: { fileId: string }
- `POST https://api.mcp.ai/api/chatbotkit/sync/notion/integration` — Tool to sync a Notion integration with ChatBotKit. Use when you need to manually trigger synchronization of content between Notion pages and the associated ChatBotKit dataset.
  - body: { notionIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/sync/sitemap/integration` — Tool to sync a sitemap integration. Use when you need to trigger an immediate sync of a sitemap integration to refresh the dataset with the latest content from the website.
  - body: { sitemapIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/synthesize/conversation/message` — Tool to convert a conversation message into speech audio. Use when you need to synthesize text from a message into audio format.
  - body: { messageId: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/trigger/extract/integration` — Tool to trigger an extract integration on historic conversations in ChatBotKit. Use when you need to process past conversations with an extract integration, either by specifying a sample size or speci
  - body: { sample?: integer, conversationIds?: string[], extractIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/trigger/support/integration` — Tool to trigger a support integration on historic conversations in ChatBotKit. Use when you need to process past conversations with a support integration, either by specifying a sample size or specifi
  - body: { sample?: integer, conversationIds?: string[], supportIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/trigger/task` — Tool to trigger execution of a background task. Use when you need to manually start or restart a task.
  - body: { taskId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/blueprint` — Tool to update an existing blueprint. Use when you need to modify blueprint properties such as name, description, visibility, or metadata.
  - body: { meta?: object, name?: string, alias?: string, visibility?: string, blueprintId: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/blueprint/graphql` — Tool to update an existing blueprint using GraphQL mutation. Use when you need to modify a blueprint's properties via the GraphQL API.
  - body: { input: object, blueprintId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/bot` — Tool to update an existing bot's configuration and properties. Use when you need to modify a bot's name, description, model, backstory, associated datasets/skillsets, or other settings.
  - body: { meta?: object, name?: string, alias?: string, botId: string, model?: string, privacy?: boolean, backstory?: string, datasetId?: string, moderation?: boolean, skillsetId?: string, visibility?: string, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/bot/graphql` — Tool to update an existing bot using GraphQL mutation. Use when you need to modify a bot's properties via the GraphQL API.
  - body: { botId: string, input: object }
- `POST https://api.mcp.ai/api/chatbotkit/update/contact` — Tool to update an existing contact's information. Use when you need to modify contact details like email, nickname, phone number, or preferences.
  - body: { nick?: string, email?: string, phone?: string, contact_id: string, fingerprint?: string, preferences?: string, verified_at?: integer }
- `POST https://api.mcp.ai/api/chatbotkit/update/conversation` — Tool to update an existing conversation's properties. Use when you need to modify conversation metadata, bot configuration, or associated resources like contacts, tasks, or spaces.
  - body: { meta?: object, name?: string, botId?: string, model?: string, taskId?: string, privacy?: boolean, spaceId?: string, backstory?: string, contactId?: string, datasetId?: string, moderation?: boolean, skillsetId?: string, description?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/conversation/message` — Tool to update an existing message in a conversation. Use this to modify the text, entities, or type of a previously created message.
  - body: { text?: string, type?: string, entities?: object[], messageId: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/dataset` — Tool to update an existing dataset's configuration and properties. Use when you need to modify a dataset's name, description, visibility, search settings, or other configuration options.
  - body: { meta?: object, name?: string, alias?: string, store?: string, reranker?: string, datasetId: string, separators?: string, visibility?: string, description?: string, searchMinScore?: number, recordMaxTokens?: number, searchMaxTokens?: number, matchInstruction?: string, searchMaxRecords?: number, mismatchInstruction?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/dataset/graphql` — Tool to update an existing dataset using GraphQL mutation. Use when you need to modify a dataset's properties such as name, description, search configuration, visibility, or metadata via the GraphQL A
  - body: { input: object, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/dataset/record` — Tool to update an existing record in a dataset. Use when you need to modify text data or metadata in an existing dataset record.
  - body: { meta?: object, text?: string, source?: string, recordId: string, datasetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/discord/integration` — Tool to update an existing Discord integration's configuration. Use when you need to modify Discord integration settings such as bot token, session duration, contact collection, or associated bot/blue
  - body: { meta?: object, name?: string, appId?: string, botId?: string, handle?: string, botToken?: string, publicKey?: string, blueprintId?: string, description?: string, sessionDuration?: integer, contactCollection?: boolean, discordIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/email/integration` — Tool to update an existing Email integration's configuration and properties. Use when you need to modify an Email integration's settings such as allowed sender emails, attachment handling, contact col
  - body: { meta?: object, name?: string, botId?: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: number, contactCollection?: boolean, emailIntegrationId: string, allowedSenderEmails?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/extract/integration` — Tool to update an existing Extract integration's configuration. Use when you need to modify an Extract integration's model, extraction request, schema, associated bot, or other settings.
  - body: { meta?: object, name?: string, botId?: string, model?: string, schema?: object, request?: string, blueprintId?: string, description?: string, extractIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/file` — Tool to update an existing file's metadata and properties. Use when you need to modify a file's name, description, visibility, or other configuration settings.
  - body: { meta?: object, name?: string, alias?: string, fileId: string, visibility?: string, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/file/graphql` — Tool to update an existing file using GraphQL mutation. Use when you need to modify a file's name, description, visibility, or other properties via the GraphQL API endpoint.
  - body: { input: object, fileId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/instagram/integration` — Tool to update an existing Instagram integration's configuration. Use when you need to modify Instagram integration settings such as access token, session duration, contact collection, attachments, or
  - body: { meta?: object, name?: string, botId?: string, accessToken?: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: integer, contactCollection?: boolean, instagramIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/integration/graphql` — Tool to update trigger integration configuration and settings using GraphQL mutation. Use when you need to modify a trigger integration's properties such as name, description, metadata, authentication
  - body: { input: object, triggerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/mcpserver/integration` — Tool to update an existing MCP Server integration. Use when you need to modify properties of an MCP (Model Context Protocol) Server integration such as name, description, associated skillset or bluepr
  - body: { meta?: object, name?: string, skillsetId?: string, blueprintId?: string, description?: string, mcpserverIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/memory` — Tool to update an existing memory's text or associations. Use when you need to modify memory content or change its bot/contact associations.
  - body: { text?: string, botId?: string, memoryId: string, contactId?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/messenger/integration` — Tool to update an existing Messenger integration's configuration. Use when you need to modify Messenger integration settings such as access token, session duration, attachments, or associated bot/blue
  - body: { meta?: object, name?: string, botId?: string, accessToken?: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: integer, messengerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/notion/integration` — Tool to update an existing Notion integration's configuration and properties. Use when you need to modify a Notion integration's settings such as sync schedule, token, dataset association, or expirati
  - body: { meta?: object, name?: string, token?: string, datasetId?: string, expiresIn?: number, blueprintId?: string, description?: string, syncSchedule?: string, notionIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/partner/user` — Tool to update an existing partner user's information. Use when you need to modify partner user details like email, profile image, or resource limits.
  - body: { email?: string, image?: string, limits?: object, userId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/rating` — Tool to update an existing rating by ID. Use when you need to modify a rating's value or associated metadata. Ratings track user feedback (upvotes/downvotes) for contacts, bots, conversations, and mes
  - body: { id: string, meta?: object, name?: string, botId?: string, value?: integer, reason?: string, contactId?: string, messageId?: string, description?: string, conversationId?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/secret` — Tool to update an existing secret's configuration and properties. Use when you need to modify a secret's name, description, value, type, or other settings.
  - body: { kind?: string, meta?: object, name?: string, type?: string, alias?: string, value?: string, config?: object, secretId: string, visibility?: string, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/secret/graphql` — Tool to update an existing secret via GraphQL mutation. Use when you need to modify a secret's properties using the GraphQL API.
  - body: { input: object, secretId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/sitemap/integration` — Tool to update an existing Sitemap integration's configuration. Use when you need to modify sitemap URL, glob patterns, sync schedule, dataset association, or crawling settings like JavaScript renderi
  - body: { url?: string, glob?: string, meta?: object, name?: string, datasetId?: string, expiresIn?: number, selectors?: string, javascript?: boolean, blueprintId?: string, description?: string, syncSchedule?: string, sitemapIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/skillset` — Tool to update an existing skillset's configuration and properties. Use when you need to modify a skillset's name, description, visibility, or other settings.
  - body: { meta?: object, name?: string, alias?: string, skillsetId: string, visibility?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/skillset/ability` — Tool to update an existing ability within a skillset. Use when you need to modify ability properties like name, description, instruction, or associated resources.
  - body: { meta?: object, name?: string, botId?: string, fileId?: string, spaceId?: string, secretId?: string, abilityId: string, skillsetId: string, blueprintId?: string, description?: string, instruction?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/skillset/graphql` — Tool to update an existing skillset using GraphQL mutation. Use when you need to modify a skillset's properties such as name, description, or abilities via the GraphQL API.
  - body: { input: object, skillsetId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/slack/integration` — Tool to update an existing Slack integration's configuration. Use when you need to modify Slack integration settings such as bot token, signing secret, session duration, contact collection, ratings, o
  - body: { meta?: object, name?: string, botId?: string, ratings?: boolean, botToken?: string, userToken?: string, references?: boolean, autoRespond?: string, blueprintId?: string, description?: string, signingSecret?: string, sessionDuration?: integer, visibleMessages?: integer, contactCollection?: boolean, slackIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/space` — Tool to update an existing space's configuration and properties. Use when you need to modify a space's name, description, associated blueprint, contact, or other settings.
  - body: { meta?: object, name?: string, alias?: string, spaceId: string, contactId?: string, blueprintId?: string, description?: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/support/integration` — Tool to update an existing Support integration's configuration and properties. Use when you need to modify a Support integration's email, name, description, or associated bot/blueprint.
  - body: { meta?: object, name?: string, botId?: string, email?: string, blueprintId?: string, description?: string, supportIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/task` — Tool to update an existing task's configuration and properties. Use when you need to modify a task's schedule, bot/contact associations, or execution parameters.
  - body: { botId?: string, taskId: string, maxTime?: number, schedule?: string, contactId?: string, maxIterations?: number, sessionDuration?: number }
- `POST https://api.mcp.ai/api/chatbotkit/update/telegram/integration` — Tool to update an existing Telegram integration's configuration and properties. Use when you need to modify a Telegram integration's settings such as bot token, session duration, attachment handling, 
  - body: { meta?: object, name?: string, botId?: string, botToken?: string, attachments?: boolean, blueprintId?: string, description?: string, sessionDuration?: integer, contactCollection?: boolean, telegramIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/trigger/integration` — Tool to update an existing Trigger integration's configuration. Use when you need to modify Trigger integration settings such as name, description, metadata, associated bot/blueprint, or authenticatio
  - body: { meta?: object, name?: string, botId?: string, blueprintId?: string, description?: string, authenticate?: boolean, triggerIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/twilio/integration` — Tool to update an existing Twilio integration's configuration. Use when you need to modify Twilio integration settings such as name, description, session duration, contact collection, or associated bo
  - body: { meta?: object, name?: string, botId?: string, blueprintId?: string, description?: string, sessionDuration?: integer, contactCollection?: boolean, twilioIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/whats/app/integration` — Tool to update an existing WhatsApp integration's configuration. Use when you need to modify WhatsApp integration settings such as access token, phone number ID, session duration, contact collection, 
  - body: { meta?: object, name?: string, botId?: string, accessToken?: string, attachments?: boolean, blueprintId?: string, description?: string, phoneNumberId?: string, sessionDuration?: integer, contactCollection?: boolean, whatsappIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/update/widget/integration` — Tool to update an existing Widget integration's configuration. Use when you need to modify widget settings such as title, theme, placeholder text, auto-scroll behavior, or other display and functional
  - body: { form?: boolean, math?: boolean, meta?: object, name?: string, botId?: string, intro?: string, theme?: string, title?: string, tools?: boolean, layout?: string, origin?: string, stream?: boolean, unfurl?: boolean, initial?: string, plugins?: string, verbose?: boolean, voiceIn?: boolean, carousel?: boolean, language?: string, maximize?: boolean, voiceOut?: boolean, poweredBy?: boolean, autoScroll?: boolean, startFirst?: boolean, attachments?: boolean, blueprintId?: string, description?: string, messagePeek?: boolean, placeholder?: string, sessionDuration?: number, contactCollection?: boolean, exportConversation?: boolean, restartConversation?: boolean, widgetIntegrationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/upload/conversation/attachment` — Upload a file as a conversation attachment in ChatBotKit. This action creates an attachment record and returns upload details. Use when you need to attach files (documents, images, etc.) to a conversa
  - body: { file: object, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/upload/file` — Tool to upload content to an existing file resource in ChatBotKit. Use when you need to populate a file resource with actual file data.
  - body: { file: object, fileId: string }
- `POST https://api.mcp.ai/api/chatbotkit/upsert/conversation/contact` — Tool to upsert (create or update) contact information for a conversation in ChatBotKit. Use when you need to associate contact details like email, phone, or nickname with a conversation.
  - body: { nick?: string, email?: string, phone?: string, fingerprint?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/upvote/bot` — Tool to upvote a bot in ChatBotKit. Use when you want to endorse or rate a bot positively, providing optional feedback on why the bot deserves recognition.
  - body: { botId: string, value?: integer, reason?: string }
- `POST https://api.mcp.ai/api/chatbotkit/upvote/conversation` — Tool to upvote a conversation in ChatBotKit. Use when you want to endorse or rate a conversation positively, providing optional feedback on quality.
  - body: { value?: integer, reason?: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/upvote/conversation/message` — Tool to upvote a conversation message in ChatBotKit. Use when you want to endorse or rate a specific message positively within a conversation.
  - body: { value?: integer, reason?: string, messageId: string, conversationId: string }
- `POST https://api.mcp.ai/api/chatbotkit/verify/secret` — Tool to verify a secret in ChatBotKit. Use when you need to check the authentication status of a secret credential.
  - body: { secretId: string }

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

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