Przegląd narzędzi

Serwer MCP pod adresem https://mcp.todomino.eu/mcp udostępnia 17 narzędzi. Narzędzia tylko do odczytu mają adnotację readOnlyHint; narzędzia destrukcyjne mają adnotację destructiveHint, więc dobrze zachowujący się klienci proszą o potwierdzenie przed ich uruchomieniem. Identyfikatory przepływają między narzędziami: zacznij od list_workspaces, użyj jego id z list_tasks i tak dalej.

Odkrywanie (tylko do odczytu)

list_workspaces

Bez parametrów. Zwraca twoje obszary robocze z id, wyświetlaną nazwą name, flagą personal i twoją rolą role. Zacznij tutaj — każde inne narzędzie potrzebuje workspaceId z tej listy.

list_tasks

Parametr	Typ	Uwagi
workspaceId	string	wymagany
status	PENDING | IN_PROGRESS | DONE	filtr opcjonalny
listId	string	filtr opcjonalny
assigneeId	string	filtr opcjonalny (userId członka)

Zwraca zadania w zwięzłej postaci: id, tytuł, status, powód zablokowania (gdy oznaczone), priorytet, termin, listę, osobę przypisaną, postęp podzadań ("2/5 done") i liczbę załączników.

get_task

workspaceId, taskId. Pełne szczegóły jednego zadania: opis, twórca, wszystkie podzadania z id oraz załączniki z id, nazwami plików, typami mediów i rozmiarami.

list_lists

workspaceId. Zwraca listy zadań z id i nazwami.

list_members

workspaceId. Zwraca członków z userId, imieniem i nazwiskiem oraz rolą — potrzebne do przypisywania zadań.

get_attachment

workspaceId, taskId, attachmentId. Pobiera załącznik i zwraca jego zawartość: obrazy jako obrazy, pliki tekstopodobne (tekst, JSON, XML, CSV, …) jako tekst (obcięty do 100 tys. znaków), inne pliki binarne jako zasób base64. Odmawia dla plików większych niż 8 MB.

Tworzenie i aktualizowanie

create_task

Parametr	Typ	Uwagi
workspaceId	string	wymagany
title	string	wymagany
description	string	opcjonalny
priority	LOW | NORMAL | HIGH | CRITICAL	opcjonalny
dueDate	YYYY-MM-DD	opcjonalny
listId	string	opcjonalny

update_task

Te same pola co create_task plus taskId i assigneeId; zmieniają się tylko przekazane pola, null czyści priorytet, termin, listę lub osobę przypisaną. Ma adnotację destrukcyjną (nadpisuje istniejące wartości).

set_task_status / set_subtask_status

workspaceId, taskId (+ subtaskId), done (boolean). Odwracalne i idempotentne.

add_subtask

workspaceId, taskId, title.

create_list

workspaceId, name. Kolor jest dobierany automatycznie.

add_attachment

Parametr	Typ	Uwagi
workspaceId, taskId	string	wymagane
fileName	string	z rozszerzeniem
mediaType	string	opcjonalny typ MIME
text	string	zawartość jako zwykły tekst…
base64	string	…albo zawartość binarna — dokładnie jedno z dwóch

Zawartość jest deduplikowana w obrębie obszaru roboczego (deduplicated: true w wyniku); dołączenie tego samego pliku do tego samego zadania dwa razy jest odrzucane. Limit 8 MB; wlicza się do limitu przestrzeni obszaru roboczego.

Usuwanie (destrukcyjne — klienci najpierw proszą o potwierdzenie)

delete_task

workspaceId, taskId. Usuwa zadanie razem z podzadaniami i odwołaniami do załączników. Nie można tego cofnąć.

delete_subtask

workspaceId, taskId, subtaskId.

delete_attachment

workspaceId, taskId, attachmentId. Zapisany plik jest usuwany dopiero wtedy, gdy żadne inne zadanie nie odwołuje się do tej samej zawartości.

delete_list

workspaceId, listId. Zadania z listy nie są usuwane — istnieją dalej bez listy.

Niedostępne dla asystentów

Usuwanie całych obszarów roboczych i zarządzanie członkami celowo nie są udostępnione — pozostają działaniami wykonywanymi przez ludzi w aplikacji Todomino.