touchdesigner-mcp

Control TouchDesigner via twozero MCP to build real-time visuals, wire operators, and execute Python.

Updated May 28, 2026
One-click install
npx skills add https://github.com/patty-chow/the-stable --skill touchdesigner-mcp-patty-chow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/patty-chow/the-stable/tree/main/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/patty-chow/the-stable --skill touchdesigner-mcp-patty-chow

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building TouchDesigner networks by hand is slow and error-prone, especially when parameter names vary across TD versions. This Skill lets an AI agent drive a running TouchDesigner instance through the twozero MCP server, creating operators, setting validated parameters, wiring connections, and debugging errors programmatically. ## Core Features & Use Cases - 36 native MCP tools: Create operators, set parameters safely, inspect networks, capture screenshots, read errors, and profile performance without guessing parameter names. - Proven creative recipes: Audio-reactive GLSL pipelines, feedback effects, 3D scenes with PBR lighting, particle systems, projection mapping, and video recording via MovieFileOut. - Deep reference library: 20+ reference files covering pitfalls, operator families, GLSL uniforms, MIDI/OSC, external data (HTTP/WebSocket/MQTT/Serial), and DAT scripting callbacks. - 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-shader chain, verifies output via screenshots, and records ProRes video. ## Quick Start Run the bundled setup script to install the twozero MCP server, then ask the agent to create a noise-based animated background 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 with 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 debug networks programmatically.

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.

Does TouchDesigner Non-Commercial license limit resolution?▼

Yes, Non-Commercial TD caps resolution at 1280x1280. Set outputresolution to custom and specify width and height explicitly. H.264, H.265, and AV1 codecs also require a Commercial license, so use ProRes on macOS or MJPA as fallback.

Why does my TouchDesigner shader output black or record empty video?▼

Black output usually means a shader compile error or missing input texture. Check td_get_errors and the glsl info DAT, verify FPS is above zero with td_get_perf before recording, and confirm parameter names with td_get_par_info since names vary by TD version.

Can I record video from TouchDesigner programmatically?▼

Yes, create a moviefileoutTOP, connect your output TOP, set videocodec to prores, and pulse the record parameter. TOP.save() does not work for animation because it captures the same GPU texture each frame, so always use MovieFileOut.

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. td_execute_python has unrestricted access to the TD Python environment and filesystem, but no data leaves the local machine.