touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server to build real-time generative visuals.

6|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/josoroma/AppLoop --skill touchdesigner-mcp-josoroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/josoroma/AppLoop/tree/main/.hermes/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/josoroma/AppLoop --skill touchdesigner-mcp-josoroma

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 GLSL conventions, and mistakes like wrong parameter names or broken audio-reactive chains silently produce black output or dead data. ## Core Features & Use Cases - MCP-driven network construction: Create operators, set validated parameters, wire connections, and inspect errors through 36 native twozero MCP tools instead of guessing TD Python API details. - Audio-reactive and GLSL recipes: Proven signal chains for spectrum-driven shaders, feedback effects, recording via MovieFileOut, and 3D scenes with lighting, PBR materials, and instancing. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers parameter names with td_get_par_info, creates the AudioFileIn to AudioSpectrum to CHOP-to-TOP chain, wires a GLSL TOP, verifies with td_get_errors and screenshots, then records 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 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 free twozero.tox plugin in TouchDesigner and enable its MCP server on port 40404. The agent then uses 36 native MCP tools like td_create_operator and td_set_operator_pars to build and inspect networks without guessing parameter names.

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

Does TouchDesigner Non-Commercial license limit video recording?▼

Non-Commercial TouchDesigner caps resolution at 1280x1280 and blocks H.264, H.265, and AV1 codecs. Use MovieFileOut TOP with prores codec on macOS or mjpa as fallback, and set outputresolution to custom.

Why does my TouchDesigner shader output black or empty video?▼

Black output usually means a shader compile error, missing input texture, or zero FPS. Verify with td_get_screenshot and td_get_perf before recording, and check the glsl info DAT for compile errors.

What is the correct way to find TouchDesigner parameter names?▼

Call td_get_par_info with the operator type before setting any parameters, since parameter names vary between TD versions and training data is often outdated. If a tdAttributeError fires, call td_get_operator_info on the failing node.