@atomcut/mcp
v3.6.0
Published
Drive a running AtomCut editor from Claude Code, Claude Desktop, Cursor or any MCP client — every editor verb as a tool, renders as images, the AtomCut skill as resources.
Maintainers
Readme
@atomcut/mcp
Let Claude Code, Claude Desktop, Cursor — any MCP client — drive a running AtomCut editor: design, animate, edit video, generate media, all live on your canvas.
| Your agent app | Add AtomCut |
|---|---|
| Claude Code | claude mcp add -s user atomcut -- npx -y @atomcut/mcp@latest |
| Codex | codex mcp add atomcut -- npx -y @atomcut/mcp@latest |
| Gemini CLI | gemini mcp add -s user atomcut npx -y @atomcut/mcp@latest |
| VS Code | code --add-mcp '{"name":"atomcut","command":"npx","args":["-y","@atomcut/mcp@latest"]}' |
| Cursor · Claude Desktop · anything else | a stdio server: command npx, args ["-y", "@atomcut/mcp@latest"] |
Then in AtomCut: Agents ▸ Use your agent app ▸ Link. That's it — the tab stays linked and reconnects whenever your agent starts a session. Ask for anything: "cut the pauses out of this interview and caption it".
Run as many sessions as you like: they share the one link, each request lands as its own undo step, and closing a session never disconnects the others.
It works with whatever model your agent app runs — MCP is between the app and AtomCut, not the model.
What your agent gets:
- Every editor verb as a tool — the same ~100 commands AtomCut's own agent uses (create and style layers, keyframes, effects, grading, timeline edits, captions, 3D worlds, character rigs and switches, physics bodies / fields / joints, AI media jobs), with live JSON schemas.
- Eyes —
view_render/view_framesreturn real renders as images, so it checks its own work. - The AtomCut skill as resources (
atomcut://skill/SKILL.mdand references) — how to work well in the app, plus the default design system. - Safety — the bridge listens on
127.0.0.1only and trusts only AtomCut's own origins (app.atomcut.net, the desktop app,localhost); a tab served from anywhere else must present the pairing token printed on start (also in~/.atomcut-mcp; extra origins viaATOMCUT_MCP_ORIGINS); every change is labelled with your agent's name in AtomCut's Undo menu, one step per request.
MIT licensed.
