touchdesigner-mcp

Control TouchDesigner programmatically with 36 validated MCP tools.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill touchdesigner-mcp-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: touchdesigner-mcp
Source: https://github.com/Signmanal/VIGIL/tree/main/skills/creative/touchdesigner-mcp
Command: npx skills add https://github.com/Signmanal/VIGIL --skill touchdesigner-mcp-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

TouchDesigner is a powerful node-based environment for real-time interactive visuals, but programmatically controlling it from an AI assistant requires precise parameter discovery, safe operator creation, and reliable wiring. This skill eliminates the guesswork by providing 36 native MCP tools that validate parameters, inspect operators, and execute Python safely, preventing the common crashes and silent failures that occur when hardcoding version-specific parameter names.

Core Features & Use Cases

  • 36 Native MCP Tools: Create operators, set parameters, wire connections, inspect networks, capture screenshots, and execute Python with full validation and error reporting.
  • Version-Safe Parameter Discovery: Automatically retrieves correct parameter names for any TouchDesigner version, avoiding the broken training data that causes tdAttributeError crashes.
  • Audio-Reactive & Generative Visuals: Includes proven recipes for spectrum analysis, GLSL shaders, feedback loops, and instancing for VJ sets, installations, and creative coding.
  • Use Case: A VJ building an audio-reactive set can use this skill to create a noise TOP driven by FFT spectrum data, wire it through a GLSL shader, and record the output to ProRes without manually opening TouchDesigner's UI.

Quick Start

Use the touchdesigner-mcp skill to create an audio-reactive visual by building a spectrum analysis chain, connecting it to a GLSL shader, and recording the output to a ProRes movie file.

Frequently Asked Questions about touchdesigner-mcp

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

FAQPage Schema
How do I automate TouchDesigner network creation without causing parameter crashes?

Automating TouchDesigner network creation requires version-agnostic parameter validation to prevent crashes from hardcoding version-specific parameter names. This skill uses native MCP tools to inspect operators, validate parameters, and execute Python safely for deterministic operator management.

What is the best way to build audio-reactive visuals for a VJ performance programmatically?

Building audio-reactive visuals for VJ performances requires connecting FFT spectrum analysis to visual elements like noise TOPs and GLSL shaders. This skill provides proven recipes to automate creating these generative art chains and recording outputs to formats like ProRes.

Can I use MCP tools to control real-time visual development in TouchDesigner?

You can control real-time visual development in TouchDesigner via MCP using 36 validated native tools. These tools allow you to create operators, set parameters, wire connections, inspect networks, and capture screenshots entirely through local-only execution.

How do I prevent tdAttributeError when setting TouchDesigner parameters via Python?

Preventing tdAttributeError requires version-safe parameter discovery to avoid broken training data. This skill automatically retrieves correct parameter names for any TouchDesigner version, ensuring safe operator creation and reliable network wiring without silent failures.

Does this TouchDesigner MCP skill support GLSL shaders and 3D scene construction?

This TouchDesigner MCP skill supports GLSL shaders and 3D scene construction by providing tools for safe operator creation, parameter discovery, and network wiring. It includes recipes for instancing and feedback loops for installations and creative coding.