touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost HTTP.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building and debugging TouchDesigner projects by hand is slow and error-prone, especially when parameter names vary across TD versions. This Skill lets an AI agent programmatically create operators, wire networks, set parameters, capture screenshots, and record video inside TouchDesigner through the twozero MCP plugin. ## Core Features & Use Cases - Network Construction: Create and wire TOP, CHOP, SOP, DAT, MAT, and COMP operators using 36 native MCP tools, with parameter validation via td_get_par_info before any writes. - Audio-Reactive & GLSL Workflows: Proven recipes for spectrum-driven shaders, feedback loops, and MovieFileOut recording with ProRes or MJPA codecs. - Diagnostics & Capture: Inspect errors recursively, profile performance, read the textport, and screenshot operator viewers or the full screen for verification. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers parameter names, builds the AudioFileIn to AudioSpectrum to CHOP-to-TOP chain, wires a GLSL TOP, verifies FPS, and records the output to a .mov file. ## Quick Start Run the bundled setup script, drag twozero.tox into TouchDesigner, enable MCP auto-start, then ask the agent to build a noise-based animated background at 1280x720.

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_execute_python to build and modify networks over localhost HTTP.

How to build an audio-reactive GLSL 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. Never use 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 prores on macOS or mjpa as fallback, and set outputresolution to custom.

Why does tdAttributeError fire when setting TouchDesigner parameters?▼

Parameter names vary between TD versions, so guessed names often fail. Call td_get_par_info for the operator type first to get exact parameter names, then use td_set_operator_pars which validates values safely.

Is the twozero MCP connection secure?▼

The MCP server runs on localhost only with no authentication, meaning any local process can send commands. td_execute_python has unrestricted access to the TD Python environment and filesystem, so all communication stays local but trusts local processes.