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 its steps, date, list and source
`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, put pages in order, or take them out
`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.