Skip to content
Back to search

TDMCP

MCP server for controlling TouchDesigner from AI coding agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/TouchDesigner/TDMCP with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/TouchDesigner/TDMCP'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/touchdesigner--tdmcp/badge.svg)](/listings/touchdesigner--tdmcp)

HTML

<a href="/listings/touchdesigner--tdmcp"><img src="/api/listings/touchdesigner--tdmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Add the component

1. Download `TDMCP.tox` from [Releases](https://github.com/TouchDesigner/TDMCP/releases). 2. Drag it into the root of your TouchDesigner project. 3. Turn on **Active** on the MCP page.

2. Connect your agent

Two things happen here: registering the server, so the agent gets the tools, and installing the skills, so it knows how TouchDesigner expects things to be done. Both live on the component's **MCP** page.

1. Pick your client in **Install For**. Defaults to Claude Code. 2. Pick an **Install Scope**. The menu rebuilds per client and offers only the scopes that client supports. 3. Copy **Add MCP** and run it in your project directory. 4. Pulse **Install Skills**.

For Claude Code that gives you:

claude mcp add --transport http --scope local touchdesigner http://127.0.0.1:13316/mcp

**Add MCP** and **Remove MCP** are generated, not typed. They rebuild from your live **Port**, **Server Name**, **Use HTTPS** and **Ask for authentication** settings, so the command always matches the server you are actually running.

3. Check it worked

claude mcp list
# touchdesigner: http://127.0.0.1:13316/mcp (HTTP) - ✔ Connected

Then ask your agent:

> What TouchDesigner project am I connected to?

A correct answer means the whole chain works: the server is running, the client found it, and a tool call round-tripped. If it does not, see [Troubleshooting](#troubleshooting).

Now try something real:

> Create a noise TOP, blur it, and end the chain in a null.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 178 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ![TDMCP, an MCP server that runs inside TouchDesigner](docs/media/banner.png)
  2. > ### Beta
  3. >
  4. > TDMCP is in public beta. The component works and is in daily use, but the
  5. > interface may still change. Found a bug, or want to ask something? Start a
  6. > [discussion](https://github.com/TouchDesigner/TDMCP/discussions) or open an
  7. > [issue](https://github.com/TouchDesigner/TDMCP/issues). Please include your
  8. > TouchDesigner build (**Help → About TouchDesigner**) and the TDMCP
  9. > **Version** from the component's About page.
  10. >
  11. > What is tested, what is not, and what we want to hear about:
  12. > [Beta status](docs/beta.md).
  13. ## What it is
  14. TDMCP is an MCP server that runs inside TouchDesigner. Drop one component into
  15. your project and your AI agent can build and edit networks with you: create
  16. operators, wire them, set parameters, write DAT and GLSL code, read errors and
  17. cook times, look up the TouchDesigner docs, and capture what an operator
  18. outputs. Everything it does lands in TouchDesigner's undo stack, so Ctrl+Z
  19. reverses it.
  20. It is built for coding agents, Claude Code, Codex, Cursor, Antigravity and
  21. OpenCode, and works with any client that speaks streamable-HTTP MCP. Claude
  22. Desktop connects through a plugin: see [Claude Desktop](docs/claude-desktop.md).
  23. ## Start here
  24. TDMCP lets an **AI agent** work inside your TouchDesigner project. You type
  25. what you want, such as "make me an airplane with a script POP" or "why is
  26. the render TOP black?", and the agent creates the operators, wires them and
  27. sets the parameters, or helps diagnose the issue, while you watch it happen
  28. in the network editor.
  29. You run an agent in one of two ways.
  30. - **In a terminal.** A terminal is the text window where you type commands:
  31. Terminal on macOS, PowerShell on Windows. An agent that runs there is called
  32. an agent CLI. You install it, open a terminal in your project folder, start
  33. it by typing its command, and talk to it there. The steps below are for
  34. these:
  35. | Agent | From | Command |
  36. |---|---|---|
  37. | **Claude Code** | Anthropic | `claude` |
  38. | Codex | OpenAI | `codex` |
  39. | Antigravity | Google | `agy` |
  40. | OpenCode | open source | `opencode` |
  41. Cursor, an editor with an agent built in, works too.
  42. - **In an app.** **Claude Desktop** is the Claude app, with a window like any
  43. other program and no terminal. It connects through a plugin, with its own
  44. steps: [Claude Desktop](docs/claude-desktop.md). The plugin needs
  45. [Node.js](https://nodejs.org) installed.
  46. Claude Code and Claude Desktop are the same Claude, from Anthropic. Claude
  47. Code lives in the terminal; Claude Desktop is the app. Never used a terminal?
  48. Start with Claude Desktop.
  49. Requires **TouchDesigner 2025.33230 or newer**, and for the steps below, an
  50. agent CLI that is already installed.
  51. 1. Download `TDMCP.tox` from [Releases](https://github.com/TouchDesigner/TDMCP/releases)
  52. and drag it into your project.
  53. 2. Turn on **Active** on the component's MCP page.
  54. 3. On the same page, pick your agent under **Install For**. Leave **Install
  55. Scope** on **Local**.
  56. 4. **Add MCP**, below it, holds the command for that agent. Click in the
  57. field, select the whole string and copy it.
  58. 5. Open a terminal in your project folder, paste the command and press Enter.
  59. The next session you start there has TouchDesigner's tools.
  60. 6. Back on the component, pulse **Install Skills**.
  61. For Claude Code, **Add MCP** gives you:
  62. ```bash
  63. claude mcp add --transport http --scope local touchdesigner http://127.0.0.1:13316/mcp
  64. ```
  65. Already have the TouchDesigner plugin on your claude.ai account? Claude Code
  66. is connected without steps 3 to 6. Don't register again on port 13316, or
  67. every tool is listed twice. More in
  68. [Claude Code and the plugin](docs/claude-desktop.md#claude-code-and-the-plugin).
  69. Then ask your agent:
  70. > What TouchDesigner project am I connected to?
  71. Now try something real:
  72. > Create a noise TOP, blur it, and end the chain in a null.
  73. ## Download
  74. Every release carries the same files.
  75. | File | What it is |
  76. |---|---|
  77. | **TDMCP.tox** | The component. This is the server. |
  78. | **derivative_tdmcp.plugin** | The connection and the skills as one Claude plugin, for Claude Desktop and Claude Code. Other agents do not need it: they register the server with **Add MCP** and get the skills from **Install Skills**. |
  79. | **TDMCP.json** | The version and checksum of the `.tox`, which the About page's **Update** button verifies. Nothing to do with it by hand. |
  80. ## What you can do
  81. | | |
  82. |---|---|
  83. | **Build** | Create and wire operators, set parameters, add custom parameters, write DATs and shaders, lay out and annotate the network. One call can build a whole chain. |
  84. | **Inspect** | Read CHOP channels, TOP pixels, geometry and DAT content. Capture any operator as an image. Trace errors and cook times. |
  85. | **Learn** | The agent reads TouchDesigner's own documentation through `get_docs`, and looks up parameter names and menu values before it sets them. |
  86. | **Watch** | The network editor pans to whatever the agent is touching and flashes it: amber for edits, blue for inspections, violet for views. |
  87. | **Undo** | Every change the agent makes is an undo step. There is an option to ask first before deleting an operator. |
  88. 26 tools in all. The full list, with what each one does, is in the
  89. [component reference](docs/component.md#tools).
  90. ## Skills
  91. Skills teach the agent how TouchDesigner works: one guide per operator
  92. family, the conventions for network layout and performance, and a workflow for
  93. planning, reviewing and cleaning up. Without them, the agent might guess
  94. at parameter names and build networks that don't work.
  95. The skills live in [TDMCPSkills](https://github.com/TouchDesigner/TDMCPSkills).
  96. Claude gets them from the plugin, with no separate skills install. For other agents,
  97. pulse **Install Skills** on the component and it fetches the latest release
  98. and puts it where your client looks. Use one route per client: with the
  99. plugin providing the skills, **Install Skills** installs nothing for Claude,
  100. because a second copy lists every skill twice. The
  101. [component reference](docs/component.md#skills) lists the directory for each
  102. client.
  103. ## Stay in control
  104. The server exposes `execute_code`, which runs Python inside TouchDesigner.
  105. Treat a connection to it as you would a shell on your machine.
  106. - **Authentication is on by default.** The first time a client connects,
  107. TouchDesigner shows a consent panel naming the client that is asking.
  108. Nothing gets control until you allow it there.
  109. - **Localhost only, by default.** Requests from other machines are refused
  110. before anything runs. Opening the server to a network requires HTTPS and
  111. authentication together.
  112. - **Nothing is sent home.** No telemetry, no analytics, no account. The
  113. component only reaches GitHub when you ask it to install skills or update.
  114. <img src="docs/media/consent.png" width="640">
  115. More in [Security and privacy](docs/security.md).
  116. ## Documentation
  117. - [Component reference](docs/component.md): every parameter on the six pages,
  118. the tools, where skills land, and what TDMCP writes to disk
  119. - [Claude Desktop](docs/claude-desktop.md): the plugin, Cowork, the Code tab,
  120. images, and Desktop troubleshooting
  121. - [Advanced setup](docs/setup-advanced.md): other clients, HTTPS, several
  122. clients and instances, OAuth internals
  123. - [Troubleshooting](docs/troubleshooting.md)
  124. - [Beta status](docs/beta.md): what is tested, what is not, known limits
  125. - [OpenCode and local models](docs/opencode.md)
  126. - [Changelog](CHANGELOG.md)
  127. ## License
  128. Shared Use License, see [LICENSE.md](LICENSE.md). Use and modify TDMCP for
  129. your own projects, commercial or not. Do not redistribute TDMCP itself as a
  130. product. Read the licence before shipping anything built on it.
  131. ## Support and feedback
  132. Start a [discussion](https://github.com/TouchDesigner/TDMCP/discussions) or
  133. open an [issue](https://github.com/TouchDesigner/TDMCP/issues). Please include
  134. your TouchDesigner build (**Help → About TouchDesigner**), the TDMCP **Version**
  135. from the component's About page, and what you asked the agent to do.
  136. TDMCP is made by [Derivative](https://derivative.ca), the makers of
  137. TouchDesigner.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.