aseprite-live-mcp
Unity-first MCP server for the live Aseprite editor (and headless batch): an AI agent draws in your running editor, one named undo per edit, with Unity .meta sprite export (named slices carry pivots), a project-convention art-QA sweep, isometric drawing primitives, and MCP resources + guided-workflo…
Install / Use
claude mcp add oaktreegames -- npx -y github:oaktreegames/aseprite-live-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
OtherSupported Platforms
Our assessment of aseprite-live-mcp
aseprite-live-mcp scores 80/100 on our quality scale, 288th of 329 Other skills we index.
Its MCP Server is 33 KB long, well organised into 18 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 95/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
aseprite-live-mcp compared with similar skills
All 4 of these similar skills score higher than aseprite-live-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| aseprite-live-mcp (this skill)by oaktreegames | 80 | 10 | 4mo ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | today | CLAUDE.md |
Frequently asked questions
- How do I install aseprite-live-mcp?
- Run
claude mcp add oaktreegames -- npx -y github:oaktreegames/aseprite-live-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does aseprite-live-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is aseprite-live-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 95/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is aseprite-live-mcp still maintained?
- The repository was last updated about 4 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
Skill content
View source on GitHubaseprite-live-mcp
Let an AI agent draw in your live Aseprite editor — every edit one named undo — with a Unity-first, game-dev toolset.
An open-source Model Context Protocol server for
Aseprite. It drives your running editor (all open
documents, unsaved tabs, in-editor dialogs, even asking you to click a point on
the canvas) and runs headless (aseprite --batch) against files on disk.
One-action Unity sprite-sheet + .meta export with per-slice pivots, a
project-convention art-QA sweep, isometric primitives, tilemaps, and a
server that tells you when it's out of date.
See it in action
Each of these is an AI agent driving a live Aseprite canvas through the MCP — one named undo per step.
<table> <tr> <td align="center"><img src="docs/demo.gif" width="240" alt="Isometric machine build"><br><sub><b>Isometric primitives</b><br>iso box → recessed port → tank → outline</sub></td> <td align="center"><img src="docs/demo-drawing.gif" width="240" alt="Drawing suite"><br><sub><b>Drawing suite</b><br>rect · dithered gradient · ellipse · circle · dither · outline</sub></td> <td align="center"><img src="docs/demo-shading.gif" width="240" alt="Palette ramp-walk shading"><br><sub><b>Ramp-walk shading</b><br>flat fill → volumetric, along a hand-ordered palette</sub></td> </tr> <tr> <td align="center"><img src="docs/demo-tilemap.gif" width="240" alt="Tilemap editing"><br><sub><b>Tilemaps</b><br>tileset drawn tile by tile → map laid out row by row</sub></td> <td align="center"><img src="docs/demo-stamp.gif" width="240" alt="Stamp painting"><br><sub><b>Stamp painting</b><br>one flower drawn once → scattered along an arc, one undo</sub></td> <td align="center"><img src="docs/bridge-panel.png" width="240" alt="The Claude Bridge panel in Aseprite"><br><sub><b>The bridge panel</b><br>live status, activity log, a Pause toggle — in Aseprite</sub></td> </tr> </table>And the part no headless server can do — the agent asking you, inside your editor (a real screen capture, not a mockup):
<p align="center"><img src="docs/dialog-in-editor.png" width="560" alt="An MCP-driven approval dialog inside Aseprite"></p>A full set, one live session
Everything below came out of a single session against one running editor: five
sprites built, QA'd, assembled into a sheet, sliced, and exported for Unity —
finished with an in-editor approval dialog. The .aseprite sources are in
examples/showcase/; open them and Ctrl-Z backwards
through the build.
The QA tools aren't decoration. During this build, frame_diff's change bbox
caught a motion tween the eye missed — every cel displaced by its image origin
and clipping at the canvas edge. One transaction fixed it; the same diff
re-verified it:
The sheet's ten slices went to Unity in one action —
examples/showcase/unity/ has the atlas PNG and its
generated .meta: ten Multiple-mode sprites, rects y-flipped, every pivot baked.
Install
One command, no clone:
uvx aseprite-live-mcp # or: pipx run aseprite-live-mcp
Requires Python 3.10+ and Aseprite 1.3+. That's it for headless; the live editor needs one extra step (below).
<details> <summary><b>Claude Code</b></summary>claude mcp add aseprite-live -- uvx aseprite-live-mcp
</details>
<details>
<summary><b>Claude Desktop / any JSON-config client</b></summary>
{
"mcpServers": {
"aseprite-live": {
"command": "uvx",
"args": ["aseprite-live-mcp"],
"env": {
"ASEPRITE_MCP_BACKEND": "headless", // or "live" — see below
"ASEPRITE_PATH": "C:/Program Files/Aseprite/Aseprite.exe"
}
}
}
}
ASEPRITE_PATH is auto-detected on common installs (Steam and standalone) if you
omit it.
git clone https://github.com/oaktreegames/aseprite-live-mcp
cd aseprite-live-mcp
pip install -e .
</details>
Quickstart — headless (2 minutes, no editor open)
Add the server with "ASEPRITE_MCP_BACKEND": "headless" (above). In headless
mode, tools take a file argument — the .aseprite to act on. Ask your agent to
run status to confirm the connection, then try:
"Create a 32×32 sprite at C:/art/coin.aseprite, draw a gold circle, and export it as coin.png."
Quickstart — live editor (drive your open canvas)
The live backend edits your running Aseprite, one undo step per edit. The
bridge script and relay live in this repo (they're not in the pip package), so
grab them first: git clone https://github.com/oaktreegames/aseprite-live-mcp
— or download just claude-bridge.lua and
relay_server.py.
- Install the bridge script into Aseprite — in Aseprite,
File → Scripts → Open Scripts Folder, copyaseprite_client/claude-bridge.luainto it, and restart Aseprite (orFile → Scripts → Rescan Scripts Folder). - Start the relay:
python bridge/relay_server.py(needspip install websockets). - Connect: in Aseprite,
File → Scripts → claude-bridge, and grant the script trust when asked. The panel shows "connected to Claude", live activity, and a Pause toggle. - Switch the backend to
livein your MCP config ("ASEPRITE_MCP_BACKEND": "live").
Now tools act on your active document; watch edits appear and press Ctrl-Z to undo
each one. See docs/ARCHITECTURE.md for how it works.
What you can ask it to do
- "Make a 32×32 sprite, draw a red circle, and export it as icon.png."
- "Export machines.aseprite as a Unity sprite sheet at 16 pixels-per-unit." → drops a sheet + a pre-sliced
.metastraight into your Unity project. - "Slice this atlas, set each slice's pivot, and export it to Unity with the pivots baked in."
- "Run a QA sweep: it must be 64×64, ≤ 16 colors, grid-aligned, with 2px of sticker padding."
- "Draw an isometric box for a 1×1 machine base and put a recessed port on its front face."
- "Set up a 16×16 tilemap layer, draw grass and dirt tiles, and lay out a 10×6 ground strip."
- "Assemble my exports into one labeled sheet, slice each piece, set the pivots, and hand Unity the atlas."
- "Pop a dialog in my editor: approve or redo. Then wait for me to click the anchor point."
- "Watch the sprite while I touch it up; when I stop, re-run the QA sweep."
- "Diff frames 3 and 4 — did the arm actually move?"
Where this sits (honest positioning)
There are already good Aseprite MCP servers. This project is not the first, and doesn't claim to be. What it claims — and can defend:
| Capability | Landscape | This project |
|---|---|---|
| Draw / layers / frames / palette / selection / export, dithering, gradients, outlines, filters, tweens, tilemaps | Well covered by the headless leaders (diivi ~113 tools, pixel-mcp, ext-sakamoro) and the commercial live server (Aseprite MCP Pro, Godot-first) | Parity — a curated, fully typed surface |
| One-action Unity export — sheet + .meta with per-slice pivots baked in | Every other Aseprite→Unity path we found is a separate engine-side importer; none export pivots | Differentiator ✅ |
| Art-QA sweep incl. transparent sticker-padding measurement against your project conventions | We found no other server that lints sprite margins/padding as a packaged sweep | Differentiator ✅ |
| Isometric drawing primitives (2:1 boxes/cylinders, auto face-shading, recessed panels) | The only iso primitives we've found in any Aseprite MCP we surveyed | Differentiator ✅ |
| In-editor interaction: dialogs in Aseprite, ask-the-artist point picking, artist-edit watching, symmetry & viewport control | Live-GUI servers exist (Pro commercial; two nascent OSS); none we surveyed ship in-editor dialogs or human-in-the-loop tools | Differentiator ✅ |
| Update awareness — the server itself tells you when a newer release exists | As far as we could find (checked 2026-07-16), no other MCP server surfaces its own update status through the session | Differentiator ✅ |
| Live tilemap editing | The headless leaders edit tilemaps on disk; the only live tilemap editing we found is closed-source | Open-source position ✅ |
| MCP resources + prompts | Across the open-source Aseprite MCPs we surveyed, this is the richest MCP-native surface (live-state resources + guided-workflow prompts) | Differentiator (hedged) |
Every edit made through the server is exactly one named undo step
(app.transaction) — you can watch an agent work and Ctrl-Z anything it did,
one step at a time. We verified the other open-source live bridges don't hold
that discipline across their surface (one wraps 3 of 57 tools).
Knowing when to update
The status tool reports the server's version and — at most once a day, via
PyPI — whether a newer release exists. Your agent sees it, so you see it:
{ "backend": "live", "connected": true,
"server": { "current": "0.2.0", "latest": "0.2.1", "update_available": true,
"how": "pip install -U aseprite-live-mcp (uvx users: run uvx aseprite-live-mcp@latest once — uvx reuses its cached version otherwise)" } }
Also surfaced as the aseprite://update resource, one stderr log line, and the
real version in the MCP serverInfo handshake. Disable with
ASEPRITE_MCP_NO_UPDATE_CHECK=1 (auto-disabled in CI). No telemetry — the check
is an HTTP GET of PyPI's public JSON; nothi
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
