entherium_list_tasks

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

READ the task board — check what work already exists and its STATUS. Call this BEFORE creating a task, to avoid filing a duplicate of something already tracked. Filter by status (“open” | “closed”) and/or assignee NAME (a team member’s display name). Returns {“total”: N, “tasks”: [{task_id, title, status, assignee, spec_ref, description, updated_at, note_count, last_note_at}]}. note_count>0 means the task carries a note/decision in its log that is NOT shown here — call entherium_get_task before drawing any conclusion about that task. Needs the manage_task capability.

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

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

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

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

Параметры

Имя	Тип	Обязателен	Описание
`status`	`string \| null`	нет	open or closed; omit for both
`assignee`	`string \| null`	нет	Team member’s display name
`limit`	`integer`	нет	Maximum number of tasks to return

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

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

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

Возвращает

Поле	Тип	Описание
`total`	`integer` (необязательно)	Total tasks matching the filter
`tasks`	`массив object` (необязательно)	One row per task, with a note signal
`tasks[].task_id`	`integer` (необязательно)	Task id on the board
`tasks[].title`	`string` (необязательно)
`tasks[].status`	`string` (необязательно)	Board status of the task
`tasks[].assignee`	`string \| null` (необязательно)	Assignee display name, if any
`tasks[].spec_ref`	`string \| null` (необязательно)	Feature id the task targets (opaque SPEC-NNN), if any
`tasks[].description`	`string \| null` (необязательно)
`tasks[].updated_at`	`string \| null` (необязательно)	ISO-8601 time of the last change
`tasks[].note_count`	`integer` (необязательно)	Number of notes logged on the task (listing only)
`tasks[].last_note_at`	`string \| null` (необязательно)	ISO-8601 time of the latest note (listing only)
`error`	`string` (необязательно)	Present only when the board could not be read

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

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