Botpress MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Read bots, logs, analytics, conversations, messages, tables and files in Botpress.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableKnowledge & Memory Communication & Collaboration Data & Analytics

Server details

Identifier: io.usefulapi/botpress
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 3, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Fbotpress.svg)](https://sourceweft.com/mcp/io.usefulapi%2Fbotpress?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted read-only MCP access to Botpress: list bots, read logs, analytics, conversations, messages, tables and knowledge-base files.

What you can do: List workspaces, members, bots and account details, and inspect one bot's tags and integrations
Read bot logs, grouped runtime issues and per-period usage analytics (users, sessions, messages, LLM tokens and cost)
Browse conversations, messages and end users, filtered by date, channel or participant
Inspect bot Tables: schemas, row counts and read-only row queries with filters, text search and sorting
List knowledge-base files and run semantic search over their indexed passages
Check monthly tool-call usage and manage the subscription plan
When to use it: Useful when you want an assistant to answer questions about a Botpress deployment without opening the dashboard: which bots have runtime errors, how many conversations or LLM tokens a bot used last week, or what users actually said in recent chats.
Requirements: Remote streamable HTTP endpoint; no local install. Sign-in is via OAuth, and on first connect you supply a Botpress Personal Access Token and your workspace id, which the server stores per user. No API key or Authorization header goes in the client config. Free plan allows 50 tool calls per month.

Before you install

The token is stored server-side by the third-party host, and conversation, message, end-user and analytics data pass through it. Tools are read-only, but meta tools can start a paid Stripe subscription (Pro or Pro+) and cancel it; cancellation gives no refund for the current period. Usage is metered, so heavy use hits the call limit.

Installation

In SourceWeft

Open Botpress MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fbotpress/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "botpress-by-usefulapi": {
      "type": "http",
      "url": "https://botpress.usefulapi.io/mcp"
    }
  }
}

README

Botpress MCP by usefulapi

Use your Botpress account from Claude, Cursor, or any MCP client. Read workspaces, bots, logs, analytics, conversations, messages, tables and files. Hosted, no local install: connect with your own credentials.

Live endpoint: https://botpress.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://botpress.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http botpress https://botpress.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Botpress credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/botpress/

