touchdesigner-mcp

Control TouchDesigner via MCP to create operators, set parameters, and build real-time visuals.

1|Updated Jun 1, 2026
One-click install
npx skills add https://github.com/Araara7/hermes-skills --skill touchdesigner-mcp-araara7
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/Araara7/hermes-skills/tree/main/creative/touchdesigner-mcp
Command: npx skills add https://github.com/Araara7/hermes-skills --skill touchdesigner-mcp-araara7

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building TouchDesigner networks by hand is slow and error-prone, and AI agents often guess wrong parameter names for specific TD versions. This Skill connects an AI agent to a running TouchDesigner instance through the twozero MCP server, exposing 36 native tools for deterministic node creation, parameter setting, wiring, debugging, and capture. ## Core Features & Use Cases - Network construction and control: Create operators, set validated parameters, wire connections, and execute Python inside TD via tools like td_create_operator, td_set_operator_pars, and td_execute_python. - Inspection and debugging: Query parameter schemas with td_get_par_info, find errors with td_get_errors, profile performance with td_get_perf, and capture operator or screen screenshots. - Production recipes: Reference guides cover audio-reactive GLSL pipelines, 3D scenes with PBR lighting, animation, MIDI/OSC, projection mapping, particles, and video recording via MovieFileOut. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names, builds the AudioSpectrum-to-GLSL chain, verifies FPS and output via screenshots, and records a ProRes video. ## Quick Start Run the bundled setup script, drag the twozero.tox into TouchDesigner, enable MCP auto-start, then ask the agent to build a noise-based animated background in the current 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 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 deterministically.

How do I 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. 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 prores on macOS or mjpa as fallback, and set outputresolution to custom.

Why does my TouchDesigner script fail with tdAttributeError?▼

Parameter names vary between TD versions, so hardcoded names from training data often fail on TD 2025.32. Call td_get_par_info for the operator type first to get exact parameter names before setting values.

Can I use SOPs inside a geometry COMP for rendering?▼

In TD 099, geometry COMPs render POPs but not SOPs; a boxSOP inside a geometry COMP is invisible with no errors. Use POP equivalents like boxPOP or spherePOP, and connect them to an outPOP.

Is the twozero MCP connection secure?▼

The MCP server runs on localhost only (port 40404) 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.