touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/xiaoshan1234/ai-skill --skill touchdesigner-mcp-xiaoshan1234
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/xiaoshan1234/ai-skill/tree/main/origin/touchdesigner-mcp
Command: npx skills add https://github.com/xiaoshan1234/ai-skill --skill touchdesigner-mcp-xiaoshan1234

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building TouchDesigner networks by hand requires memorizing version-specific parameter names, wiring rules, and operator quirks that change between releases. This Skill lets an AI agent create, wire, parameterize, debug, and record TouchDesigner projects programmatically through the twozero MCP server's 36 native tools, eliminating guesswork about parameter names and common failure modes. ## Core Features & Use Cases - Programmatic network construction: Create operators, set validated parameters, wire connections, and inspect errors using native MCP tools like td_create_operator, td_set_operator_pars, and td_get_errors instead of raw Python. - Audio-reactive and GLSL workflows: Proven recipes for spectrum analysis pipelines, GLSL TOP shaders with time uniforms, feedback effects, and MovieFileOut recording with ProRes codecs. - Deep reference library: Twenty reference documents cover pitfalls, operator families, 3D scenes, animation, MIDI/OSC, particles, projection mapping, external data, and DAT scripting. - 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 chain, writes the shader, verifies output via screenshots, and records a ProRes movie. ## Quick Start Run the bundled setup script to install the twozero.tox plugin and register the MCP server, then ask the agent to build a noise-based animated background 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 twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and register it with your agent. The agent then uses native tools like td_create_operator and td_set_operator_pars to build and modify networks.

How do I 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 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 does my TouchDesigner script fail with tdAttributeError?▼

Parameter names vary between TD versions, so hardcoded names from training data often fail on TD 2025.32. Call td_get_par_info for the operator type first to get correct parameter names, then set values with td_set_operator_pars.

Is the twozero MCP server secure to run locally?▼

The 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, so treat it as trusted-local-only.