touchdesigner-mcp

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

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

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 normally requires manual UI interaction. 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 connections, and inspect networks via td_create_operator, td_set_operator_pars, and td_get_network. - Real-time visual recipes: Proven patterns for audio-reactive GLSL shaders, feedback effects, 3D scenes with PBR lighting, particles, projection mapping, and video recording via MovieFileOut. - Diagnostics and verification: Find errors recursively, profile performance, capture operator screenshots, and read the textport to debug builds. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names with td_get_par_info, builds the AudioSpectrum-to-GLSL signal chain, verifies FPS and output via screenshots, and records a ProRes movie. ## Quick Start Run the bundled setup script, drag the downloaded twozero.tox into TouchDesigner, enable the MCP toggle, 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 and enable its MCP server on port 40404. The agent then uses 36 native tools like td_create_operator, td_set_operator_pars, and td_execute_python to build and modify networks in the running instance.

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

Chain AudioFileIn CHOP to AudioSpectrum CHOP with TimeSlice on and output length 256, then Math CHOP with gain 10, then CHOP to TOP feeding a GLSL TOP. Never use 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 before setting parameters, and call td_get_operator_info if a tdAttributeError fires.

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 the prores codec 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, and capture a screenshot with td_get_screenshot to verify the shader output is not black. Black output usually indicates 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 as the TD process user.