touchdesigner-mcp

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

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

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 without live feedback. This Skill gives an AI agent direct, verified control over a running TouchDesigner instance through the twozero MCP server, with 36 native tools and battle-tested recipes that avoid common pitfalls. ## Core Features & Use Cases - Live Network Construction: Create operators, set validated parameters, wire connections, and execute Python inside TouchDesigner via MCP tools like td_create_operator, td_set_operator_pars, and td_execute_python. - Audio-Reactive & GLSL Visuals: Proven signal chains for spectrum-driven shaders, feedback effects, and real-time generative art, with empirically verified parameter values for TD 2025.32. - Recording & Export: Capture output via MovieFileOut TOP with ProRes/MJPEG codecs, screenshot any operator, and profile performance with td_get_perf. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names with td_get_par_info, builds the AudioFileIn → AudioSpectrum → CHOP to TOP → GLSL chain, verifies with td_get_errors and screenshots, then records a 1280x720 ProRes video. ## Quick Start Ask the agent to run the setup script and then build a noise-based animated background in TouchDesigner with a level adjustment and a null output.

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 or script?▼

Install the free twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and connect via Streamable HTTP. The agent then uses 36 native tools like td_create_operator and td_set_operator_pars to build and modify networks live.

How to build audio-reactive visuals in TouchDesigner?▼

Use the chain AudioFileIn CHOP → AudioSpectrum CHOP (TimeSlice on, output length 256) → Math CHOP (gain 10) → CHOP to TOP → GLSL TOP. Never use Lag or Filter CHOPs on spectrum data, as timeslice expansion averages all bins 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 MovieFileOut TOP with the prores codec on macOS or mjpa as a fallback, and set outputresolution to custom.

Why do TouchDesigner parameter scripts fail with tdAttributeError?▼

Parameter names vary between TD versions, so training-data guesses are often wrong for TD 2025.32. Call td_get_par_info for the operator type first to get exact parameter names before setting any values.

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 some manual steps like dragging the .tox into TD cannot be automated.