TouchDesigner Atlas MCP server

English | Русский | 简体中文

td-atlas An atomised index of TouchDesigner, a live bridge into a running instance, and an offline reader for saved projects — exposed to AI agents over MCP. Install · Use it from an agent · Tools · Command line · Troubleshooting · Changelog

td-atlas gives an agent three things. The exact operator and parameter names from this machine. Hands inside a running instance, with one step of undo. And a way to read a saved project without opening it.

What it does

every operator and parameter out of your own copy of the application into one SQLite file. The values in it are the values that copy reports.

• The atom index is the name list. Two passes read

TouchDesigner is running. A script builds it there out of four ordinary nodes: a Web Server DAT, a callbacks DAT, a status panel, and an Execute DAT that fires when you save. You can read it, see its changes in git, and upgrade it in place.

• The bridge lets an agent change your project while

what TouchDesigner itself calls an error, and td_health covers the breakage it stays quiet about.

• What TouchDesigner does not report. errors covers

file on disk, and it outlives the session.

• The call journal writes one line per bridge call to a

and compares a project with TouchDesigner closed, and the original file is left alone.

• Reading projects offline inspects, searches

bridge can put beside the .toe on every save, so a project gets a diffable history in git.

• The network text, written on save is what the

Install

Three things have to be there first.

built from your copy of the application and holds the values that copy reports. There is nothing to download.

• TouchDesigner, already installed. The index is

agent is what calls these tools. td-atlas was built and measured against Claude Code, whose command is the claude mcp add line further down. Any MCP client reaches the same tools.

• Python 3.11 or newer, on the same computer as TouchDesigner.
• An AI agent that speaks MCP. The

Compatibility lists the platforms and what the connector can change in your project.

On macOS, one line from a terminal. The installer is a POSIX shell script, so Windows takes the step-by-step sequence below.

curl -fsSL https://grigabyte.github.io/td-atlas/i | sh

If that address does not answer, the same script comes out of the repository:

curl -fsSL https://raw.githubusercontent.com/grigabyte/td-atlas/main/install.sh | sh

Shortened. The full README is on GitHub.