É a principal ferramenta de consulta de tarefas para agentes que precisam de decidir no que trabalhar. Filtra as tarefas acessíveis ao utilizador autenticado por projeto, coluna do quadro, etiqueta, responsável, estado, intervalos de datas de criação e de vencimento e prioridade, com ordenação configurável. Utilize created_after para revelar trabalho criado recentemente. Devolve uma lista compacta, pronta para apoiar decisões. Todas as consultas ficam limitadas aos projetos que o utilizador possui ou aos quais pertence.
Segurança: Só de leitura
Os nomes das ferramentas e dos campos, bem como as descrições do esquema, permanecem no inglês canónico do MCP para que as chamadas copiadas correspondam exatamente ao servidor.
Esquema de entrada
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
project_name |
string | não | Narrow to one project by partial, case-insensitive name match. Omit to search all accessible projects. |
project_id |
integer | não | Narrow to one project by exact ID. Takes precedence over project_name. |
board_id |
integer | não | Exact board ID, within the selected accessible project(s). |
column_id |
integer | não | Exact column ID, within the selected accessible project(s) and board. Combined with column_name when both are supplied. |
column_name |
string | não | Match tasks whose board column name contains this (case-insensitive). E.g. "Bugs", "Backlog", "Done". |
tag |
string | não | Match tasks having a tag whose name contains this (case-insensitive). E.g. "bug". |
assignee_email |
string | não | Match tasks assigned to this user email. |
status |
string | não | Filter by completion: "open" (default), "completed", or "any". |
created_after |
string | não | Only tasks created on or after this date (YYYY-MM-DD). The "newly created" lever. |
created_before |
string | não | Only tasks created on or before this date (YYYY-MM-DD). |
due_after |
string | não | Only tasks with planned_end_date on or after this date (YYYY-MM-DD). |
due_before |
string | não | Only tasks with planned_end_date on or before this date (YYYY-MM-DD). |
priority_name |
string | não | Match tasks whose priority name contains this (case-insensitive). E.g. "High". |
sort |
string | não | Ordering: "newest" (default), "oldest", "due_soonest", or "recently_updated". |
limit |
integer | não | Legacy maximum tasks to return. Default 25, max 100. Omit with page_size/cursor. |
page_size |
integer | não | Enable complete cursor traversal in ascending task ID order, 1–100 per page. Omit sort and limit. With cursor only, defaults to 50. |
cursor |
string | não | Opaque pagination.next_cursor. Repeat the same filters and page_size. Omit on the first page. |
Prompt de exemplo
Utilize filter-tasks-tool para me ajudar com a tarefa relevante do Taskavel.
Exemplo de chamada
{
"name": "filter-tasks-tool",
"arguments": {}
}