aseprite-mcp

MCP.Pizza Chef: diivi

This server drives Aseprite, the pixel-art editor, directly from a conversation. It offers more than a hundred drawing and animation commands: canvas setup, layers, shading ramps, dithering, retro palettes, tweened frames, and tilemaps, plus preview renders so the assistant can look at its own work and fix it before exporting to PNG, GIF, or a sprite sheet. You need Aseprite installed on your own machine along with Python and the uv tool. Nothing needs to be paid for beyond Aseprite itself.

Images/Design

Use This MCP server To

Draw a 32x32 pixel-art character from a short description Animate a four-frame sword swing and export it as a GIF Recolor a sprite into a retro Game Boy palette Add an outline and drop shadow to a title label Export every animation tag as its own sprite sheet Check my own frames side by side before exporting

README

Aseprite MCP Tools

A Python MCP server that gives AI assistants full control over Aseprite for creating pixel art and animated sprites.

104 tools across 17 categories — canvas, drawing, layers, animation, palettes, effects, slices, tilemaps, exports, visual-feedback/analysis tools, and a raw Lua escape hatch. The tool set is designed so an LLM has everything it needs to produce good pixel art, not just primitives: shading ramps with hue shifting, ordered dithering, outlines, retro palette presets with quantization, onion-skin renders, and frame diffing for animation work.

Example: a swordsman, drawn and animated by Claude

Pixel-art swordsman drawn by Claude Fable 5 4-frame sword slash animation by Claude Fable 5
Task 1 — "Draw me a pixel art of a swordsman."
32×32 still, exported at 10×.
Task 2 — "…a sword slash attack sequence, from windup to follow-through."
4-frame animation, exported with export_tag.
Slash sequence spritesheet: windup, extension, swing, follow-through
The same slash as a spritesheet (export_spritesheet): windup → extension → swing → follow-through.

Both were created end-to-end by Claude Fable 5 through this server's MCP tools — drawing, checking its own work with scaled export_frame previews and render_onion_skin, then exporting. The tasks recreate the benchmark from Draw Me a Swordsman by Lj Miranda, whose findings inspired this server's expanded toolset.

Tool Categories

aseprite-mcp FAQ

Is this still being kept up to date?
Yes. It was last updated at the end of July 2026 and is actively maintained.
Do I need to buy Aseprite first?
Yes. Aseprite is paid software and has to already be installed on your computer for any of this to work.
Can I use this to make a walk-cycle animation?
Yes. It can add frames, tween between them, and show you onion-skin previews before exporting.
Do I need to sign up for anything or pay for a key?
No. Everything runs locally against your own copy of Aseprite, so there is nothing extra to sign up for.
How hard is setup?
It is aimed at people comfortable with a terminal. You install Python 3.13 and the uv tool, then point the server at Aseprite.