touchdesigner-mcp

Control TouchDesigner via twozero MCP to build operators, wire networks, and render real-time visuals.

Updated Apr 18, 2026
One-click install
npx skills add https://github.com/azaanaliraza/operarius --skill touchdesigner-mcp-azaanaliraza
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/azaanaliraza/operarius/tree/main/src-tauri/bin/hermes/optional-skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/azaanaliraza/operarius --skill touchdesigner-mcp-azaanaliraza

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 an AI agent drive a running TouchDesigner instance through the twozero MCP server, creating operators, setting parameters, wiring connections, and executing Python without manual GUI work. ## Core Features & Use Cases - 36 Native MCP Tools: Create operators, set parameters safely, inspect networks, capture screenshots, read errors, and profile performance through structured tool calls instead of raw scripting. - Proven Network Recipes: Reference guides cover audio-reactive GLSL fractals, feedback loops, instancing, video effects chains, and recording pipelines with tested parameter values. - Recording & Export: Render visuals to ProRes or Motion JPEG via MovieFileOut TOP, then extract frames with ffmpeg for external post-processing pipelines. - Use Case: Ask the agent to build an audio-reactive fractal visual from an MP3 file — it sets up the AudioSpectrum CHOP chain, writes the GLSL shader, wires the network, verifies FPS, and records the output video. ## Quick Start Run the setup script to install the twozero.tox plugin, then ask the agent to build an audio-reactive visual in TouchDesigner from a music file.

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 modify networks programmatically.

How to build audio-reactive visuals in TouchDesigner?▼

Chain an AudioFileIn CHOP into an AudioSpectrum CHOP with output length set to 256, boost with a Math CHOP at gain 10, convert to a texture via CHOP to TOP, and sample it in a GLSL TOP shader. Keep TimeSlice on and avoid Lag or Filter CHOPs, which destroy spectrum data.

Does TouchDesigner Non-Commercial support video recording?▼

Yes, but H.264, H.265, and AV1 codecs require a Commercial license. Use ProRes on macOS or Motion JPEG (mjpa) as a fallback with the MovieFileOut TOP. Resolution is also capped at 1280x1280 on Non-Commercial.

Why does my TouchDesigner GLSL shader show black output?▼

Black output usually means a shader compile error, missing input texture, or 8-bit time clamping. Feed time through a Constant TOP in rgba32float format, verify inputs with td_get_screenshot, and check td_get_errors for compile messages.

What are the limitations of the twozero MCP integration?▼

The MCP server runs on localhost without authentication, so any local process can send commands. Wiring connections still requires td_execute_python since no native wire tool exists, and parameter names vary by TD version, requiring td_get_par_info lookups before setting values.