# Botstar — MCP server on mcp.ai
> Connect your Botstar account and use 31 tools for AI chatbots straight from your AI agent. Connect with your own API key. BotStar is a comprehensive chatbot platform that enables businesses to design, develop, and train chatbots visually for Messenger and websites.

By: mcp.ai · official
Page: https://mcp.ai/botstar

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_botstar?ms=1787291520000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/botstar/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/botstar/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/botstar/skill.md
Postman collection (v2.1): https://mcp.ai/botstar/postman.json

## Tools
- botstar_create_bot(name: string) — Tool to create a new bot in BotStar. Use when you need to create a new bot instance with a specific name.
- botstar_create_bot_attribute(env?: string, desc?: string, name: string, value?: string, bot_id: string, data_type: string, additional_values?: object) — Tool to create a new bot attribute in BotStar. Bot attributes are global variables for a bot and support multilingual values. Use when you need to define custom data fields for your bot.
- botstar_create_cms_entity(env?: string, name: string, bot_id: string, fields?: object[]) — Tool to create a CMS entity in BotStar with a name and optional fields. Use when you need to define a new content structure with custom fields supporting various data types.
- botstar_create_entity_fields(env?: string, botId: string, fields: object[], entityId: string) — Tool to create entity field(s) in BotStar CMS. Supports multiple field types including text, multiple_values, single_option, multiple_options, image, date, and entity. Use when you need to add new fie
- botstar_create_entity_item(env?: string, name: string, bot_id: string, status?: string, entity_id: string, additional_fields?: object) — Tool to create a new entity item in BotStar CMS. Use when adding items to a CMS entity with custom field values.
- botstar_create_user_attributes(bot_id: string, field_name: string, field_type: string) — Tool to create custom user attributes in BotStar. Use when you need to define new custom attributes for users with specified field name and type.
- botstar_delete_bot_attribute(env?: string, bot_id: string, attribute_id: string) — Tool to delete a bot attribute by ID. Use when you need to remove a custom attribute from a bot.
- botstar_delete_cms_entity(env?: string, bot_id: string, entity_id: string) — Tool to delete a CMS entity by ID. Use when you need to remove an entity from the bot's content management system.
- botstar_delete_entity_fields(env?: string, bot_id: string, entity_id: string, unique_names?: string) — Tool to delete entity field(s) from a CMS entity. Use when you need to remove fields from a CMS entity by their unique names.
- botstar_delete_entity_item(env?: string, bot_id: string, entity_id: string, entity_item_id: string) — Tool to delete an entity item from a CMS entity. Use when you need to remove a specific item from a bot's CMS entity.
- botstar_get_bot(bot_id: string) — Tool to get your bot by bot ID. Use when you need detailed bot information including ID, name, and team name.
- botstar_get_bot_app_id(bot_id?: integer, bot_name?: string) — Tool to retrieve the BotStar application ID (`appId`). Use when initializing or reinitializing the live chat widget.
- botstar_get_cms_entity(env?: string, bot_id: string, entity_id: string) — Tool to get a specific CMS entity by ID. Returns entity details including fields configuration. Use when you need to retrieve metadata about a CMS entity structure.
- botstar_get_entity_item(env?: string, bot_id: string, entity_id: string, entity_item_id: string) — Tool to retrieve a specific item from a CMS entity with all field values. Use when you need to get detailed information about a single entity item.
- botstar_list_bot_attributes(env?: string, bot_id: string) — Tool to get all bot attributes from BotStar. Returns array of bot attributes with id, name, desc, value, and data_type. Use when you need to retrieve or inspect all attributes configured for a bot.
- botstar_list_bots(page?: integer, limit?: integer) — Tool to get your list of bots. Use when you need to retrieve all bots associated with your account. Returns an array of bots with their id, name, and team_name.
- botstar_list_cms_entities(env?: string, botId: string) — Tool to retrieve all CMS entities for a bot. Use when you need to access entity definitions, field configurations, or available entity schemas.
- botstar_list_entity_items(env?: string, name?: string, page?: integer, limit?: integer, bot_id: string, status?: string, entity_id: string) — Tool to retrieve all entity items with pagination support. Use when you need to list CMS entity items, with optional filtering by name and status.
- botstar_livechat_boot(mode?: string, user?: object, appId: string, block?: string, variables?: object) — Tool to reinitialize the live chat widget with provided data. Use after initial load to reset or update widget configuration.
- botstar_livechat_close() — Tool to hide the live chat window. Use when the chat widget is configured in livechat or popup mode.
- botstar_livechat_on_close(callback_code: string) — Tool to register a callback when the chat window is closed. Use after the widget is initialized. Example prompt: "Register an onClose handler that logs 'Goodbye!' to the console."
- botstar_livechat_on_open(callback: string) — Tool to register a callback when the chat window is opened. Use after widget initialization.
- botstar_livechat_open() — Tool to show the live chat window. Use after the widget has been bootstrapped with BotStarApi('boot') to programmatically open the chat window (mode must be 'livechat' or 'popup').
- botstar_livechat_update(tags?: string[], email?: string, avatar?: string, gender?: string, user_id?: string, birthday?: string, last_name?: string, first_name?: string) — Tool to update user details on the current live chat session. Use when you need to modify user profile attributes during an active conversation.
- botstar_publish_bot(bot_id: string) — Tool to publish a bot to live. Use when you need to deploy changes to the production environment.
- botstar_update_bot_attribute(env?: string, desc?: string, value?: string|integer|number, bot_id: string, attribute_id: string) — Tool to update a bot attribute in BotStar. Use when you need to modify the description or value of a bot attribute with optional multilingual support.
- botstar_update_cms_entity(env?: string, name: string, bot_id: string, entity_id: string) — Tool to update a CMS entity in BotStar. Use when you need to modify the name or configuration of an existing CMS entity.
- botstar_update_entity_fields(env?: string, bot_id: string, fields: object[], entity_id: string) — Tool to update entity field(s) in BotStar CMS. Use when you need to modify the name or options of existing fields.
- botstar_update_entity_item(env?: string, name?: string, bot_id: string, status?: string, entity_id: string, custom_fields?: object, entity_item_id: string) — Tool to update a CMS entity item in BotStar. Use when you need to modify the name, status, or custom field values of an entity item.
- botstar_webview_get_parameter(parameter_name: string) — Tool to retrieve a parameter value passed from the BotStar chatbot to the webview. Use inside onChatBotReady after your page loads in modal mode with bs:input meta tags.
- botstar_webview_send_response(outputs: object, response: string, outlet_name: string) — Tool to send data from the webview back to the BotStar chatbot. Use when you need to transmit responses or custom outputs from an open webview.

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

## Links
Docs: https://mcp.ai/docs/mcps/botstar
Website: https://mcp.ai/mcps/botstar