SkillFoxx

tdmcp

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

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

Broad access

Why this level

  • The bridge executes arbitrary Python in the TouchDesigner process and is open on all interfaces
  • The agent can create, change and delete nodes in a live project
All reasons and checks

pantani/tdmcpAuthor:Pantani

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/tdmcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The bridge executes arbitrary Python in the TouchDesigner process and is open on all interfaces
  • The agent can create, change and delete nodes in a live project

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

What it does

tdmcp is an MCP server for TouchDesigner. You describe a visual in words and Claude, Cursor or Codex create real nodes in the project, wire them up, check them for errors and show a preview. It rests on a built-in reference of 629 operators and 68 Python classes, workflow patterns and GLSL techniques. A small bridge runs inside TouchDesigner and creates, connects and inspects nodes. The README counts 509 tools on three levels, from generators such as `create_feedback_network` to operations on single nodes. Networks are arranged left to right. Claude Desktop gets a `.mcpb` extension, and the npm package is `@dpantani/tdmcp`.

Who it is for. Visual artists, VJs and musicians who work in TouchDesigner and want to build node networks in dialogue with an AI.

Good fit when

  • Describe a feedback tunnel from noise with blur and displace and get ready nodes in `/project1`
  • Get a control panel with parameters you can tweak or map to a controller
  • Build external I/O over OSC, MIDI, DMX or NDI
  • Find and fix an error in someone else's network with the agent's help

Not a fit when

  • The project is not in TouchDesigner
  • The bridge cannot be exposed on a network you do not trust
  • You need guaranteed frames with no edits to a finished live project

Example request

Create a feedback tunnel from noise with blur and displace, add bloom and output it to a window

MCP

Transport
stdio
Authentication
not required

Environment variables

TDMCP_BRIDGE_TOKEN secret
Token protecting the bridge inside TouchDesigner
TDMCP_TOOL_PROFILE
Tool profile: full, safe or directory

Limitations

TouchDesigner is required, the free non-commercial edition is enough, along with one client: Claude Desktop, Claude Code, Codex or Cursor. The bridge listens on port 9980 on all interfaces and runs arbitrary Python inside the TouchDesigner process, so enable it only on a trusted network. For protection set `TDMCP_BRIDGE_TOKEN` and, if needed, disable execution with `TDMCP_BRIDGE_ALLOW_EXEC=0`. The tool profile is chosen with `TDMCP_TOOL_PROFILE`, where `safe` hides destructive tools.

How to disable. Switch off the bridge in TouchDesigner and remove the server entry from the client configuration or delete the `tdmcp.mcpb` extension in Claude Desktop.

FAQ

How do I connect tdmcp to Claude Desktop?

Download `tdmcp.mcpb` from the latest release and open it, with no Node.js needed. Then switch on the bridge inside TouchDesigner following the documentation site.

Which package do I use for Cursor or Codex?

Use the npm package `@dpantani/tdmcp` as the command `npx -y @dpantani/tdmcp` in the MCP configuration. The transport is stdio.

What is risky about the bridge?

It runs Python inside TouchDesigner and listens on port 9980 on all interfaces. Enable the `TDMCP_BRIDGE_TOKEN` token and disable execution with `TDMCP_BRIDGE_ALLOW_EXEC=0` on an untrusted network.

What is the directory profile?

It is a compact build-and-inspect set used by directory scanners. The `full` profile enables everything and `safe` hides destructive and raw-code tools.

Is there a creative search over artworks?

Yes, an optional local search over openly licensed works. It is off by default, enabled with `TDMCP_RAG_ENABLED=1` and needs a local Ollama.

Discussion

No questions or reviews yet.

MCP servers

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

MCP serverExtended access629

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

MCP server and panel let an agent read an Adobe After Effects comp and build animation as ordinary editable layers and keyframes.

MCP serverBroad access52

An Ableton Live MCP server: 156 tools let Claude, Cursor or Codex write MIDI, load instruments and effects and mix a track.

MCP serverExtended access77

An Autodesk Maya MCP adapter: an agent inspects the scene, builds geometry and edits materials and animation through typed tools.

MCP serverBroad access67

README in short

The README explains how three parts (the AI client, the tdmcp server and the bridge inside TouchDesigner) work together. It goes on to installation for Claude Desktop and other clients, an overview of tools and a security section on the bridge.

README badge

Report a problem