entherium_search_chat

Статус: GA Доступ: по токену контракт API: 0.3.0 · capability 2026-09-03.1 Открыть как Markdown Открыть в Claude Открыть в ChatGPT

Search the team’s WORK-CHAT ARCHIVE for messages on a topic — this is how you gather CONTEXT for a task or defect: who asked for it, in what WORDS, when. Use it BEFORE filing a task/defect from a chat request, and to clarify the intent of one already filed. chat: “work” = the team work chat (default). author: substring of a team member’s display name. Returns {“found”: N, “messages”: [{at, author, text, is_full, chat}]} — a message with is_full: false is TRUNCATED by the log and MUST NOT be quoted as verbatim. Requires the global read_all capability: this is internal team traffic, not available to client-scoped tokens.

Доступ: только чтение — безопасно вызывать повторно, ничего не меняет

Доступен на: /mcp/, /mcp/readonly/

Подсказки, объявленные MCP-клиентам (ToolAnnotations)

Подсказка	Значение
`readOnlyHint`	true
`destructiveHint`	false
`idempotentHint`	true
`openWorldHint`	false

Параметры

Имя	Тип	Обязателен	Описание
`query`	`string`	да	Topic or phrase to look for in the archive
`chat`	`string \| null`	нет	Chat alias: work (default) or agents
`author`	`string \| null`	нет	Substring of the author’s display name
`since_days`	`integer \| null`	нет	Only messages from the last N days
`limit`	`integer`	нет	Maximum number of messages to return

Пример вызова

Отправляется внутри инициализированной MCP-сессии (см. Подключение). Каждый параметр показан типизированной заглушкой; необязательные можно опустить — но для инструментов дефектов/задач именно QA-поля спасают отчёт от карантина.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "entherium_search_chat",
    "arguments": {
      "query": "<query>",
      "chat": "<chat>",
      "author": "<author>",
      "since_days": 1,
      "limit": 1
    }
  }
}

Возвращает

Поле	Тип	Описание
`found`	`integer` (необязательно)	Total matches (the page may be shorter)
`messages`	`массив object` (необязательно)	Matching messages, newest first
`messages[].at`	`string`	ISO-8601 timestamp of the message
`messages[].author`	`string \| null`	Author as recorded in the archive
`messages[].text`	`string`	Message text; may be truncated when is_full is false
`messages[].is_full`	`boolean`	False when the archive holds a truncated copy — do not quote it verbatim
`messages[].chat`	`string \| null`	Chat name or id
`error`	`string` (необязательно)	Present only when the search could not run (e.g. missing capability)

Если не работает

Симптом	Причина	Действие
`401`	Токен отсутствует или истёк	Токены выпускает владелец платформы через `POST /api/v1/auth/agent-token` (только суперпользователь) — попросите перевыпуск. ⚠️ Новый токен заменяет набор грантов
`403` / ошибка capability	У токена нет capability или гранта на контракт	Сначала `my_capabilities`; грант запрашивается у владельца