An atomised index of TouchDesigner plus a live bridge, exposed to AI agents over MCP.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for TouchDesigner Atlas, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
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
Left: an agent builds an audio-reactive scene from an empty project. Right: it works inside a finished one.
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
- The atom index is the name list. Two passes read 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 bridge lets an agent change your project while 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.
- What TouchDesigner does not report.
errorscovers what TouchDesigner itself calls an error, andtd_healthcovers the breakage it stays quiet about. - The call journal writes one line per bridge call to a file on disk, and it outlives the session.
- Reading projects offline inspects, searches and compares a project with TouchDesigner closed, and the original file is left alone.
- The network text, written on save is what the
bridge can put beside the
.toeon every save, so a project gets a diffable history in git.
Install
Three things have to be there first.
- TouchDesigner, already installed. The index is built from your copy of the application and holds the values that copy reports. There is nothing to download.
- Python 3.11 or newer, on the same computer as TouchDesigner.
- An AI agent that speaks MCP. The
agent is what calls these tools. td-atlas was built and measured against
Claude Code, whose
command is the
claude mcp addline further down. Any MCP client reaches the same tools.
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.
If that address does not answer, the same script comes out of the repository:
install.sh finds a Python, clones the repository, makes a
virtualenv beside it, installs the package, builds the index and stages the
bridge. Every command is printed before it runs.
It asks two questions: where to clone, and whether to build the index now.
The default answer to the first is ~/td-atlas. With no terminal to ask, it
takes the default for both.
Two directories end up on disk: the checkout, ~/td-atlas unless you named
another, and ~/.td-atlas. Besides those, uv or pip fills its own package
cache, as it does for any package. No sudo. System directories and your shell
startup files are left alone. Run it again on an existing checkout and it
updates that checkout.
By hand, or on Windows, the same sequence step by step
The block below uses uv, a fast installer
for Python packages. Each line carries a second form in the comment beside it,
and that one runs on the python3 you already have.
There is no package on PyPI. pip install td-atlas and uvx td-atlas will
find nothing. Then, from the checkout:
Commands from here on are written td-atlas for short. Unless the virtualenv
is activated, call it by path. In the checkout that path is
.venv/bin/td-atlas. From anywhere else it is the whole path,
~/td-atlas/.venv/bin/td-atlas for the default directory. On Windows it is
.venv\Scripts\td-atlas. A system Python does not see the package.
td-atlas install prints two things to paste. The curl line ran it for you,
so both are already at the end of what it printed; running it again prints them
again. First, into TouchDesigner's textport (Dialogs → Textport and DATs),
once per project:
The textport answers with [td-atlas] lines. The last one names your
TouchDesigner build and the project the bridge attached to.
Second, a claude mcp add line for your MCP client. See
As an MCP server. To also write that same entry into
DIR/.mcp.json, or merge it into one that is already there, pass
--write-mcp-json DIR.
Once the textport has answered, finish the index.
This pass adds the facts only a running instance knows.
Last, check the install. If you came in halfway, start here.
A finished install answers with every link ok, and one closing line.
The counts come off your own copy of TouchDesigner, so yours will differ.
Every link that is not ok comes with its repair, and a broken one makes the
command exit non-zero. Before the index is built you see
index : FAIL … fix: td-atlas build, and before the bridge is staged,
bridge : warn … fix: td-atlas install.
As an MCP server
Run td-atlas install and paste the claude mcp add … line it prints. That
line names the interpreter by absolute path, so it keeps working from any
working directory, with or without an activated virtualenv. Wiring it in by
hand looks like this:
From here you say what you want in plain language. Here is what the agent calls on it:
| What you say to the agent | What it calls |
|---|---|
| "Which operator displaces an image with noise? Give me the exact parameter names before you build anything." | td_search_operators, then td_operator_schema |
| "Build a noise into a blur into an out TOP in the project I have open, and check nothing is silently dead." | td_build — one undo block — then td_health |
| "It looks like nothing is happening." | td_health, then td_flags on whatever it names |
| "Show me what that looks like right now, and the motion over a second." | td_render, and a contact sheet for the motion |
"What is inside /project1 of myproject.toe? TouchDesigner is closed." | td_project_read — the file is copied to a cache and read there |
| "What did you change since we started?" | td_snapshot before and after, then td_project_diff on the two — components in ~/.td-atlas, never your own file |
| "Undo that." | td_undo — a whole td_build batch is one step |
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about TouchDesigner Atlas
AllMCPs Directory Badge
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 Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/touchdesigner-atlas)HTML Embed
<a href="https://allmcps.com/mcp/touchdesigner-atlas"><img src="https://allmcps.com/api/badge/touchdesigner-atlas?style=directory" alt="TouchDesigner Atlas on AllMCPs" /></a>