On first connect you provide a Personal Access Token (Botpress → Profile settings → Personal Access Tokens) and your workspace id. The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`botpress_get_account`	read	Get account
`botpress_list_workspaces`	read	List workspaces
`botpress_list_workspace_members`	read	List workspace members
`botpress_list_bots`	read	List bots
`botpress_get_bot`	read	Get bot
`botpress_get_bot_logs`	read	Get bot logs
`botpress_get_bot_analytics`	read	Get bot analytics
`botpress_list_bot_issues`	read	List bot issues
`botpress_list_conversations`	read	List conversations
`botpress_get_conversation`	read	Get conversation
`botpress_list_messages`	read	List messages
`botpress_list_users`	read	List users
`botpress_get_user`	read	Get user
`botpress_list_tables`	read	List tables
`botpress_get_table`	read	Get table
`botpress_find_table_rows`	read	Find table rows
`botpress_list_files`	read	List files
`botpress_get_file`	read	Get file
`botpress_search_files`	read	Search files
`botpress_usage_status`	meta	Usage status (free-tier meter)
`botpress_request_feature`	meta	Request a missing feature
`botpress_upgrade`	meta	Upgrade to Pro or Pro+
`botpress_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with botpress_upgrade (it returns a Stripe Checkout link). Cancel any time with botpress_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running botpress_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/botpress/README.md at commit 4046075

Tools

botpress_get_account

Get account

Show the Botpress account that owns the token (id, email, display name). Admin API: GET /v1/admin/account/me.

Takes no parameters.

botpress_list_workspaces

List workspaces

List the workspaces the token's user can access, with plan, bot count and spending limit. Admin API: GET /v1/admin/workspaces.

ParametershandlenextToken

botpress_list_workspace_members

List workspace members

List the members of the connected workspace with their role and email. Admin API: GET /v1/admin/workspace-members.

ParametersnextToken

botpress_list_bots

List bots

List the bots of the connected workspace (id, name, type, deploy time). Good first call: the other tools need a bot id. Admin API: GET /v1/admin/bots.

ParametersdevnextTokensortFieldsortDirection

botpress_get_bot

Get bot

Get one bot: name, type, deploy time, tags and the enabled state of its integrations. The signing secret and integration configuration are left out on purpose. Admin API: GET /v1/admin/bots/{id}.

Parametersbot_idrequired

botpress_get_bot_logs

Get bot logs

Read the logs of a bot in a time range, with filters for level, user, conversation and message text. Admin API: GET /v1/admin/bots/{id}/logs.

Parameterslevelbot_idrequireduserIdtimeEndnextTokentimeStartrequiredworkflowIdconversationIdmessageContains

botpress_get_bot_analytics

Get bot analytics

Get usage analytics of a bot per period: users, sessions, messages, events and LLM calls, tokens and cost. Admin API: GET /v1/admin/bots/{id}/analytics.

Parametersbot_idrequiredendDaterequiredstartDaterequired

botpress_list_bot_issues

List bot issues

List the grouped runtime issues (errors) of a bot with counts and last-seen time. Admin API: GET /v1/admin/bots/{id}/issues.

Parametersbot_idrequirednextToken

botpress_list_conversations

List conversations

List the conversations of a bot, with channel, integration and message count. Filter by date, channel or participant. Runtime API: GET /v1/chat/conversations.

Parametersbot_idrequiredchannelafterDatenextTokensortFieldbeforeDateparticipantIdsortDirectionintegrationName

botpress_get_conversation

Get conversation

Get one conversation of a bot by id. Runtime API: GET /v1/chat/conversations/{id}.

Parametersbot_idrequiredconversation_idrequired

botpress_list_messages

List messages

List the messages of a bot, for one conversation or for a date range. Runtime API: GET /v1/chat/messages.

Parametersbot_idrequiredafterDatenextTokenbeforeDateconversationId

botpress_list_users

List users

List the end users who talked to a bot. Filter by conversation or date. Runtime API: GET /v1/chat/users.

Parametersbot_idrequiredafterDatenextTokensortFieldbeforeDaterangeFieldsortDirectionconversationId

botpress_get_user

Get user

Get one end user of a bot by id. Runtime API: GET /v1/chat/users/{id}.

Parametersbot_idrequireduser_idrequired

botpress_list_tables

List tables

List the Tables of a bot with their schema. Tables API: GET /v1/tables.

Parametersbot_idrequired

botpress_get_table

Get table

Get one Table with its schema, row count and indexing state. Tables API: GET /v1/tables/{table}.

Parameterstablerequiredbot_idrequired

botpress_find_table_rows

Find table rows

Read rows of a Table with an optional MongoDB-like filter, text search, column selection and sorting. Read only. Tables API: POST /v1/tables/{table}/rows/find.

Parameterslimittablerequiredbot_idrequiredfilteroffsetsearchselectorderByorderDirection

botpress_list_files

List files

List the files in the knowledge base of a bot (key, size, type, indexing status). Files API: GET /v1/files.

Parametersbot_idrequiredindexednextTokensortFieldsortDirection

botpress_get_file

Get file

Get the metadata of one file of a bot, by id or key. Files API: GET /v1/files/{id}.

Parametersfilerequiredbot_idrequired

botpress_search_files

Search files

Semantic search over the indexed files of a bot. Returns the best matching text passages. Files API: GET /v1/files/search.

Parameterslimitqueryrequiredbot_idrequiredconsolidatecontextDepth

Version history

v1.3.4LatestNov 7, 2026
v1.2.3Nov 5, 2026
v1.2.2Nov 5, 2026
v1.2.1Nov 4, 2026
v1.2.0Nov 3, 2026
v1.1.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Business & Commerce5 toolsNov 7, 2026

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro (per user)	$9/mo or $90/yr (2 months free)	Unlimited*