
Touchdesigner Mcp Server
Bridges Claude to TouchDesigner's WebServer DAT so you can create, modify, and delete nodes through natural language. You get eleven tools covering the full lifecycle: spawn operators, wire connections, update parameters, execute arbitrary Python scripts inside TD, and query node properties or project structure. The prompts handle fuzzy node search and recursive error checking across the node tree. If you're prototyping generative visuals or need an AI to scaffold TouchDesigner networks on the fly, this gives you programmatic control without leaving the chat. Version checking enforces semantic compatibility between the MCP server and the TD component, so mismatched installs fail fast with upgrade instructions.
- GitHub stars
- 362
- tools
- 14
- transport
- STDIO
- last updated
- Nov 26, 2025
Tools
14 toolsPublic tool metadata for what this MCP can expose to an agent.
create_td_nodeCreates a new node.
Creates a new node.
No parameter schema in public metadata yet.
delete_td_nodeDeletes an existing node.
Deletes an existing node.
No parameter schema in public metadata yet.
describe_td_toolsGenerates a manifest of the available TouchDesigner tools.
Generates a manifest of the available TouchDesigner tools.
No parameter schema in public metadata yet.
exec_node_methodCalls a Python method on a node.
Calls a Python method on a node.
No parameter schema in public metadata yet.
execute_python_scriptExecutes an arbitrary Python script in TouchDesigner.
Executes an arbitrary Python script in TouchDesigner.
No parameter schema in public metadata yet.
get_td_class_detailsGets details of a TouchDesigner Python class or module.
Gets details of a TouchDesigner Python class or module.
No parameter schema in public metadata yet.
get_td_classesGets a list of TouchDesigner Python classes.
Gets a list of TouchDesigner Python classes.
No parameter schema in public metadata yet.
get_td_infoGets information about the TouchDesigner server environment.
Gets information about the TouchDesigner server environment.
No parameter schema in public metadata yet.
get_td_module_helpGets Python help() documentation for TouchDesigner modules/classes.
Gets Python help() documentation for TouchDesigner modules/classes.
No parameter schema in public metadata yet.
get_td_node_errorsChecks errors and warnings on a node and its descendants. Missing files, dangling references and shader failures are warnings, so no errors does not mean healthy.
Checks errors and warnings on a node and its descendants. Missing files, dangling references and shader failures are warnings, so no errors does not mean healthy.
No parameter schema in public metadata yet.
get_td_node_parametersGets the parameters of a specific node.
Gets the parameters of a specific node.
No parameter schema in public metadata yet.
get_td_nodesGets nodes under a parent path, with optional filtering.
Gets nodes under a parent path, with optional filtering.
No parameter schema in public metadata yet.
get_top_imageCaptures the current output of a TOP node as an image.
Captures the current output of a TOP node as an image.
No parameter schema in public metadata yet.
update_td_node_parametersUpdates the parameters of a specific node.
Updates the parameters of a specific node.
No parameter schema in public metadata yet.
Sponsors
Readme
TouchDesigner MCP
This is an implementation of an MCP (Model Context Protocol) server for TouchDesigner. Its goal is to enable AI agents to control and operate TouchDesigner projects.
Overview
TouchDesigner MCP acts as a bridge between AI models and the TouchDesigner WebServer DAT, enabling AI agents to:
- Create, modify, and delete nodes
- Query node properties and project structure
- Programmatically control TouchDesigner via Python scripts
Installation
Tell the AI agent you already use:
Details
- Repository
- github.com/8beeeaaat/touchdesigner-mcp
- Package
touchdesigner-mcp-server- Transport
- STDIO
- Registry
- MCP registry, active
