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 整合