Skip to content
MCP server

TouchDesigner Atlas

Lets AI agents read, edit and debug TouchDesigner projects using your install's names

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory