touchdesigner-mcp

Control running TouchDesigner projects via twozero MCP operations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the problem of building reliable, repeatable programmatic control over a running TouchDesigner project by providing guardrailed MCP-based operations for creating, inspecting, wiring, and driving visuals.

Core Features & Use Cases

  • Real-time TouchDesigner control via twozero MCP: create operators, set parameters, wire connections, inspect network state, and execute Python when native tools are insufficient.
  • Deterministic discovery and safety checks: enforces correct parameter discovery flows (e.g., query parameter info before setting params) and stop-on-error behavior to avoid TD version drift.
  • Creative-coding workflows for visuals and media capture: build operator graphs for generative visuals, audio-reactive pipelines, feedback systems, and recording/screenshot verification.
  • Example Use Case: generate an audio-reactive GLSL visuals network by creating the required TOP/CHOP chain, setting codec/resolution constraints correctly, wiring inputs, and verifying output using errors/perf/screenshot capture.

Quick Start

Use the touchdesigner-mcp skill to create and drive a running TouchDesigner instance through twozero MCP, starting with the automated setup script and then using MCP tools to build and configure your operator network safely.

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 operator creation and parameter setting?

You can automate TouchDesigner operator creation and parameter setting by issuing twozero MCP operations for network creation, parameter configuration, and wiring. The skill enforces deterministic parameter discovery flows to avoid version drift and stop-on-error behavior.

Can I build audio-reactive GLSL visuals programmatically in TouchDesigner?

Yes, you can build audio-reactive GLSL visuals programmatically by creating the required TOP and CHOP operator chains through MCP tools. The skill sets codec and resolution constraints, wires inputs, and verifies output using screenshot and performance capture.

What is the best way to prevent invalid OP errors when scripting TouchDesigner networks?

To prevent invalid OP errors when scripting TouchDesigner networks, separate cleanup operations from creation steps. The skill enforces this separation and uses guarded fallback to TD Python only when native MCP tools are insufficient.

Does TouchDesigner MCP support real-time network inspection and screenshot verification?

TouchDesigner MCP supports real-time network inspection and screenshot verification through native twozero MCP tools. You can inspect network state, capture screenshots, check errors, and monitor performance during operator graph construction.

Why should I query parameter info before setting values in TouchDesigner automation?

Querying parameter info before setting values avoids parameter-name guessing and ensures deterministic discovery. This practice prevents TD version drift issues and enforces correct parameter configuration flows during programmatic TouchDesigner control.

Can I use relative callback paths when controlling TouchDesigner via MCP?

Yes, the skill supports relative callback paths when controlling TouchDesigner via MCP operations. This allows flexible operator graph construction while maintaining safety checks for generative art, feedback systems, and VJ workflows.