Log inSubmit server
Touchdesigner MCP Server logo

Touchdesigner MCP Server

Control TouchDesigner projects through MCP by inspecting, scripting, editing, and previewing nodes from an AI client.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Touchdesigner MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "touchdesigner-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

The touchdesigner-mcp-server MCP server connects AI agents to TouchDesigner through its WebServer DAT. It can inspect project structure, read node parameters and diagnostics, create or modify nodes, run Python, and capture TOP output images. Reach for it when an agent needs to build, troubleshoot, or operate TouchDesigner projects rather than only provide code suggestions. The server also exposes TouchDesigner class information and module help for script-assisted workflows.

Use cases

  • Inspect TouchDesigner node trees and parameters
  • Create and reconfigure nodes from an AI agent
  • Run Python automation inside TouchDesigner
  • Diagnose operator warnings and errors
  • Preview TOP output as an image

Key features

  • TouchDesigner WebServer DAT connectivity
  • Node creation, editing, deletion, and method calls
  • Python script execution with selectable output formats
  • Node inspection with detail levels and result limits
  • TouchDesigner class and module help lookup
  • TOP image capture

Tools14

What Touchdesigner MCP Server lets your agent do. Expand a tool for its parameters.

Verified live~2.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

15/17 checks healthy over the last 90d

What it can do

From the 14 tools this server returned when we ran it.

Runs commands · 2Can delete or modify data · 1Handles credentials · 1Read-only tools · 11
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age544 days
Maintainers1

Observed 2026-10-24 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · touchdesigner-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars622Stargazers on the source repository.
npm downloads7.1kPackage downloads in the last 30 days.
Last commit8d agoMost recent push to the default branch.
Tools exposed14Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Touchdesigner MCP Server works

What touchdesigner-mcp-server does

touchdesigner-mcp-server provides an MCP interface for operating TouchDesigner projects. Through the connection, an AI client can inspect the TouchDesigner environment and project tree, read node parameters, change parameters, create nodes, remove nodes, and call methods on individual nodes.

Python automation is a central part of the interface. Agents can run scripts inside TouchDesigner and consult the available TouchDesigner Python classes, class or module details, and built-in help() text. The server can also capture the current output of a TOP node as an image, making visual inspection available to clients that can display tool results.

How it works

The server communicates with a TouchDesigner WebServer DAT. A TouchDesigner project must include the supplied mcp_webserver_base component, and the component and MCP server must be able to reach each other over the configured host and port. The default port is 9981; connection failures include guidance for starting TouchDesigner, checking the WebServer DAT, and correcting the host or port.

Responses from several inspection tools support detail levels, result limits, or compact formats to control how much project information is returned. Python execution supports minimal, summary, or detailed reporting and can return JSON, YAML, or Markdown.

Setup and configuration

Installation starts by setting up the repository or npm package with the AI application you already use, followed by the TouchDesigner setup described by the project. The TouchDesigner component is distributed separately as touchdesigner-mcp-td.zip. After extracting it, import its .tox component into the project and run the WebServer DAT.

The npm package version and the TouchDesigner component API version are checked independently. Components older than the supported API level can stop execution, while some older or newer compatible API versions continue with a warning. The documented minimum API version is 1.3.0. When resolving a compatibility error, replace the existing component folder and imported mcp_webserver_base, then restart TouchDesigner and the MCP client.

Tools and capabilities

  • Inspect server information with get_td_info.
  • Browse nodes with get_td_nodes, including limited and token-conscious output.
  • Read parameters with get_td_node_parameters and diagnose operator errors and warnings with get_td_node_errors.
  • Create, update, delete, and invoke methods on nodes using create_td_node, update_td_node_parameters, delete_td_node, and exec_node_method.
  • Run arbitrary TouchDesigner Python with selectable response detail and format through execute_python_script.
  • Explore Python APIs with get_td_classes, get_td_class_details, and get_td_module_help.
  • Capture a TOP output using get_top_image, optionally downscaled by its longer side.
  • Generate a filesystem-oriented tool manifest with describe_td_tools.

The accompanying prompts cover fuzzy node search, node connections, and recursive checks for node errors and warnings.

Limitations and notes

get_td_node_errors reads operator error and warning streams. It can identify issues such as missing files, dangling operator references, and shader compilation failures, but an empty result does not prove that a node cooked successfully. Exceptions raised inside callbacks, such as a Script OP callback or scriptCHOP onCook, are not reported through those streams.

Connection checks cache failures for 60 seconds before retrying. A refused connection, timeout, or invalid hostname must be fixed in TouchDesigner, the network configuration, or the server settings before tool calls can proceed. Resources are not implemented.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Touchdesigner MCP Server

touchdesigner-mcp-server is an MCP server that connects AI agents to TouchDesigner through its WebServer DAT. Its main tools inspect nodes, parameters, classes, and diagnostics; execute Python; create, update, delete, and operate nodes; and capture TOP output images for visual review.

Install it through the AI application you use, then configure the TouchDesigner component from the project’s `touchdesigner-mcp-td.zip` release. Import the included `.tox` component, run the WebServer DAT, and restart the MCP client after setup.

Connect it through a running TouchDesigner WebServer DAT with the `mcp_webserver_base` component imported into the project. The default port is `9981`; use `127.0.0.1` unless the host was intentionally changed, and verify that TouchDesigner and the DAT are running.

Yes, the project documents Claude Desktop as an example MCP client. Configure the server for Claude Desktop, start the TouchDesigner WebServer DAT, and ensure the component API version is compatible before invoking tools.

The error tool reads operator error and warning streams only, so it does not observe exceptions raised inside callbacks such as Script OP code or `scriptCHOP` `onCook`. Missing files, dangling references, and shader failures may appear as warnings rather than errors.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTouchdesigner MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/touchdesigner-mcp-server?style=directory)](https://allmcps.com/mcp/touchdesigner-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/touchdesigner-mcp-server"><img src="https://allmcps.com/api/badge/touchdesigner-mcp-server?style=directory" alt="Touchdesigner MCP Server on AllMCPs" /></a>