# TouchDesigner Atlas

> TouchDesigner Atlas is an open-source MCP server for design and media. Lets AI agents read, edit and debug TouchDesigner projects using your install's names. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, CLI
- **Website:** https://grigabyte.github.io/td-atlas/
- **Repository:** https://github.com/grigabyte/td-atlas
- **MCP Registry name:** io.github.grigabyte/td-atlas
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add td-atlas -- npx -y https://github.com/grigabyte/td-atlas/releases/download/v0.3.0/td-atlas-0.3.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/touchdesigner-atlas
