TouchDesigner MCP

What is TouchDesigner MCP?

TouchDesigner MCP is an MCP server that bridges AI agents with TouchDesigner projects. It enables AI agents to create, modify, and delete nodes, query properties, and execute Python scripts by communicating with TouchDesigner’s WebServer DAT.

How to use TouchDesigner MCP?

Install the server via npm, configure your AI client (e.g., Claude Desktop) to point to the server, and ensure TouchDesigner is running with the mcp_webserver_base.tox WebServer DAT (default port 9981). For full setup steps, refer to the Installation Guide.

Key features of TouchDesigner MCP

• Create, delete, and modify TouchDesigner nodes
• Execute arbitrary Python scripts in TouchDesigner
• Query node parameters and project structure
• Get Python help documentation for TouchDesigner classes
• Check for errors on nodes and their children
• Update parameters of specific nodes

Use cases of TouchDesigner MCP

• AI‑assisted node‑based visual programming in TouchDesigner
• Automating project setup and parameter tweaks via natural language
• Debugging TouchDesigner networks by checking node errors
• Generating complex networks and connecting nodes programmatically

FAQ from TouchDesigner MCP

What are the version compatibility rules?

The MCP server and its API server must share the same MAJOR version and the API version must be ≥ 1.3.0. Different MINOR/PATCH versions within the same MAJOR show a warning but continue; different MAJORs or an API below the minimum stop execution.

How do I fix a connection error to TouchDesigner?

For ECONNREFUSED, start TouchDesigner, ensure the WebServer DAT is running, and confirm the port (default 9981). For ETIMEDOUT, restart TouchDesigner or the WebServer DAT, or check your network. For ENOTFOUND, use 127.0.0.1 as the host.

Does the server cache connection failures?

Yes. The TouchDesignerClient caches failed connection checks for 60 seconds to avoid spamming TouchDesigner. After the TTL expires, the next tool call automatically retries.

What transports and authentication are supported?

The README does not specify transport or authentication details beyond the default HTTP port 9981. For further configuration, refer to the developer guide.

Are there any known limits?

The README does not list explicit limits, but version incompatibilities can stop execution. Resources are not implemented.