touchdesigner-mcp

Control TouchDesigner via twozero MCP to build real-time visuals and generative art.

5|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AjayRajan05/VoiceOS --skill touchdesigner-mcp-ajayrajan05
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/AjayRajan05/VoiceOS/tree/main/skills/bundled/community/creative/touchdesigner-mcp
Command: npx skills add https://github.com/AjayRajan05/VoiceOS --skill touchdesigner-mcp-ajayrajan05

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 and navigating a complex node editor. This Skill lets you control a running TouchDesigner instance programmatically through the twozero MCP server, so you can create operators, set parameters, wire connections, and execute Python without guessing API details. ## Core Features & Use Cases - Node Network Automation: Create, wire, and configure TOPs, CHOPs, SOPs, DATs, MATs, and COMPs using 36 native MCP tools with automatic parameter validation. - Audio-Reactive & GLSL Visuals: Proven recipes for spectrum-driven shaders, feedback effects, and real-time generative art with verified signal chains. - Recording & Export: Capture output via MovieFileOut TOP with ProRes or MJPA codecs, including pre-recording checklists for FPS and shader verification. - Use Case: Ask the assistant to build an audio-reactive GLSL visualizer — it discovers correct parameter names, builds the AudioFileIn → AudioSpectrum → CHOP to TOP → GLSL chain, verifies no errors, and records the result to video. ## Quick Start Ask the assistant to set up the TouchDesigner MCP connection and create a simple animated noise visual in the running TouchDesigner 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 assistant?▼

Install the free twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and register it as an MCP server in VoiceOS. The assistant then uses 36 native tools to create operators, set parameters, and run Python inside TouchDesigner.

How do I build audio-reactive visuals in TouchDesigner?▼

Use the verified signal 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 license limit video export?▼

Yes, Non-Commercial caps resolution at 1280x1280 and blocks H.264, H.265, and AV1 codecs. Use outputresolution set to custom with explicit width and height, and record with the prores codec on macOS or mjpa as a fallback.

Why does my TouchDesigner shader show black output?▼

Black output usually means a shader compile error, missing input texture, or FPS of zero. Check td_get_errors for compile issues, verify inputs with td_get_screenshot, and confirm FPS via td_get_perf before recording.

What is the difference between td_execute_python and native MCP tools?▼

Native tools like td_create_operator and td_set_operator_pars validate parameters and handle viewport positioning safely. Reserve td_execute_python for wiring connections, setting expressions, and batch operations that native tools do not cover.