touchdesigner-mcp

Automate TouchDesigner scene control via twozero MCP with operator creation and verification.

Updated May 4, 2026
One-click install
npx skills add https://github.com/JamesFincher/gengar --skill touchdesigner-mcp-jamesfincher
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/JamesFincher/gengar/tree/main/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/JamesFincher/gengar --skill touchdesigner-mcp-jamesfincher

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill removes the guesswork and brittle scripting involved in controlling a live TouchDesigner project by providing a reliable MCP toolset and strict build/discovery rules.

Core Features & Use Cases

  • Operator discovery before modification: uses TD-native introspection calls (e.g., get parameter info and hints) so parameter names and workflows match the user’s TouchDesigner version.
  • Safe, deterministic network construction: guides you to create, set parameters, wire connections, and verify results while avoiding common TD pitfalls like invalid OP references.
  • Creative-coding workflows over HTTP MCP: supports real-time operator creation, parameter updates, shader-driven visuals, audio-reactive pipelines, and rendering/screenshot/record capture from a running TD instance.

Quick Start

Ask the agent to run the scripted setup command to connect your running TouchDesigner instance to the MCP server, then tell it what you want to build (e.g., “Create an audio-reactive GLSL TOP that responds to bass and render a 10-second ProRes export.”).

Frequently Asked Questions about touchdesigner-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate real-time TouchDesigner scene control without writing brittle scripts?

You can automate real-time TouchDesigner scene control by using MCP tools to drive operator creation, parameter discovery, wiring, and verification directly within a running instance. This approach replaces guesswork with deterministic, tool-driven network construction.

Can I build audio-reactive GLSL visuals in TouchDesigner through MCP commands?

Yes, you can build audio-reactive GLSL visuals by instructing the agent to create GLSL TOPs and wire them to audio analysis operators via MCP. The Skill supports real-time parameter updates and shader-driven pipelines for live VJ-style performances.

What's the best way to discover valid TouchDesigner parameters before modifying a network?

The best way to discover valid parameters is by running TD-native introspection calls like td_get_par_info and td_get_hints before modification. This strict pre-discovery ensures parameter names and workflows match your specific TouchDesigner version.

Does TouchDesigner MCP control require a specific network configuration?

TouchDesigner MCP control requires local-only connectivity established through a configured localhost port. You must run the scripted setup command to connect your running TouchDesigner instance to the MCP server before executing any operator commands.

Why does my TouchDesigner MCP operator creation fail with invalid references?

Operator creation fails when you skip guarded execution steps like td_get_operator_info and td_get_errors. To avoid invalid OP references and common TD pitfalls, you must perform strict pre-discovery and verify results after creating and wiring operators.

How do I automate rendering and screenshot capture from a running TouchDesigner project?

You can automate rendering and screenshot capture by using MCP tools to trigger record and screenshot workflows within your live TouchDesigner instance. This supports automated render exports for generative art and audio-reactive visual pipelines.