TouchDesigner MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TD_MCP_URL | Yes | The URL of the TouchDesigner bridge API, e.g. http://127.0.0.1:9980/api | |
| TD_MCP_TOKEN | Yes | The access token set in the TouchDesigner component's MCP parameter page | |
| TD_MCP_TIMEOUT_MS | No | Timeout in milliseconds for requests to TouchDesigner | 10000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| td_pingA | 检查 TouchDesigner 桥接是否在线。 |
| td_project_infoA | 读取当前 TouchDesigner 工程、版本、时间轴和桥接信息。 |
| td_list_operatorsB | 递归列出指定根节点下的 Operators，可按名称、路径、OP 类型或 family 过滤。 |
| td_operator_infoB | 读取一个 Operator 的类型、连接、位置、子节点和可选参数。 |
| td_get_parametersC | 读取一个 Operator 的参数值、表达式、模式和只读状态。 |
| td_set_parameterC | 设置 Operator 参数的常量值或 Python 表达式。 |
| td_pulse_parameterC | 触发 Pulse 类型参数，例如 reset、reload、save。 |
| td_create_operatorC | 在父 COMP 内创建新的 Operator。 |
| td_connect_operatorsC | 连接两个 Operator 的输出和输入连接器。 |
| td_disconnect_inputC | 断开目标 Operator 的指定输入连接。 |
| td_set_node_positionC | 设置 Operator 在 Network Editor 中的位置。 |
| td_get_dat_textC | 读取 Text DAT 等 DAT 的文本内容。 |
| td_set_dat_textC | 替换 Text DAT 等 DAT 的文本内容。 |
| td_destroy_operatorA | 删除 Operator。必须明确传入 confirm=true；不能删除根节点或桥接自身。 |
| td_save_projectA | 保存当前 TouchDesigner 工程；可选另存为指定 .toe 路径。 |
| td_execute_pythonB | 在 TouchDesigner 主环境执行 Python。TD 桥接的 Allow Python 默认关闭，只有显式开启后可用。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Each tool has a distinct action and target (e.g., connect, create, destroy, get_dat, set_param). No two tools overlap in purpose, ensuring agents can clearly distinguish them.
All tools follow a consistent 'td_verb_noun' pattern using snake_case. Verbs are uniform and descriptive, such as create/destroy/list/get/set, making the set predictable.
With 16 tools covering connection management, operator CRUD, parameter access, execution, and project operations, the count is well-scoped for TouchDesigner's domain without unnecessary bloat.
The set covers all major workflows: create, delete, connect, disconnect, parameter read/write, data table manipulation, and project save. Minor gaps like cloning or timeline control exist but do not impede core tasks.