TouchDesigner Atlas
Lets AI agents read, edit and debug TouchDesigner projects using your install's names
- Pricing
- Open source
- Platforms
- macOS, Windows, CLI
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 1 day ago
About TouchDesigner Atlas
TouchDesigner Atlas is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
td-atlas builds a SQLite index of every operator and parameter from your own copy of TouchDesigner, so an agent works with the exact names and values that installation reports instead of guessing. It runs locally with Python 3.11 or newer on the same machine as TouchDesigner and was built and measured against Claude Code, though any MCP client can use it.
A live bridge, assembled in the open project from four ordinary nodes (a Web Server DAT, a callbacks DAT, a status panel and an Execute DAT that fires on save), lets the agent change settings while the project runs, with one step of undo. A separate health check reports breakage TouchDesigner itself stays quiet about, and a call journal writes one line per bridge call to disk.
Saved projects can also be inspected, searched and compared offline with TouchDesigner closed, leaving the original file untouched, and network text can be written beside the .toe on each save for readable git history.
Install
Run in a terminal
claude mcp add td-atlas -- npx -y https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"td-atlas": {
"command": "npx",
"args": [
"-y",
"https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"td-atlas": {
"command": "npx",
"args": [
"-y",
"https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"td-atlas": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"td-atlas": {
"command": "npx",
"args": [
"-y",
"https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"td-atlas": {
"command": "npx",
"args": [
"-y",
"https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb"
]
}
}
}What it does
- Local atom index
- Reads every operator and parameter from your own TouchDesigner install into one SQLite file.
- Live bridge
- Changes a running project through four ordinary nodes, with one step of undo.
- Health check
- Finds silent breakage that TouchDesigner does not report as an error.
- Call journal
- Records each bridge call as a line in a file that outlives the session.
- Offline project reader
- Inspects, searches and compares saved projects without opening them.
- Diffable network text
- Can write network text beside the .toe on every save for git history.
Good for
- Have an agent find which blocks in a project produce no output
- Let an agent adjust parameters and undo with one step
- Compare two saved projects without launching TouchDesigner
- Keep a readable git history of a TouchDesigner project
Pricing
Open source
Prices change. Check grigabyte.github.io before you buy.
TouchDesigner Atlas FAQ
What do I need installed?
TouchDesigner, Python 3.11 or newer on the same computer, and an MCP-capable agent.
How is it installed?
A one-line shell installer on macOS; Windows uses a step-by-step sequence from the README.
Can I undo what the agent changed?
Yes, the site says one Ctrl+Z puts the edit back.
Which clients work?
Claude Code is what it was built against, and any MCP client reaches the same tools.
Is TouchDesigner Atlas free?
Yes. TouchDesigner Atlas is open source, so you can use and self-host it for free.
How do I add TouchDesigner Atlas to Claude Code?
Run this command in your terminal: claude mcp add td-atlas -- npx -y https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb
What are the best alternatives to TouchDesigner Atlas?
The closest alternatives to TouchDesigner Atlas are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.
Alternatives to TouchDesigner Atlas

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory