MCP MeasureMCP Measure

インデックス観測済み

Botpress MCP by usefulapi

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

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
94%
命名の品質
79%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項（1）

  • LOWTool 'botpress_list_workspace_members' name length outside 3-30 rangebotpress_list_workspace_members 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~3,097トークン数（ツール定義）
~1.3 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.42%）

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "botpress": {
      "url": "https://botpress.usefulapi.io/mcp"
    }
  }
}

リモートエンドポイント

https://botpress.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール（19）

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢botpress_get_account

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

入力スキーマ

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_workspaces(handle, nextToken)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "handle": {
      "description": "Filter by workspace handle.",
      "type": "string"
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_workspace_members(nextToken)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_bots(dev, sortField, sortDirection, nextToken)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "dev": {
      "description": "If true, list only dev bots. Default: production bots.",
      "type": "boolean"
    },
    "sortField": {
      "type": "string",
      "enum": [
        "createdAt",
        "updatedAt"
      ]
    },
    "sortDirection": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_bot(bot_id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_bot_logs(bot_id, timeStart, timeEnd, level, userId, ...)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "timeStart": {
      "type": "string",
      "description": "Start of the time range, ISO 8601 (for example 2026-11-01T00:00:00Z)."
    },
    "timeEnd": {
      "description": "End of the time range, ISO 8601.",
      "type": "string"
    },
    "level": {
      "description": "Filter by log level.",
      "type": "string"
    },
    "userId": {
      "type": "string"
    },
    "conversationId": {
      "type": "string"
    },
    "workflowId": {
      "type": "string"
    },
    "messageContains": {
      "description": "Keep logs whose message contains this text.",
      "type": "string"
    },
    "nextToken": {
      "description": "Pagination cursor: the top-level nextToken value from the previous response.",
      "type": "string"
    }
  },
  "required": [
    "bot_id",
    "timeStart"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_bot_analytics(bot_id, startDate, endDate)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "startDate": {
      "type": "string",
      "description": "Start date/time, inclusive, ISO 8601."
    },
    "endDate": {
      "type": "string",
      "description": "End date/time, inclusive, ISO 8601."
    }
  },
  "required": [
    "bot_id",
    "startDate",
    "endDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_bot_issues(bot_id, nextToken)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_conversations(bot_id, channel, participantId, integrationName, afterDate, ...)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "channel": {
      "description": "Filter by integration channel name.",
      "type": "string"
    },
    "participantId": {
      "description": "Only conversations with this participant (user id).",
      "type": "string"
    },
    "integrationName": {
      "description": "Filter by integration name.",
      "type": "string"
    },
    "afterDate": {
      "description": "Created on or after this ISO 8601 UTC date.",
      "type": "string"
    },
    "beforeDate": {
      "description": "Created on or before this ISO 8601 UTC date.",
      "type": "string"
    },
    "sortField": {
      "type": "string",
      "enum": [
        "createdAt",
        "updatedAt"
      ]
    },
    "sortDirection": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_conversation(bot_id, conversation_id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "conversation_id": {
      "type": "string",
      "description": "Conversation id."
    }
  },
  "required": [
    "bot_id",
    "conversation_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_messages(bot_id, conversationId, afterDate, beforeDate, nextToken)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "conversationId": {
      "description": "Only messages of this conversation.",
      "type": "string"
    },
    "afterDate": {
      "description": "Created on or after this ISO 8601 UTC date.",
      "type": "string"
    },
    "beforeDate": {
      "description": "Created on or before this ISO 8601 UTC date.",
      "type": "string"
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_users(bot_id, conversationId, afterDate, beforeDate, rangeField, ...)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "conversationId": {
      "description": "Only users of this conversation.",
      "type": "string"
    },
    "afterDate": {
      "description": "ISO 8601 UTC date, inclusive.",
      "type": "string"
    },
    "beforeDate": {
      "description": "ISO 8601 UTC date, inclusive.",
      "type": "string"
    },
    "rangeField": {
      "description": "Field the date range applies to (default createdAt).",
      "type": "string",
      "enum": [
        "createdAt",
        "updatedAt"
      ]
    },
    "sortField": {
      "type": "string",
      "enum": [
        "createdAt",
        "updatedAt"
      ]
    },
    "sortDirection": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_user(bot_id, user_id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "user_id": {
      "type": "string",
      "description": "User id."
    }
  },
  "required": [
    "bot_id",
    "user_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_tables(bot_id)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_table(bot_id, table)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "table": {
      "type": "string",
      "description": "Table name or id."
    }
  },
  "required": [
    "bot_id",
    "table"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_find_table_rows(bot_id, table, filter, search, select, ...)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "table": {
      "type": "string",
      "description": "Table name or id."
    },
    "filter": {
      "description": "MongoDB-like filter, for example {\"name\":{\"$eq\":\"John\"}}.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "search": {
      "description": "Text search term.",
      "type": "string",
      "maxLength": 1024
    },
    "select": {
      "description": "Columns to return (dot notation for nested).",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "orderBy": {
      "description": "Column to sort by (default id).",
      "type": "string"
    },
    "orderDirection": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "limit": {
      "description": "Rows per page (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Rows to skip.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "bot_id",
    "table"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_list_files(bot_id, indexed, sortField, sortDirection, nextToken)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "indexed": {
      "description": "Filter by indexing state.",
      "type": "boolean"
    },
    "sortField": {
      "type": "string",
      "enum": [
        "key",
        "size",
        "createdAt",
        "updatedAt",
        "status"
      ]
    },
    "sortDirection": {
      "description": "Sort direction.",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "nextToken": {
      "description": "Pagination cursor: the meta.nextToken value from the previous response.",
      "type": "string"
    }
  },
  "required": [
    "bot_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_get_file(bot_id, file)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "file": {
      "type": "string",
      "description": "File id or key."
    }
  },
  "required": [
    "bot_id",
    "file"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢botpress_search_files(bot_id, query, limit, contextDepth, consolidate)

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

入力スキーマ

{
  "type": "object",
  "properties": {
    "bot_id": {
      "type": "string",
      "description": "Bot id (from botpress_list_bots)."
    },
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Question or phrase in natural language."
    },
    "limit": {
      "description": "Maximum passages to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "contextDepth": {
      "description": "Neighbor passages to add as context (default 1).",
      "type": "integer",
      "minimum": 0,
      "maximum": 10
    },
    "consolidate": {
      "description": "Merge passages of the same file into one.",
      "type": "boolean"
    }
  },
  "required": [
    "bot_id",
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 19 件