Aseprite MCP Tools

What is Aseprite MCP Tools?

A Python MCP server that gives AI assistants full control over Aseprite for creating pixel art and animated sprites, offering 104 tools across 17 categories.

How to use Aseprite MCP Tools?

Install the Python package and configure the server in your MCP client. The server provides tools for canvas, drawing, layers, animation, palettes, effects, export, and more—invoke them from your AI assistant to create and edit sprites.

Key features of Aseprite MCP Tools

• 104 tools across 17 categories for full Aseprite control
• Drawing tools: pixels, lines, shapes, fills, gradients
• Animation tools: frames, cels, tweening, onion skin rendering
• Palette management: presets, color ramps, quantization
• Visual feedback: scaled previews, frame diffs, color stats
• Export: PNG, GIF, spritesheets, per-layer/per-tag export
• Raw Lua escape hatch for custom scripting

Use cases of Aseprite MCP Tools

• Generate pixel art characters from text descriptions
• Animate sprites with motion tweening and onion skin previews
• Export spritesheets and animation tags for game development
• Automate palette swaps, outline effects, and color adjustments
• Validate and sanitize sprite consistency across frames

FAQ from Aseprite MCP Tools

What tools are included?

104 tools spanning canvas creation, drawing (pixels, shapes, fills, gradients), layers, animation (frames, cels, tweening, tags), palettes (presets, ramps, quantization), effects (outlines, color replacement, dithering), transforms, slices, tilemaps, export/import, inspection, analysis, quality checks, a scene layer copier, a preview server, a workflow guide, and a raw Lua script runner.

Does it require Aseprite to be installed?

Yes. The server communicates with Aseprite through its Lua API in batch mode; Aseprite must be installed and accessible on the system.

Can I run arbitrary custom scripts?

Yes—the run_lua_script tool executes any Aseprite Lua code. This runs unrestricted code on your host; only pass scripts you trust.

Is this server only for pixel art?

The tool set is optimized for pixel art and sprite animation, but it can work with any Aseprite project (e.g., larger images, tilemaps, color management).

How do I preview the output without opening Aseprite?

Use the `export_frame