How to integrate Botstar MCP with Codex

Connect Codex to Botstar MCP. Open live chat widget for new visitor, update user profile in current chat session, and more using natural language, with authentication handled for you.

Botstar logoBotstar
Api Key

BotStar is a comprehensive chatbot platform for designing, developing, and training chatbots visually on Messenger and websites. It helps businesses automate conversations and customer interactions without coding.

31 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Botstar MCP integration, Codex can create and publish bots, manage bot attributes, update CMS entities and items, and control the live chat widget, all without leaving the terminal or the app, whichever you prefer.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Botstar with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Botstar MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Botstar task. The first time, Composio asks you to connect your Botstar account.

For example, ask it to:

  • "Open live chat widget for new visitor"
  • "Update user profile in current chat session"
  • "Retrieve chatbot application ID for setup"

What is the Botstar MCP server, and what's possible with it?

The Botstar MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Botstar account. It provides structured and secure access to your chatbot operations, so your agent can perform actions like managing live chat sessions, updating user details, retrieving app parameters, and sending data between webviews and your bot—all on your behalf.

  • Live chat session control: Programmatically open, close, or reinitialize the Botstar live chat widget to manage user interactions in real time.
  • Automated user profile updates: Let your agent update user details and profile attributes during an active chatbot conversation for a more personalized experience.
  • Webview data exchange: Seamlessly send responses from webviews back to the chatbot or retrieve parameters passed from the bot to your webview for dynamic content handling.
  • Custom callback registration: Set up onOpen and onClose event handlers so your agent can trigger actions whenever users interact with the chat window.
  • Application ID and configuration retrieval: Fetch essential Botstar application IDs and parameters for smooth widget initialization and advanced bot customization.

Conclusion

You've successfully integrated Botstar with Codex using Composio's MCP server. Now you can interact with Botstar directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Botstar operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Botstar operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Botstar action and event your agent gets out of the box.

Create Bot

Tool to create a new bot in BotStar.

Create Bot Attribute

Tool to create a new bot attribute in BotStar.

Create CMS Entity

Tool to create a CMS entity in BotStar with a name and optional fields.

Create Entity Fields

Tool to create entity field(s) in BotStar CMS.

Create Entity Item

Tool to create a new entity item in BotStar CMS.

Create User Attributes

Tool to create custom user attributes in BotStar.

Delete Bot Attribute

Tool to delete a bot attribute by ID.

Delete CMS Entity

Tool to delete a CMS entity by ID.

Delete Entity Fields

Tool to delete entity field(s) from a CMS entity.

Delete Entity Item

Tool to delete an entity item from a CMS entity.

Get Bot

Tool to get your bot by bot ID.

Get BotStar Application IDs

Tool to retrieve the BotStar application ID (`appId`).

Get CMS Entity

Tool to get a specific CMS entity by ID.

Get Entity Item

Tool to retrieve a specific item from a CMS entity with all field values.

List Bot Attributes

Tool to get all bot attributes from BotStar.

List Bots

List bots associated with your account, with optional page and limit controls.

List CMS Entities

Tool to retrieve all CMS entities for a bot.

List Entity Items

List a page of CMS entity items, with optional filtering by name and status.

Livechat boot

Generate a JavaScript snippet to reinitialize the live chat widget with provided data after its initial load.

Close BotStar Livechat Widget

Generate a JavaScript snippet to hide the live chat window when the widget is configured in livechat or popup mode.

BotStar LiveChat onClose Callback

Generate a JavaScript snippet to register a callback for when the live chat window closes.

Livechat on open

Generate a JavaScript snippet to register a callback for when the live chat window opens.

Livechat open

Generate a JavaScript snippet to show the live chat window after the widget has been bootstrapped.

Livechat update

Generate a JavaScript snippet to update user details on the current live chat session.

Publish Bot to Live

Tool to publish a bot to live.

Update Bot Attribute

Tool to update a bot attribute in BotStar.

Update CMS Entity

Update the name of an existing BotStar CMS entity.

Update Entity Fields

Tool to update entity field(s) in BotStar CMS.

Update Entity Item

Tool to update a CMS entity item in BotStar.

Get BotStar Webview Parameter

Generate a JavaScript snippet to retrieve a parameter passed from the BotStar chatbot to the webview.

Webview send response

Generate a JavaScript snippet to send a response and custom outputs from a webview back to the BotStar chatbot.

FAQ

Frequently asked questions

Start with Botstar.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Botstar tool your agent needs.Free to start.

Start building