8beeeaaat avatar

Touchdesigner Mcp Server

8beeeaaat/touchdesigner-mcp

Bridges Claude to TouchDesigner's WebServer DAT so you can create, modify, and delete nodes through natural language. You get eleven tools covering the full lifecycle: spawn operators, wire connections, update parameters, execute arbitrary Python scripts inside TD, and query node properties or project structure. The prompts handle fuzzy node search and recursive error checking across the node tree. If you're prototyping generative visuals or need an AI to scaffold TouchDesigner networks on the fly, this gives you programmatic control without leaving the chat. Version checking enforces semantic compatibility between the MCP server and the TD component, so mismatched installs fail fast with upgrade instructions.

GitHub stars
362
tools
14
transport
STDIO
last updated
Nov 26, 2025

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

create_td_nodeCreates a new node.

Creates a new node.

No parameter schema in public metadata yet.

delete_td_nodeDeletes an existing node.

Deletes an existing node.

No parameter schema in public metadata yet.

describe_td_toolsGenerates a manifest of the available TouchDesigner tools.

Generates a manifest of the available TouchDesigner tools.

No parameter schema in public metadata yet.

exec_node_methodCalls a Python method on a node.

Calls a Python method on a node.

No parameter schema in public metadata yet.

execute_python_scriptExecutes an arbitrary Python script in TouchDesigner.

Executes an arbitrary Python script in TouchDesigner.

No parameter schema in public metadata yet.

get_td_class_detailsGets details of a TouchDesigner Python class or module.

Gets details of a TouchDesigner Python class or module.

No parameter schema in public metadata yet.

get_td_classesGets a list of TouchDesigner Python classes.

Gets a list of TouchDesigner Python classes.

No parameter schema in public metadata yet.

get_td_infoGets information about the TouchDesigner server environment.

Gets information about the TouchDesigner server environment.

No parameter schema in public metadata yet.

get_td_module_helpGets Python help() documentation for TouchDesigner modules/classes.

Gets Python help() documentation for TouchDesigner modules/classes.

No parameter schema in public metadata yet.

get_td_node_errorsChecks errors and warnings on a node and its descendants. Missing files, dangling references and shader failures are warnings, so no errors does not mean healthy.

Checks errors and warnings on a node and its descendants. Missing files, dangling references and shader failures are warnings, so no errors does not mean healthy.

No parameter schema in public metadata yet.

get_td_node_parametersGets the parameters of a specific node.

Gets the parameters of a specific node.

No parameter schema in public metadata yet.

get_td_nodesGets nodes under a parent path, with optional filtering.

Gets nodes under a parent path, with optional filtering.

No parameter schema in public metadata yet.

get_top_imageCaptures the current output of a TOP node as an image.

Captures the current output of a TOP node as an image.

No parameter schema in public metadata yet.

update_td_node_parametersUpdates the parameters of a specific node.

Updates the parameters of a specific node.

No parameter schema in public metadata yet.

Sponsors

Readme

TouchDesigner MCP

Version Downloads

This is an implementation of an MCP (Model Context Protocol) server for TouchDesigner. Its goal is to enable AI agents to control and operate TouchDesigner projects.

English / 日本語

Overview

demo clip

TouchDesigner MCP acts as a bridge between AI models and the TouchDesigner WebServer DAT, enabling AI agents to:

  • Create, modify, and delete nodes
  • Query node properties and project structure
  • Programmatically control TouchDesigner via Python scripts

Installation

Tell the AI agent you already use:

Set up https://github.com/8beeeaaat/touchdesigner-mcp


View the full README on GitHub

Details

Repository
github.com/8beeeaaat/touchdesigner-mcp
Package
touchdesigner-mcp-server
Transport
STDIO
Registry
MCP registry, active