touchdesigner-mcp

Overview

TouchDesigner MCP bridges AI models with TouchDesigner's WebServer DAT, allowing agents to programmatically interact with TouchDesigner projects. It provides comprehensive tools for creating, modifying, and deleting nodes, querying node properties, and executing Python scripts within the TouchDesigner environment. The server implements proper versioning and compatibility checks to ensure stable operation with different TouchDesigner API versions.

Try asking AI

After installing, here are 4 things you can ask your AI assistant:

• create_td_node

  Creates a new node in TouchDesigner

  Try:Create a new null nodeTry:Add a movie player node to the project
• delete_td_node

  Deletes an existing node in TouchDesigner

  Try:Delete the selected nodeTry:Remove the old camera node
• exec_node_method

  Calls a Python method on a TouchDesigner node

  Try:Run the ' cook' method on this nodeTry:Execute the 'reset' method on the SOP solver
• execute_python_script

  Executes an arbitrary Python script in TouchDesigner

  Try:Run a Python script to randomize all parametersTry:Execute a script to save the project
• get_module_help

  Gets Python help documentation for TouchDesigner modules

  Try:Get help for the 'op' moduleTry:Show documentation for the 'td' module
• get_td_class_details

  Gets details of a TouchDesigner Python class or module

  Try:Get details for the 'base COMP classTry:Show information about the 'op' module
• get_td_classes

  Gets a list of TouchDesigner Python classes

  Try:List all available COMP classesTry:Show all SOP node classes
• get_td_info

  Gets information about the TouchDesigner server environment

  Try:Show TouchDesigner version infoTry:Get server connection details
• get_td_node_errors

  Checks for errors on a specified node and its children

  Try:Check for errors on this nodeTry:Show all errors in the project
• get_td_node_parameters

  Gets the parameters of a specific TouchDesigner node

  Try:Show parameters of this null nodeTry:Get all parameters for the movie player
• get_td_nodes

  Gets nodes under a parent path with optional filtering

  Try:List all nodes in the projectTry:Show all SOP nodes in /project1
• update_td_node_parameters

  Updates the parameters of a specific TouchDesigner node

  Try:Change the 'active' parameter to falseTry:Set the 'brightness' to 0.5

Comparable tools

Installation

{
  "mcpServers": {
    "touchdesigner": {
      "command": "npx",
      "args": ["-y", "@8beeeaaat/touchdesigner-mcp-server@latest"]
    }
  }
}

FAQ

What versions of TouchDesigner are compatible?

The MCP server uses semantic versioning with a minimum API version of 1.3.0. Version compatibility is enforced with clear warnings and error messages.

How do I troubleshoot connection errors?

Common issues include connection refused (ensure TouchDesigner is running), timeout (check network connection), or invalid hostname (use 127.0.0.1 unless explicitly changed). The server caches failed connections for 60 seconds.

Compare touchdesigner-mcp with