touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill touchdesigner-mcp-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/creative/touchdesigner-mcp
Command: npx skills add https://github.com/Chia1104/agent-air --skill touchdesigner-mcp-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building and debugging TouchDesigner networks by hand is slow and error-prone, especially since parameter names vary across TD versions and training data is often outdated. This Skill lets an AI agent programmatically create operators, set parameters, wire connections, capture screenshots, and diagnose errors in a running TouchDesigner instance through the twozero MCP server. ## Core Features & Use Cases - Network construction and inspection: Create TOPs, CHOPs, SOPs, DATs, MATs, and COMPs with validated parameters, then verify with error scans, performance profiling, and operator screenshots. - Audio-reactive and GLSL workflows: Proven recipes for spectrum-driven shaders, feedback effects, video recording via MovieFileOut, and correct CHOP-to-TOP signal chains. - Deep reference library: Over 20 reference documents covering 3D scenes, animation, particles, projection mapping, MIDI/OSC, external data, and DAT scripting. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names, builds the AudioFileIn to AudioSpectrum to CHOP-to-TOP chain, wires a GLSL TOP, verifies FPS, and records ProRes output. ## Quick Start Ask the agent to run the setup script and then build a noise-based animated background with a level adjustment and record ten seconds of ProRes video in TouchDesigner.

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

How to build an audio-reactive 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. Avoid Lag or Filter CHOPs on spectrum data since they average values to near-zero.

Does TouchDesigner Non-Commercial license limit video recording?▼

Yes, Non-Commercial caps resolution at 1280x1280 and blocks H.264, H.265, and AV1 codecs. Use custom output resolution and record with the prores codec on macOS or mjpa as a fallback via MovieFileOut TOP.

Why does my TouchDesigner script fail with tdAttributeError?▼

Parameter names differ between TD versions, so hardcoded names from older docs often fail. Call td_get_par_info for the operator type first to get correct parameter names, and td_get_operator_info on the failing node before retrying.

Can I use GLSL shaders in TouchDesigner TOPs?▼

Yes, glslTOP runs pixel and compute shaders with built-in uniforms like uTDOutputInfo and sTD2DInputs. Pass custom uniforms through the Values page parameters, and write large shaders to a file then load them with td_write_dat.

Is the twozero MCP server secure to run locally?▼

The MCP server binds to localhost only 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.