touchdesigner-mcp

Control TouchDesigner networks via the twozero MCP server over localhost.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building TouchDesigner projects by hand requires memorizing version-specific parameter names, operator wiring rules, and GLSL conventions that change between releases. This Skill gives an AI agent structured, verified control over TouchDesigner through the twozero MCP server, eliminating guesswork and silent failures. ## Core Features & Use Cases - 36 native MCP tools: Create operators, set validated parameters, inspect networks, capture screenshots, read errors, and profile performance without writing raw Python. - Verified recipes: Audio-reactive GLSL pipelines, feedback loops, 3D scenes with PBR lighting, video recording via MovieFileOut, and MIDI/OSC/HTTP external data integration. - Defensive workflow rules: Mandatory parameter discovery via td_get_par_info, split cleanup/creation calls, and pre-recording checklists that prevent the most common TD failures. - Use Case: Ask the agent to build an audio-reactive GLSL visual; it discovers correct parameter names, wires the AudioSpectrum-to-shader chain, verifies FPS and output via screenshots, and records a ProRes video. ## 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?▼

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 modify networks.

How to build audio-reactive visuals 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 codec on macOS or mjpa as fallback, and set outputresolution to custom.

Why does my TouchDesigner shader show black output?▼

Black output usually means a shader compile error, missing input texture, or no light in a 3D scene. Check td_get_errors recursively, read the glsl info DAT for compile messages, and capture a screenshot with td_get_screenshot to verify.

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.