Botpress
for LuumenAI
Read Botpress workspaces, bots, and usage, then make changes as approved steps
Connect Botpress and your agent can answer questions about workspaces, bots, and the integrations and plugins they depend on. It reads account details, quota completion, and per-bot usage on request. Changes — creating a bot, adding an integration, sending a message into a conversation — are previewed and held for approval by default. Authentication is by API key.
The Botpress toolbox
53 tools: 36 read, 17 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadBreak Down Workspace Usage By BotBreak down workspace usage by bot.
- ReadCheck Handle AvailabilityCheck if a workspace handle is available in Botpress.
- ReadGet AccountGet details of the authenticated account.
- ReadGet Account PreferenceGet a preference of the account.
- ReadGet All Workspace Quota CompletionGet a map of workspace IDs to their highest quota completion rate.
- ReadGet Dereferenced Public Plugin By IDGet a public plugin by ID with all interface entity references resolved to the corresponding entities as extended by the backing integrations.
- ReadGet IntegrationGet a specific Botpress integration by name and version.
- ReadGet Public IntegrationRetrieve a public integration by name and version from the Botpress hub.
- ReadGet Public Integration By IDRetrieve detailed information about a public Botpress integration by its ID.
- ReadGet Public InterfaceGet a public interface by name and version from the Botpress Hub.
- ReadGet Public Interface by IDRetrieve a public interface by its ID from the Botpress Hub.
- ReadGet Public PluginRetrieve detailed information about a public plugin from Botpress Hub by name and version.
- ReadGet Public Plugin By IDRetrieve details of a public plugin by its unique ID.
- ReadGet Public Plugin CodeRetrieve public plugin code from Botpress Hub.
- ReadGet Table RowFetch a specific row from a table using the row's unique identifier.
- ReadGet Upcoming InvoiceGet the upcoming invoice for a workspace.
- ReadGet WorkspaceGet detailed information about a specific Botpress workspace by ID.
- ReadGet Workspace QuotaGet workspace quota information for a specific usage type.
- ReadLIST_ACTION_RUNSList action runs for a specific integration of a bot.
- ReadLIST_BOT_ISSUESList issues associated with a specific bot.
- ReadLIST_CONVERSATIONSList all Conversations.
- ReadLIST_FILE_TAGSList all tags used across all bot files.
- ReadLIST_FILE_TAG_VALUESList all values for a given file tag across all files.
- ReadLIST_HUB_INTEGRATIONSList public integrations from the Botpress hub.
- ReadLIST_INTEGRATION_API_KEYSList Integration API Keys (IAKs) for a specific integration.
- ReadList IntegrationsList integrations with filtering and sorting capabilities.
- ReadLIST_KNOWLEDGE_BASESList knowledge bases for a bot.
- ReadList PluginsList Botpress plugins.
- ReadList Public InterfacesRetrieve a list of public interfaces available in the Botpress Hub.
- ReadLIST_PUBLIC_PLUGINSRetrieve a list of public plugins available in the Botpress hub.
- ReadLIST_PUBLIC_WORKSPACESRetrieve a list of public workspaces.
- ReadLIST_USAGE_HISTORYRetrieve usage history for a bot or workspace.
- ReadList Workspace InvoicesList all invoices billed to a workspace.
- ReadLIST_WORKSPACESList all Botpress workspaces accessible to the authenticated user.
- ReadBOTPRESS_RUN_VRLExecute a VRL (Vector Remap Language) script against input data using the Botpress Admin API.
- ReadBOTPRESS_VALIDATE_INTEGRATION_UPDATEValidate an integration update request in Botpress Admin API.
- WriteBOTPRESS_CHARGE_WORKSPACE_UNPAID_INVOICESCharge unpaid invoices for a specific Botpress workspace. Approval by default
- WriteBOTPRESS_CREATE_ADMIN_INTEGRATIONCreate a new integration in a Botpress workspace via the Admin API. Approval by default
- WriteBOTPRESS_CREATE_ADMIN_WORKSPACECreate a new workspace in Botpress via the Admin API. Approval by default
- WriteBOTPRESS_CREATE_BOTCreate a new bot in a Botpress workspace via the Admin API. Approval by default
- WriteBOTPRESS_CREATE_CONVERSATIONCreate a new conversation in Botpress via the Runtime API. Approval by default
- WriteDelete Admin WorkspacePermanently delete a workspace from Botpress admin. Approval by default
- WriteDelete FilePermanently deletes a file from a Botpress bot's storage by its file ID. Approval by default
- WriteDelete Integration Shareable IDDelete a shareable ID for an integration installed in a Botpress bot. Approval by default
- WriteDelete Knowledge BasePermanently deletes a knowledge base from Botpress by its knowledge base ID. Approval by default
- WriteRequest Integration VerificationRequest verification for a Botpress integration via the Admin API. Approval by default
- WriteBOTPRESS_SEND_MESSAGESend a message to an existing Botpress conversation via the Runtime API. Approval by default
- WriteSet Account PreferenceSet a preference for the account. Approval by default
- WriteSet Workspace PreferenceSet a preference for a Botpress workspace. Approval by default
- WriteUpdate AccountUpdate details of the authenticated account. Approval by default
- WriteBOTPRESS_UPDATE_ADMIN_BOTSUpdate an existing bot in a Botpress workspace via the Admin API. Approval by default
- WriteUPDATE_ADMIN_WORKSPACEUpdate a Botpress workspace via the Admin API. Approval by default
- WriteBOTPRESS_UPDATE_WORKFLOWUpdate a workflow object in Botpress by setting parameter values. Approval by default
One prompt, start to finish
What a governed Botpress run looks like inside Luumen.
Questions
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
This connection exposes write actions such as botpress_charge_workspace_unpaid_invoices, botpress_create_admin_integration, botpress_create_admin_workspace, botpress_create_bot, and more. For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user. Review the configured approval policy before enabling write access.
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Every call to Botpress — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
Adobe Marketing Agent MCPAdobe Experience Platform context, sandbox switches, and async task status
AffindaRead parsed documents, collections, and annotations — change them with approval
Agent MailGive the agent its own mailbox for reading threads and sending updates
AI/ML APIInspect assistants, threads, and runs — and change them as approved stepsPut Botpress to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.