entherium_list_defects

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

READ the defect board (defects + incidents), newest first. Call this BEFORE filing a defect, to check it is not already reported. Filter by status (“open” | “closed”) and/or severity. Returns {“count”: N, “defects”: [{defect_id, title, status, severity, component, spec_ref, reporter, last_seen}]}. Needs the manage_task capability. (A per-defect change log does not exist yet — only tasks carry one.)

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

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

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

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

Параметры

Имя	Тип	Обязателен	Описание
`status`	`string \| null`	нет	open or closed; omit for both
`severity`	`string \| null`	нет	sev1 … sev4
`limit`	`integer`	нет	Maximum number of defects to return

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

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "entherium_list_defects",
    "arguments": {
      "status": "<status>",
      "severity": "<severity>",
      "limit": 1
    }
  }
}

Возвращает

Поле	Тип	Описание
`count`	`integer` (необязательно)	Number of rows returned
`defects`	`массив object` (необязательно)	Defects and incidents, newest first
`defects[].defect_id`	`integer`	Ticket id on the board
`defects[].title`	`string`
`defects[].status`	`string`	Ticket status
`defects[].severity`	`string \| null`	Severity (sev1 … sev4), if set
`defects[].component`	`string \| null`	Component the defect is filed against
`defects[].spec_ref`	`string \| null`	Feature id (opaque SPEC-NNN), if any
`defects[].reporter`	`string \| null`	Reporter identity as recorded
`defects[].last_seen`	`string \| null`	ISO-8601 time the defect was last observed
`error`	`string` (необязательно)	Present only when the board could not be read

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

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