Botpress MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Botpress MCP or direct API to create bots, manage conversations, analyze chat history, and update bot content through natural language.

Botpress logoBotpress
Api Key

Botpress is an open-source platform for building, deploying, and managing chatbots. It helps teams automate conversations and deliver rich, interactive messaging experiences.

53 Tools

Try Botpress now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Botpress
Try asking
TOOLS

Supported Tools

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

Break Down Workspace Usage By Bot

Tool to break down workspace usage by bot.

BOTPRESS_CHARGE_WORKSPACE_UNPAID_INVOICES

Tool to charge unpaid invoices for a specific Botpress workspace.

Check Handle Availability

Tool to check if a workspace handle is available in Botpress.

BOTPRESS_CREATE_ADMIN_INTEGRATION

Tool to create a new integration in a Botpress workspace via the Admin API.

BOTPRESS_CREATE_ADMIN_WORKSPACE

Tool to create a new workspace in Botpress via the Admin API.

BOTPRESS_CREATE_BOT

Tool to create a new bot in a Botpress workspace via the Admin API.

BOTPRESS_CREATE_CONVERSATION

Tool to create a new conversation in Botpress via the Runtime API.

Delete Admin Workspace

Tool to permanently delete a workspace from Botpress admin.

Delete File

Permanently deletes a file from a Botpress bot's storage by its file ID.

Delete Integration Shareable ID

Tool to delete a shareable ID for an integration installed in a Botpress bot.

Delete Knowledge Base

Permanently deletes a knowledge base from Botpress by its knowledge base ID.

Get Account

Tool to get details of the authenticated account.

Get Account Preference

Tool to get a preference of the account.

Get All Workspace Quota Completion

Tool to get a map of workspace IDs to their highest quota completion rate.

Get Dereferenced Public Plugin By ID

Tool to get a public plugin by ID with all interface entity references resolved to the corresponding entities as extended by the backing integrations.

Get Integration

Tool to get a specific Botpress integration by name and version.

Get Public Integration

Tool to retrieve a public integration by name and version from the Botpress hub.

Get Public Integration By ID

Tool to retrieve detailed information about a public Botpress integration by its ID.

Get Public Interface

Tool to get a public interface by name and version from the Botpress Hub.

Get Public Interface by ID

Tool to retrieve a public interface by its ID from the Botpress Hub.

Get Public Plugin

Tool to retrieve detailed information about a public plugin from Botpress Hub by name and version.

Get Public Plugin By ID

Tool to retrieve details of a public plugin by its unique ID.

Get Public Plugin Code

Tool to retrieve public plugin code from Botpress Hub.

Get Table Row

Tool to fetch a specific row from a table using the row's unique identifier.

Get Upcoming Invoice

Tool to get the upcoming invoice for a workspace.

Get Workspace

Tool to get detailed information about a specific Botpress workspace by ID.

Get Workspace Quota

Tool to get workspace quota information for a specific usage type.

LIST_ACTION_RUNS

Tool to list action runs for a specific integration of a bot.

LIST_BOT_ISSUES

Tool to list issues associated with a specific bot.

LIST_CONVERSATIONS

Tool to list all Conversations.

LIST_FILE_TAGS

Tool to list all tags used across all bot files.

LIST_FILE_TAG_VALUES

Tool to list all values for a given file tag across all files.

LIST_HUB_INTEGRATIONS

Tool to list public integrations from the Botpress hub.

LIST_INTEGRATION_API_KEYS

Tool to list Integration API Keys (IAKs) for a specific integration.

List Integrations

Tool to list integrations with filtering and sorting capabilities.

LIST_KNOWLEDGE_BASES

Tool to list knowledge bases for a bot.

List Plugins

Tool to list Botpress plugins.

List Public Interfaces

Tool to retrieve a list of public interfaces available in the Botpress Hub.

LIST_PUBLIC_PLUGINS

Tool to retrieve a list of public plugins available in the Botpress hub.

LIST_PUBLIC_WORKSPACES

Tool to retrieve a list of public workspaces.

LIST_USAGE_HISTORY

Tool to retrieve usage history for a bot or workspace.

List Workspace Invoices

Tool to list all invoices billed to a workspace.

LIST_WORKSPACES

List all Botpress workspaces accessible to the authenticated user.

Request Integration Verification

Tool to request verification for a Botpress integration via the Admin API.

BOTPRESS_RUN_VRL

Tool to execute a VRL (Vector Remap Language) script against input data using the Botpress Admin API.

BOTPRESS_SEND_MESSAGE

Tool to send a message to an existing Botpress conversation via the Runtime API.

Set Account Preference

Tool to set a preference for the account.

Set Workspace Preference

Tool to set a preference for a Botpress workspace.

Update Account

Tool to update details of the authenticated account.

BOTPRESS_UPDATE_ADMIN_BOTS

Tool to update an existing bot in a Botpress workspace via the Admin API.

UPDATE_ADMIN_WORKSPACE

Tool to update a Botpress workspace via the Admin API.

BOTPRESS_UPDATE_WORKFLOW

Tool to update a workflow object in Botpress by setting parameter values.

BOTPRESS_VALIDATE_INTEGRATION_UPDATE

Tool to validate an integration update request in Botpress Admin API.

SETUP GUIDE

Connect Botpress MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK and Claude Agent SDK
2

Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
Initialize the Composio client and create a Tool Router session
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'List all conversations from the last week' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent
SETUP GUIDE

Connect Botpress API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Botpress Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List all conversations from the last week'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Botpress actions with your Agent

Why Use Composio?

AI Native Botpress Integration

  • Supports both Botpress MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Botpress data

Managed Auth

  • Built-in API key management with secure storage
  • Central place to manage, scope, and revoke Botpress access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Botpress
  • Scoped, least privilege access to Botpress resources
  • Full audit trail of agent actions to support review and compliance
FAQ

Frequently asked questions

Yes, Botpress requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Botpress.It takes 30 seconds.

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

Start building