SkillFoxx

TouchDesigner MCP

An MCP server for TouchDesigner: the agent creates and edits nodes, reads parameters and runs Python scripts inside a project

  • 629 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Runs arbitrary Python scripts in TouchDesigner
  • Creates, edits and deletes nodes in your project
All reasons and checks

8beeeaaat/touchdesigner-mcpAuthor:8beeeaaat

Install

Manual install

claude mcp add -s user touchdesigner -- npx -y touchdesigner-mcp-server@latest

First import the mcp_webserver_base.tox component into the TouchDesigner project.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Runs arbitrary Python scripts in TouchDesigner
  • Creates, edits and deletes nodes in your project

This is third-party code. Review the repository files before installing.

What it does

The server connects an AI agent to TouchDesigner through the WebServer DAT component and lets it control a project live. The agent creates, edits and deletes nodes, reads project structure and parameters, runs arbitrary Python scripts and calls node methods. There are tools to check errors and warnings on a node and its descendants, list and detail TouchDesigner Python classes and capture a TOP node's output as an image. Built-in prompts help search nodes, connect them and check errors. The link runs over WebSocket in real time, with no file polling. The server works with Claude Code, Claude Desktop, Cursor and Codex.

Who it is for. For visual artists and developers on TouchDesigner who want to work on a project through an agent.

Good fit when

  • You want to create and edit nodes in a TouchDesigner project through an agent
  • You want to run a Python script inside a project
  • You want to check errors and warnings across scene nodes

Not a fit when

  • You cannot allow arbitrary Python in the project
  • TouchDesigner is not running and the WebServer DAT component is not connected

Example request

Create a particle node in TouchDesigner and show scene errors

MCP

Transport
stdio, http
Authentication
not required

Limitations

It needs a running TouchDesigner with the mcp_webserver_base.tox component imported, default port 9981. The server and component are matched by API version, and a major-version mismatch stops execution with an update prompt. The execute_python_script tool runs arbitrary Python in the project, so use it deliberately. Installation is via npx or Docker.

How to disable. Remove the touchdesigner entry from the agent's MCP configuration and remove the WebServer component from the TouchDesigner project.

FAQ

What is needed on the TouchDesigner side?

A running TouchDesigner with the mcp_webserver_base.tox component imported and the WebServer DAT enabled, default port 9981.

Why the update prompt?

The server and component have independent API versions; an outdated or too-new component makes the server warn or stop until it is updated.

Discussion

No questions or reviews yet.

MCP servers

tdmcp builds TouchDesigner node networks from a plain-language description, then checks the result and shows a preview

MCP serverBroad access62

Embody and Envoy: an MCP server embedded in TouchDesigner through which an agent builds and debugs live operator networks

MCP serverExtended access219

An MCP server for Ableton Live: the agent creates tracks, places clips and builds arrangements straight in the open project

MCP serverExtended access3.3K

Blender MCP: an agent in Cursor, Cline, Windsurf or Claude Desktop builds and edits 3D scenes in Blender from a description; the server installs with uvx

MCP serverExtended access301

Blender MCP

MCP for Blender

Editors’ pick

An MCP server and Blender addon: the agent creates and edits objects, materials and scenes, pulls assets and runs Python in Blender

MCP serverBroad access34.3K
Official

WaveSpeed MCP server: an agent runs image, video, audio and 3D models, reads each model's input schema and quotes the price first

MCP serverExtended access37

README in short

The README describes TouchDesigner MCP as a server that lets agents control TouchDesigner projects through the WebServer DAT component. It offers tools to create, edit and delete nodes, read parameters and structure, run Python and capture TOP output as an image, plus built-in prompts to search and connect nodes. The link runs over WebSocket in real time. It installs via npx with claude mcp add or codex mcp add, with a Docker option and a recommended plugin. Server and component versions are matched by API. MIT licensed.

README badge

Report a problem