touchdesigner-mcp

Control TouchDesigner via twozero MCP to build real-time visuals and generative art.

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

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 gives an AI agent structured, validated control over a live TouchDesigner instance through the twozero MCP server, with 36 native tools and battle-tested recipes. ## Core Features & Use Cases - Operator creation and wiring: Create TOPs, CHOPs, SOPs, DATs, MATs, and COMPs with validated parameters, wire connections, and inspect networks via native MCP tools instead of raw Python. - Audio-reactive and GLSL workflows: Proven signal chains for spectrum-driven shaders, feedback effects, and real-time generative visuals, with empirically verified parameter values for TD 2025.32. - Recording and export: Capture output via MovieFileOut TOP with ProRes or MJPA codecs, plus screenshot-based verification before recording. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers parameter names with td_get_par_info, builds the AudioFileIn to AudioSpectrum to CHOP-to-TOP to GLSL chain, verifies FPS and output, then records a ProRes video. ## Quick Start Run the setup script at skills/creative/touchdesigner-mcp/scripts/setup.sh, drag twozero.tox into TouchDesigner and enable MCP, then ask the agent to create a noise-based animated background at 1280x720.

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 free twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and add it as an MCP server in your agent config. The agent then uses 36 native tools like td_create_operator and td_set_operator_pars to build and modify networks.

How to 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. Do not use Lag or Filter CHOPs on spectrum data since timeslice expansion averages values to near-zero.

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 the MovieFileOut TOP with prores on macOS or mjpa as a fallback, and set outputresolution to custom.

Why does my TouchDesigner shader output show black?▼

Black output usually means a shader compile error, missing input texture, or no light in a 3D scene. Check td_get_errors recursively, read the glsl info DAT for compile messages, and capture a screenshot with td_get_screenshot to verify before recording.

What are the limitations of the twozero MCP integration?▼

The MCP server runs on localhost only with no authentication, so any local process can send commands. td_execute_python has unrestricted filesystem access as the TD process user, and parameter names vary by TD version so td_get_par_info should be called first.