Riferimento degli strumenti

Il server MCP su https://mcp.todomino.eu/mcp espone 17 strumenti. Gli strumenti di sola lettura sono annotati con readOnlyHint; gli strumenti distruttivi sono annotati con destructiveHint, così i client ben educati chiedono conferma prima di eseguirli. Gli ID fluiscono tra gli strumenti: inizia con list_workspaces, usa i suoi id con list_tasks, e così via.

Esplorazione (sola lettura)

list_workspaces

Nessun parametro. Restituisce i tuoi spazi di lavoro con id, name da visualizzare, flag personal e il tuo role. Inizia da qui — ogni altro strumento ha bisogno di un workspaceId proveniente da questa lista.

list_tasks

Parametro	Tipo	Note
workspaceId	string	obbligatorio
status	PENDING | IN_PROGRESS | DONE	filtro opzionale
listId	string	filtro opzionale
assigneeId	string	filtro opzionale (userId del membro)

Restituisce attività in forma compatta: id, titolo, stato, motivo del blocco (quando contrassegnata), priorità, data di scadenza, lista, assegnatario, avanzamento delle sottoattività ("2/5 done") e numero di allegati.

get_task

workspaceId, taskId. Dettaglio completo di una singola attività: descrizione, creatore, tutte le sottoattività con gli id e gli allegati con id, nomi dei file, tipi di media e dimensioni.

list_lists

workspaceId. Restituisce le liste di attività con id e nomi.

list_members

workspaceId. Restituisce i membri con userId, nome e ruolo — necessario per assegnare le attività.

get_attachment

workspaceId, taskId, attachmentId. Scarica un allegato e ne restituisce il contenuto: le immagini come immagini, i file di tipo testuale (testo, JSON, XML, CSV, …) come testo (troncato a 100k caratteri), gli altri binari come risorsa base64. Rifiuta i file oltre gli 8 MB.

Creazione e aggiornamento

create_task

Parametro	Tipo	Note
workspaceId	string	obbligatorio
title	string	obbligatorio
description	string	opzionale
priority	LOW | NORMAL | HIGH | CRITICAL	opzionale
dueDate	YYYY-MM-DD	opzionale
listId	string	opzionale

update_task

Gli stessi campi di create_task più taskId e assigneeId; cambiano solo i campi forniti, null rimuove priorità, data di scadenza, lista o assegnatario. Annotato come distruttivo (sovrascrive i valori esistenti).

set_task_status / set_subtask_status

workspaceId, taskId (+ subtaskId), done (boolean). Reversibile e idempotente.

add_subtask

workspaceId, taskId, title.

create_list

workspaceId, name. Un colore viene scelto automaticamente.

add_attachment

Parametro	Tipo	Note
workspaceId, taskId	string	obbligatori
fileName	string	estensione inclusa
mediaType	string	tipo MIME opzionale
text	string	contenuto in testo semplice…
base64	string	…oppure contenuto binario — esattamente uno dei due

Il contenuto è deduplicato per spazio di lavoro (deduplicated: true nel risultato); allegare lo stesso file alla stessa attività due volte viene rifiutato. Limite di 8 MB; conta ai fini della quota di archiviazione dello spazio di lavoro.

Eliminazione (distruttiva — i client chiedono prima conferma)

delete_task

workspaceId, taskId. Elimina l’attività con le sottoattività e i riferimenti agli allegati. Non può essere annullato.

delete_subtask

workspaceId, taskId, subtaskId.

delete_attachment

workspaceId, taskId, attachmentId. Il file archiviato viene eliminato solo quando nessun’altra attività fa riferimento allo stesso contenuto.

delete_list

workspaceId, listId. Le attività nella lista non vengono eliminate — continuano a esistere senza una lista.

Non disponibile per gli assistenti

L’eliminazione di interi spazi di lavoro e la gestione dei membri non sono esposte di proposito — restano azioni umane nell’app Todomino.