touchdesigner-mcp

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill touchdesigner-mcp-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill touchdesigner-mcp-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Building TouchDesigner projects by hand requires memorizing hundreds of operator parameter names that change between TD versions, and scripting errors fail silently. This Skill gives an AI agent structured, validated control over TouchDesigner through the twozero MCP server, with proven recipes for audio-reactive visuals, GLSL shaders, and video recording. ## Core Features & Use Cases - Network Construction: Create, wire, and parameterize TOPs, CHOPs, SOPs, DATs, MATs, and COMPs using 36 native MCP tools with automatic parameter validation. - Audio-Reactive Visuals: Deploy a tested signal chain (AudioSpectrum CHOP to GLSL TOP) with correct TimeSlice, gain, and spectrum sampling settings. - Recording & Export: Capture animated output via MovieFileOut TOP with ProRes or MJPA codecs that work on Non-Commercial licenses. - Use Case: Ask the agent to build an audio-reactive GLSL shader visual, and it discovers parameter names, creates the operator chain, wires the spectrum texture, verifies FPS, and records a 1280x720 ProRes video. ## Quick Start Run the setup script, drag twozero.tox into TouchDesigner, enable MCP, then ask the agent to build an audio-reactive noise shader and record it to a video 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 tools like td_create_operator and td_set_operator_pars to build and modify networks without guessing parameter names.

How to build audio-reactive visuals in TouchDesigner?▼

Use the chain AudioFileIn CHOP to AudioSpectrum CHOP (TimeSlice on, output length 256) to Math CHOP (gain 10) to 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 license 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, and set outputresolution to custom.

Why does my TouchDesigner GLSL shader output black?▼

Black output usually means a shader compile error, missing input texture, or 8-bit time uniform clamping to 0-1. Check td_get_errors, capture td_get_screenshot of the output, and pass time via a Constant TOP in rgba32float format.

What are the limitations of the twozero MCP server?▼

The server runs on localhost only with no authentication, so any local process can send commands. td_execute_python has unrestricted access to the TD Python environment and filesystem as the TD process user.