touchdesigner-mcp

Control TouchDesigner via twozero MCP to build real-time visuals, GLSL shaders, and audio-reactive networks.

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill touchdesigner-mcp-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/creative/touchdesigner-mcp
Command: npx skills add https://github.com/perasyudha/Nyxora --skill touchdesigner-mcp-perasyudha

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 vary across TD releases. This Skill lets an AI agent programmatically create operators, set validated parameters, wire connections, execute Python, and debug errors inside a running TouchDesigner instance through the twozero MCP server. ## Core Features & Use Cases - Programmatic Network Construction: Create TOPs, CHOPs, SOPs, DATs, MATs, and COMPs with validated parameters using 36 native MCP tools, with automatic viewport positioning and error checking. - Audio-Reactive & GLSL Workflows: Proven recipes for spectrum-driven shaders, feedback effects, 3D scenes with PBR lighting, and video recording via MovieFileOut TOP. - Deep Reference Library: Over 20 reference documents covering pitfalls, operator families, animation, MIDI/OSC, projection mapping, external data, and DAT scripting. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names, builds the AudioSpectrum-to-shader chain, verifies output via screenshots, and records a ProRes video. ## Quick Start Run the bundled setup script to install the twozero.tox plugin and register the MCP server, then ask the agent to create 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 as an MCP server in your agent config. The agent then uses 36 native tools to create operators, set parameters, and run Python inside TD.

How to build audio-reactive visuals 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 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 MovieFileOut TOP with the prores codec on macOS or mjpa as a fallback for license-free recording.

Why do TouchDesigner parameter scripts fail with tdAttributeError?

Parameter names vary between TD versions, so hardcoded names from training data often fail. Call td_get_par_info for the operator type first to get exact parameter names before setting values.

Can I pass time uniforms to a GLSL TOP in TouchDesigner?

There is no built-in uTDCurrentTime uniform. Set a Values page parameter like value0name to uTime, bind value0 to the expression absTime.seconds, and declare uniform float uTime in the shader.