touchdesigner-mcp

Control TouchDesigner via twozero MCP to create operators, set parameters, and build real-time visuals.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/xu1713/openhorse --skill touchdesigner-mcp-xu1713
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/xu1713/openhorse/tree/main/openhorse/openhorse/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/xu1713/openhorse --skill touchdesigner-mcp-xu1713

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building TouchDesigner networks by hand requires memorizing hundreds of operator parameter names that change between TD versions, and scripting against a running instance is error-prone. This Skill connects an AI agent to a live TouchDesigner instance through the twozero MCP server, exposing 36 native tools for creating operators, setting parameters, wiring connections, executing Python, and capturing output. ## Core Features & Use Cases - Network construction: Create TOPs, CHOPs, SOPs, DATs, MATs, and COMPs with validated parameters, wire them together, and inspect the resulting network structure. - Real-time visual workflows: Proven recipes for audio-reactive GLSL shaders, feedback effects, 3D scenes with PBR lighting, particle systems, and projection mapping. - Verification and debugging: Query errors recursively, profile performance, capture operator screenshots, and read the textport to diagnose failures. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names via td_get_par_info, builds the AudioFileIn → AudioSpectrum → CHOP to TOP → GLSL chain, verifies FPS and output via screenshots, then records ProRes video through a MovieFileOut TOP. ## Quick Start Run the bundled setup script to install the twozero.tox plugin and register the MCP server, then ask the agent to create a noise TOP animated by an LFO in the running TouchDesigner project.

Frequently Asked Questions about touchdesigner-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control TouchDesigner from an AI agent?

Install the twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and register it in your agent config. The agent then uses 36 native tools like td_create_operator, td_set_operator_pars, and td_execute_python to build and modify networks.

How do I build an audio-reactive visual in TouchDesigner?

Chain AudioFileIn CHOP into AudioSpectrum CHOP with TimeSlice on and output length set to 256, then Math CHOP with gain 10, then CHOP to TOP feeding a GLSL TOP. Avoid Lag or Filter CHOPs on spectrum data since timeslice expansion averages values to near zero.

Why do TouchDesigner parameter names cause errors when scripting?

Parameter names vary between TD versions, so training data is often wrong for TD 2025.32. Always call td_get_par_info for the operator type first to get exact parameter names before setting values.

Does TouchDesigner Non-Commercial support video recording?

Yes, but resolution is capped at 1280x1280 and H.264/H.265/AV1 codecs require a Commercial license. Use MovieFileOut TOP with prores on macOS or mjpa as fallback, and set outputresolution to custom.

Why is my TouchDesigner recording empty or black?

Check FPS via td_get_perf first since zero FPS produces empty recordings, then capture a screenshot with td_get_screenshot to verify the shader output is not black. Black output usually means a shader compile error or missing input texture.

What are the security risks of the twozero MCP server?

The MCP server runs on localhost port 40404 with no authentication, so any local process can send commands. The td_execute_python tool has unrestricted access to the TD Python environment and filesystem, but no data leaves the local machine.