touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill touchdesigner-mcp-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill touchdesigner-mcp-loteiron

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 change between 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 with validated parameters, then verify with error scans, performance profiling, and operator screenshots. - Audio-reactive and GLSL workflows: Proven recipes for spectrum-driven shaders, feedback effects, video recording via MovieFileOut, and 3D scenes with lighting and PBR materials. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names, wires an AudioSpectrum CHOP into a GLSL TOP, verifies FPS and output, and records a ProRes video. ## Quick Start Run the bundled setup script to install the twozero 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, enable its MCP server on port 40404, and connect the agent via Streamable HTTP. The agent then uses 36 native tools like td_create_operator and td_set_operator_pars to build and inspect networks.

How to build audio-reactive visuals in TouchDesigner?▼

Chain AudioFileIn CHOP into AudioSpectrum CHOP with TimeSlice on and output length 256, then a Math CHOP with gain 10, then 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 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 do TouchDesigner parameter scripts fail with tdAttributeError?▼

Parameter names vary 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 any values.

What are the security risks of the twozero MCP server?▼

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