touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost.

1|Updated Aug 6, 2026
One-click install
npx skills add https://github.com/agtktID/indagis-agent --skill touchdesigner-mcp-agtktid
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/agtktID/indagis-agent/tree/main/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/agtktID/indagis-agent --skill touchdesigner-mcp-agtktid

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 create operators, set parameters, wire networks, capture screenshots, and diagnose errors inside TouchDesigner through the twozero MCP plugin's 36 native tools. ## Core Features & Use Cases - Network construction and inspection: Create TOPs, CHOPs, SOPs, DATs, MATs, and COMPs, set validated parameters, wire connections, and read back network structure, errors, and performance data. - Audio-reactive and GLSL workflows: Proven recipes for spectrum-driven shaders, feedback effects, video recording via MovieFileOut, and correct time uniform handling in GLSL TOPs. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers parameter names with td_get_par_info, builds the AudioFileIn to AudioSpectrum to CHOP-to-TOP chain, writes the shader, verifies output with screenshots, and records a ProRes movie. ## Quick Start Run the bundled setup script to install twozero.tox and register the 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 via MCP?▼

Install the free twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and register it in your agent config. The agent then uses 36 native tools like td_create_operator and td_set_operator_pars to build and inspect networks.

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 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 license limit video recording?▼

Non-Commercial TD caps resolution at 1280x1280 and blocks H.264, H.265, and AV1 codecs. Use outputresolution set to custom and record with the prores codec on macOS or mjpa as a fallback via MovieFileOut TOP.

Why does my TouchDesigner shader output black or record empty video?▼

Black output usually means a shader compile error or missing input texture; check td_get_errors and the glsl info DAT. Empty recordings happen when FPS is zero, so verify with td_get_perf and confirm output with td_get_screenshot before recording.

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.