Skip to content

Releases: giangdvdotdev/aseprite-mcp

Release list

v0.6.0

Choose a tag to compare

@giangdvdotdev giangdvdotdev released this 31 Jul 09:10
d5a5292

First public release.

An MCP server that lets an AI assistant draw in Aseprite — live, in the real
editor, on your canvas. Two pieces talk over a local WebSocket: a Python MCP
server and a Lua extension inside Aseprite.

Install

Server — nothing to install ahead of time:

claude mcp add aseprite -- uvx aseprite-mcp

Plugin — download aseprite-mcp.aseprite-extension below and double-click
it, or add it from Edit → Preferences → Extensions → Add Extension. Then
restart Aseprite — extensions load only at startup.

Requires Aseprite 1.3 or newer. Either end can start first; the plugin retries
until the server is there and reconnects on its own afterwards.

What's in it

30 tools:

  • Drawcreate_sprite, draw_pixel, draw_pixels_batch, draw_line,
    draw_rect, draw_ellipse, fill_area, erase_area, add_layer
  • Readget_canvas_image, get_sprite_info, list_layers, get_pixel,
    get_region, get_selection
  • Animateadd_frame, delete_frame, set_frame_duration,
    set_active_frame, list_frames
  • Filesopen_file, save_sprite, list_sprites, set_active_sprite,
    close_sprite
  • Exportexport_png, export_spritesheet
  • Historyundo, redo, get_undo_depth

Full parameter reference in docs/TOOLS.md.
Every error string is documented in
docs/TROUBLESHOOTING.md.