Agent skill · nousresearch
touchdesigner-mcp
Control TouchDesigner via twozero MCP.
What it needs
About 8k tokens when loaded.
What this skill does
TouchDesigner Integration (twozero MCP) CRITICAL RULES 1. NEVER guess parameter names. Call tdgetparinfo for the op type FIRST. Your training data is wrong for TD 2025.32. 2. If tdAttributeError fires, STOP. Call tdgetoperatorinfo on the failing node before continuing. 3. NEVER hardcode absolute paths in script callbacks. Use me.parent() / scriptOp.parent(). 4. Prefer native MCP tools over tdexecutepython. Use tdcreateoperator, tdsetoperatorpars, tdgeterrors etc. Only fall back to tdexecutepython for complex multi-step logic. 5. Call tdgethints before building. It returns patterns specific to the op type you're working with. Architecture 36 native tools. Free plugin (no payment/license — confirmed April 2026). Context-aware (knows selected OP, current network). Hub health check: GET http://localhost:40404/mcp returns JSON with instance PID, project name, TD version. Setup (Automated) Run the setup script to handle everything: The script will: 1. Check if TD is running 2. Download twozero.tox if not already cached 3. Add twozerotd MCP server to Hermes config (if missing) 4. Test the MCP connection on port 40404 5. Report what manual steps remain (drag .tox into TD, enable MCP toggle) Manual steps (one-time, cannot be automated) 1. Drag ~/Downloads/twozero.tox into the TD network editor → click Install 2. Enable MCP: click twozero icon → Settings → mcp → "auto start MCP" → Yes 3. Restart Hermes session to pick up the new MCP server After setup, verify: Environment Notes Non-Commercial TD caps resolution at 1280×1280. Use outputresolution = 'custom' and set width/height explicitly. Codecs: prores (preferred on macOS) or mjpa as fallback. H.264/H.265/AV1 require a Commercial license. Always call tdgetparinfo before setting params — names vary by TD version (see CRITICAL RULES #1). Workflow Step 0: Discover (before building anything) No temp nodes, no cleanup. This replaces the old discovery dance entirely. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills nousresearch/touchdesigner-mcp--032849