touchdesigner-mcp

Control a running TouchDesigner instance via the twozero MCP protocol.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

TouchDesigner visual development is traditionally GUI-bound, manual, and difficult to reproduce programmatically. This Skill eliminates that bottleneck by enabling full programmatic control of a running TouchDesigner instance through the twozero MCP protocol, allowing AI agents to build, modify, and record real-time visual systems without manual clicking.

Core Features & Use Cases

  • 36 Native MCP Tools: Create operators, set parameters, wire connections, execute Python, capture screenshots, and manage instances—all through standardized tool calls.
  • Real-Time Visual Development: Build generative art, audio-reactive installations, projection mappings, and GLSL shader pipelines with deterministic, version-aware parameter discovery.
  • Production Recording: Export video with proper codec handling (ProRes/mjpa), audio synchronization, and frame-accurate capture for post-processing.

Quick Start

Use the touchdesigner-mcp skill to create an audio-reactive GLSL fractal that visualizes bass and treble frequencies from a music file in real time.

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 programmatically for real-time visuals?

You can control TouchDesigner programmatically through the twozero MCP protocol, which allows AI agents to create operators, set parameters, wire connections, and execute Python scripts without manual GUI interaction.

Can I automate audio-reactive generative art and GLSL shader pipelines in TouchDesigner?

Yes, automating audio-reactive generative art and GLSL shader pipelines is possible by leveraging the 36 native MCP tools to build and modify real-time visual systems with deterministic parameter discovery.

Do I need the twozero.tox plugin to use MCP for TouchDesigner?

Yes, you need the twozero.tox plugin installed in your TouchDesigner instance with MCP enabled on localhost port 40404 to establish programmatic control over the visual environment.

What's the best way to record projection mapping outputs from TouchDesigner without manual clicking?

The best way to record projection mapping outputs without manual clicking is using the MCP protocol's production recording tools, which handle ProRes and mjpa codecs, audio synchronization, and frame-accurate capture.

Why does programmatic TouchDesigner development require version-aware parameter discovery?

Programmatic TouchDesigner development requires version-aware parameter discovery because the MCP tools need deterministic access to operator parameters to accurately build, modify, and wire real-time visual systems across different software versions.