skills.rest
hugotown
hugotownCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

touchdesigner-mcp

Control a running TouchDesigner instance via twozero MCP to build real-time visuals.

Updated Oct 16, 2025
Search Tags:#creative coding#generative art#mcp#glsl#touchdesigner#audio-reactive#real-time visuals
One-click install
npx skills add https://github.com/hugotown/dotfiles --skill touchdesigner-mcp-hugotown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/hugotown/dotfiles/tree/main/hermes/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/hugotown/dotfiles --skill touchdesigner-mcp-hugotown

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Building TouchDesigner networks by hand requires memorizing hundreds of operator parameter names and Python API details that change between TD versions. This Skill lets an AI agent create operators, set parameters, wire connections, execute Python, and debug errors inside a live TouchDesigner instance through the twozero MCP server. ## Core Features & Use Cases - 36 native MCP tools: Create operators, set parameters safely, inspect networks, capture screenshots, read errors, and profile performance without guessing parameter names. - Verified recipes: Audio-reactive GLSL pipelines, feedback loops, 3D scenes with PBR lighting, video recording via MovieFileOut, and MIDI/OSC/external data integration. - Use Case: Ask the agent to build an audio-reactive GLSL visual: it discovers correct parameter names with td_get_par_info, builds the AudioSpectrum-to-GLSL chain, verifies output via screenshots, and records a ProRes video. ## Quick Start Run the setup script at scripts/setup.sh, drag the downloaded twozero.tox into TouchDesigner, enable MCP in its settings, then ask the agent to build a noise-based animated background in the running TouchDesigner 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 from an AI agent?▼

Install the free twozero.tox plugin in TouchDesigner, enable its MCP server on port 40404, and register it as an MCP server 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 do I build an audio-reactive 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. Do not use Lag or Filter CHOPs on spectrum data since they expand samples and average 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 does my TouchDesigner script fail with tdAttributeError?▼

Parameter names differ 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, then use td_set_operator_pars which validates parameters safely.

Can I use GLSL shaders in TouchDesigner?▼

Yes, use glslTOP for pixel and compute shaders or glslMAT for vertex shaders on geometry. Pass time via a custom uniform like uTime bound to absTime.seconds, since uTDCurrentTime does not exist in GLSL TOP.

Is the twozero MCP connection secure?▼

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

Related Skills

Explore More Design & Creative Skills→
CyapstayeCyapstaye
9

touchdesigner-mcp

Control TouchDesigner instances via MCP to create operators and manage parameters.

Community
Advanced
storyclaw-officialstoryclaw-official

video-frames

Extract single frames or short clips from video files using ffmpeg.

Official
Basic
damionrashforddamionrashford
15

workflow-live-production

Orchestrate live productions with OBS, MIDI/OSC, DMX, PTZ, and MediaMTX.

Community
Advanced
ashiqcodeleafashiqcodeleaf

touchdesigner-mcp

Automates creation, control, and manipulation of TouchDesigner instances via twozero MCP and Python scripting.

Community
Advanced