touchdesigner-mcp

Control TouchDesigner via twozero MCP to create operators, set parameters, and execute Python code.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires twozero-mcp, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill enables you to control TouchDesigner via twozero MCP, allowing for real-time visuals, operator manipulation, and Python scripting, thereby streamlining the creation and editing of TouchDesigner projects.

Core Features & Use Cases

  • Real-time Visuals: Build and manipulate real-time visuals in TouchDesigner.
  • Operator Manipulation: Create, set parameters, wire connections, and execute Python code for operators.
  • Use Case: Imagine you are working on a live performance with TouchDesigner and need to dynamically change visual parameters and operator configurations based on audience reaction or other inputs.
  • Quick Start: Use the touchdesigner-mcp skill to set the brightness of the 'brightness' operator in your TouchDesigner project to 70.
td_set_operator_pars(path="/project1/brightness", parameters={"brightness": 70})

Quick Start

Use the touchdesigner-mcp skill to set the brightness of the 'brightness' operator in your TouchDesigner project to 70.

td_set_operator_pars(path="/project1/brightness", parameters={"brightness": 70})

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 visual parameter manipulation in TouchDesigner?

You can automate real-time visual parameter manipulation in TouchDesigner using the touchdesigner-mcp skill to set operator parameters dynamically via Python scripting. It allows you to target specific operator paths and update parameter values programmatically during live performances or interactive installations.

Can I create and wire TouchDesigner operators using Python code?

Yes, you can create and wire TouchDesigner operators using Python code through the touchdesigner-mcp skill. It supports creating operators, setting parameters, and wiring connections to streamline the creation and editing of TouchDesigner projects programmatically.

Do I need a specific server running to control TouchDesigner via MCP?

Yes, controlling TouchDesigner via MCP requires the twozero MCP server to be running. Additionally, the touchdesigner-mcp skill must be configured with the correct TouchDesigner instance and operator parameters to establish proper communication.

What is the best way to control TouchDesigner for live performance visualization?

The best way to control TouchDesigner for live performance visualization is using MCP integration to execute Python code and manipulate operators in real-time. This approach enables dynamic visual parameter adjustments based on external inputs like audience reactions without manual interface interaction.

How does MCP integration work with TouchDesigner for interactive installations?

MCP integration works with TouchDesigner by bridging external inputs to internal operator parameters through Python scripting. For interactive installations, this mechanism allows real-time parameter manipulation and automated operator configuration, enabling responsive visual outputs driven by dynamic data sources.

Are there limitations when executing Python code to manipulate operators in TouchDesigner?

When executing Python code to manipulate operators in TouchDesigner, the primary limitation is the dependency on the twozero MCP server configuration. The skill requires a correctly configured TouchDesigner instance and accurate operator path references to successfully execute parameter updates and wiring commands.