Skip to content

FIRST RESULT

Agent tools

Everything your agent can do in TouchDesigner goes through these 29 tools. You don't call them yourself: you ask in plain words, and the agent picks the tool. The names help when you read the agent's log or set up your client to ask you before some calls.

In the plugin MCP

Before its first step in TouchDesigner, the agent reads a short manual with td_get_hints. That is why a new session starts with a read and not with a change: the manual holds the TouchDesigner rules the agent would otherwise guess.

Find

td_list_instances Lists every TouchDesigner open on this machine, so the agent works in the right one.
td_get_focus The network you are looking at and the operators you selected: what *here and *this point to.
td_find_op Finds operators by name or type.
td_search Searches parameter values, expressions and code across the project.
td_get_network Shows the operators of a network and how they are wired.
td_parse_project Studies the whole project once and saves a map of it.
td_graph_query Answers questions from that map: who references an operator, who calls a function, how two operators connect.

Look inside

td_get_operators_info Parameters, inputs, outputs and state of operators. For a TOP, it can also tell whether the picture is black, transparent or flat.
td_read_dat Reads the text or the table of a DAT.
td_read_chop Reads the channels of a CHOP.
td_read_pop Reads POP data, with a size limit.
td_get_errors Lists errors and warnings, also in operators that did not cook yet.
td_get_perf The frame rate and the slowest operators.
td_read_textport Reads the Textport.
td_get_screenshot A picture of an operator viewer or a network.
td_get_screen_screenshot A picture of the TouchDesigner window.
td_audit_panel Examines a panel for layout bugs, for example text that does not fit or a part wider than its container.

Change

td_create_operator Creates an operator in the right place, with its parameters.
td_execute_python Runs a Python script in TouchDesigner for bigger changes. Each call is one undo step.
td_write_dat Changes the text of a DAT.
td_navigate_to Moves the network editor to an operator, so you see what the agent means.
td_clear_textport Clears the Textport.
td_extract_recipe Saves the operators inside an annotation as a component.

Learn

td_get_hints The manual and the tips for a task, read before the agent acts.
td_get_docs The TouchDesigner docs for an operator or a Python class.
td_get_par_info What a parameter does and which values it takes.

Cloud and reports

td_hub Reads your Cloud and the Rudiments library.
td_hub_write Every Cloud action that changes something: upload, delete, share, public link. Set your client to ask you before this tool.
td_submit_report Sends a bug or feature report about twozero to the team, only when you ask for it. It can also send this session's trace: the agent shows you a preview first, and nothing leaves until you say yes.

How to talk to your agent: Talk to your agent.