MCP Tools

MCP tools reference

The tools tisty mcp offers an assistant. The assistant picks them on its own; this list is so you know what it can reach. Every tool works on this machine only, and everything is refused until you let the assistant in from Settings › Assistants.

See What an assistant may do for the rules behind them.

Looking around

Tool	What it does
catch_up	Where things stand, and what has moved since it last looked
find	Search the list and the archive
read	Read a whole task
lists	The lists that exist
tags	The tags already in use

Tasks

Tool	What it does
propose	Propose a task with a title, and its steps, date, list and source — or several at once in tasks, each carrying its own fields
remind	Set a task to ring at an hour
reschedule	Move the day of a task it filed
describe	Describe a task that has no description yet
rename	Rename a task an agent filed
note	Add to a task's journal
reword_note	Rewrite a note it wrote in a task's journal
plan	Add steps to a task
reword_step	Rewrite an open step
unplan	Take open steps off a task
tick	Tick the steps it did
untick	Take back a tick it gave by mistake
say_done	Say a task it filed, or was given, is finished — for you to confirm
say_not_doing	Say a task it filed, or was given, should not be done — for you to confirm

Documents

Tool	What it does
docs	The documents and the folders, with what each one is about
outline_doc	What is in a document: its headings and parts
read_doc	Read a document, or one part of it
sum_up	Leave a short summary of what a document is about, for the next reader
write_doc	Write a new document, or write one again whole
append_doc	Add to a document, at the end or under a heading
edit_doc	Change one passage of a document
restore_doc	Put a document back the way it was, from the copy kept beside the documents
folder	Make a folder
file_doc	Put one or several documents in a folder
page_doc	Make documents into pages of another or take them out (doc), or put the pages of one in order (order with page_of)
archive_doc	Put a document or one of its pages away, or bring it back
flag_doc	Say a document has had its day — a mark for you, not a deletion
import_doc	Bring a Markdown file on this machine in as a document
export_doc	Take a document out to a folder on this machine

Files

Tool	What it does
attach	Keep a copy of a file with a task or inside a document

Bringing a Markdown file in copies what its text points at, but only what sits in that file's own folder or below it, so what is taken is bounded by the file you named rather than by what its text asks for. Answers come back without the paths of your disk.