Botpress MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.3.4更新于 Nov 7, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行知识与记忆沟通与协作数据与分析

概览

AI 生成的概览

托管式 Botpress 只读 MCP 服务:列出机器人,读取日志、分析、会话、消息、数据表和知识库文件。

可以做什么
  • 列出工作区、成员、机器人和账户信息,查看单个机器人的标签与集成状态
  • 读取机器人日志、分组后的运行时错误,以及按周期统计的使用分析(用户、会话、消息、LLM 调用、token 与费用)
  • 浏览会话、消息和终端用户,可按日期、渠道或参与者筛选
  • 查看机器人数据表的结构、行数,并以只读方式按条件、文本搜索和排序查询行
  • 列出知识库文件,并对已索引内容做语义搜索
  • 查看本月工具调用用量并管理订阅方案
适用场景
适合让助手在不打开 Botpress 后台的情况下回答问题:哪些机器人有运行时错误、某个机器人上周用了多少会话或 LLM token、最近聊天中用户说了什么。
运行要求
远程 streamable HTTP 端点,无需本地安装。通过 OAuth 登录,首次连接时需提供 Botpress 个人访问令牌和工作区 ID,服务器按用户保存。客户端配置中不需要 API key 或 Authorization 头。免费方案每月 50 次工具调用。
安装前请注意
令牌由第三方托管方在服务端保存,会话、消息、终端用户和分析数据都会经过该服务。工具本身为只读,但元工具可发起付费 Stripe 订阅(Pro 或 Pro+)并取消订阅;取消当期不退款。用量按次计费,频繁使用会触及调用上限。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Botpress MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fbotpress/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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:
json
{  "mcpServers": {    "botpress": {      "url": "https://botpress.usefulapi.io/mcp"    }  }}

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

ToolTypeWhat it does
botpress_get_accountreadGet account
botpress_list_workspacesreadList workspaces
botpress_list_workspace_membersreadList workspace members
botpress_list_botsreadList bots
botpress_get_botreadGet bot
botpress_get_bot_logsreadGet bot logs
botpress_get_bot_analyticsreadGet bot analytics
botpress_list_bot_issuesreadList bot issues
botpress_list_conversationsreadList conversations
botpress_get_conversationreadGet conversation
botpress_list_messagesreadList messages
botpress_list_usersreadList users
botpress_get_userreadGet user
botpress_list_tablesreadList tables
botpress_get_tablereadGet table
botpress_find_table_rowsreadFind table rows
botpress_list_filesreadList files
botpress_get_filereadGet file
botpress_search_filesreadSearch files
botpress_usage_statusmetaUsage status (free-tier meter)
botpress_request_featuremetaRequest a missing feature
botpress_upgrademetaUpgrade to Pro or Pro+
botpress_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*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.

来源:servers/botpress/README.md,提交 4046075

工具

19

botpress_get_account

Get account

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

无需输入参数。

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.

输入参数handlenextToken

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.

输入参数nextToken

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.

输入参数devnextTokensortFieldsortDirection

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}.

输入参数bot_id必填

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.

输入参数levelbot_id必填userIdtimeEndnextTokentimeStart必填workflowIdconversationIdmessageContains

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.

输入参数bot_id必填endDate必填startDate必填

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.

输入参数bot_id必填nextToken

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.

输入参数bot_id必填channelafterDatenextTokensortFieldbeforeDateparticipantIdsortDirectionintegrationName

botpress_get_conversation

Get conversation

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

输入参数bot_id必填conversation_id必填

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.

输入参数bot_id必填afterDatenextTokenbeforeDateconversationId

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.

输入参数bot_id必填afterDatenextTokensortFieldbeforeDaterangeFieldsortDirectionconversationId

botpress_get_user

Get user

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

输入参数bot_id必填user_id必填

botpress_list_tables

List tables

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

输入参数bot_id必填

botpress_get_table

Get table

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

输入参数table必填bot_id必填

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.

输入参数limittable必填bot_id必填filteroffsetsearchselectorderByorderDirection

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.

输入参数bot_id必填indexednextTokensortFieldsortDirection

botpress_get_file

Get file

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

输入参数file必填bot_id必填

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.

输入参数limitquery必填bot_id必填consolidatecontextDepth

版本历史

6
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成