---
title: entherium_list_tasks
description: READ the task board — check what work already exists and its STATUS.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/mcp/tools/entherium_list_tasks/
---

> Documentation index: https://enterium-developer-docs.pages.dev/developers/llms.txt — every page of this portal has a Markdown twin at <route>.md; the frozen API contract is at https://enterium-developer-docs.pages.dev/developers/api/openapi.json.

:::note
Сгенерировано из работающего сервера (capability-версия `2026-09-03.1`) — не редактировать руками.

Описание инструмента ниже приводится **на английском** — это дословная строка, которую сервер отдаёт MCP-клиенту; перевод был бы вторым, непроверяемым источником.
:::

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-сессии (см. [Подключение](../../connecting/)). Каждый параметр показан типизированной заглушкой; необязательные можно опустить — но для инструментов дефектов/задач именно QA-поля спасают отчёт от карантина.

```json
{
  "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`; грант запрашивается у владельца |