Touchdesigner MCP by 8beeeaaat is a Model Context Protocol (MCP) server designed to connect AI models with TouchDesigner. Built with TypeScript, this tool enables AI agents to interact with TouchDesigner projects, offering programmatic control over node networks and project elements. It supports an HTTP Transport Mode, making it accessible to various AI clients such as Claude Code, ChatGPT, and Claude Desktop. The server acts as a crucial bridge, allowing AI assistants to build, modify, and query TouchDesigner environments using plain language descriptions. Its distribution methods include a Git repository, an NPM package, an MCP bundle, and a Docker container.

What does Touchdesigner MCP connect to?

Touchdesigner MCP serves as an implementation of a Model Context Protocol (MCP) server specifically for TouchDesigner. Its primary function is to establish a connection between AI models and the TouchDesigner WebServer DAT. This server acts as a vital bridge, enabling AI agents and coding assistants to interact directly with TouchDesigner projects. It falls under the category of an MCP server, facilitating advanced programmatic control and data exchange with the visual development platform, allowing AI to manipulate the creative environment.

Core features and tools

Touchdesigner MCP exposes a set of callable tools for interacting with TouchDesigner. These include create_td_node, delete_td_node, update_td_node_parameters, and exec_node_method for direct manipulation of nodes. Users can query project details with get_td_nodes, get_td_node_parameters, get_td_info, get_td_class_details, and get_td_module_help. The server also allows executing Python scripts via execute_python_script and retrieving visual output with get_top_image. These tools collectively provide extensive control over TouchDesigner environments and their elements.

Who is it for?

Touchdesigner MCP is intended for AI agents, AI coding assistants, artists, musicians, and developers who seek to programmatically control TouchDesigner. It empowers these users to automate tasks, generate content, and manage complex node networks through AI interaction, enhancing creative workflows. The tool is particularly useful for those integrating AI capabilities into their visual programming environments, enabling new forms of artistic expression and development. This is not the right fit if you require an explicit, documented authentication model for server access.

How to get started

No credentials are required. Setup involves configuring environment variables like TD_WEB_SERVER_HOST and TD_WEB_SERVER_PORT for the HTTP Transport Mode.

Use cases

• Automating the creation, modification, and deletion of nodes within TouchDesigner projects, allowing for dynamic network adjustments and rapid prototyping.
• Executing custom Python scripts to programmatically control TouchDesigner, enabling advanced operations and complex logic integration for artists and developers.
• Empowering AI assistants to build, verify, and preview TouchDesigner node networks directly from plain language descriptions, accelerating creative workflows.

Touchdesigner MCP offers a powerful bridge for AI models to interact with TouchDesigner, expanding creative and developmental possibilities. Its diverse set of callable tools allows for detailed control over node networks and project elements, supporting automation and AI-driven content generation. The server's compatibility with multiple AI clients makes it a versatile addition to many workflows.