skills.rest
CHENHUI-X
CHENHUI-XCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost.

Updated Jul 3, 2026
Search Tags:#creative coding#generative art#mcp#glsl#touchdesigner#audio-reactive#real-time visuals
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill touchdesigner-mcp-chenhui-x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/CHENHUI-X/toolbox/tree/main/custom-skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill touchdesigner-mcp-chenhui-x

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 when parameter names vary across TD versions. This Skill lets an AI agent 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, set validated parameters, wire connections, and query errors or performance via 36 native MCP tools. - Audio-reactive and GLSL workflows: Proven recipes for spectrum-driven shaders, feedback effects, video recording via MovieFileOut, and post-FX chains, with version-correct parameter names for TD 2025.32. - 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 GLSL TOP chain, verifies output with screenshots, and records a ProRes movie. ## Quick Start Run the bundled setup script, drag twozero.tox into TouchDesigner, enable MCP, then ask the agent to build a noise-based animated background in the current project.

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 tools like td_create_operator, td_set_operator_pars, and td_get_errors 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 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.

Why does my TouchDesigner parameter script throw tdAttributeError?▼

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

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. td_execute_python has unrestricted access to TD's Python environment and filesystem as the TD process user.

Related Skills

Explore More Design & Creative Skills→
hugotownhugotown

touchdesigner-mcp

Control a running TouchDesigner instance via twozero MCP to build real-time visuals.

Community
Advanced
Araara7Araara7

touchdesigner-mcp

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

Community
Advanced
damionrashforddamionrashford
15

workflow-live-production

Orchestrate live productions with OBS, MIDI/OSC, DMX, PTZ, and MediaMTX.

Community
Advanced
markwang2658markwang2658
31

touchdesigner-mcp

Automates Hermes MCP integration and operation for TouchDesigner on Windows.

Community
Intermediate