Overview
mcp-aseprite is an MCP server that provides AI assistants such as Claude Code, Claude Desktop, and Cursor with control over Aseprite, a pixel-art editor. It wraps both the Aseprite command line and its Lua scripting API, allowing an assistant to inspect sprites, export frames and spritesheets, create new files, and edit pixels, layers, frames, tags, and palettes. All operations run headless in batch mode, with no window. The server exposes a set of tools including aseprite_info, aseprite_export, aseprite_export_spritesheet, aseprite_create_sprite, aseprite_run_script, aseprite_run_script_file, aseprite_list_layers, aseprite_list_tags, aseprite_list_slices, and aseprite_cli. The aseprite_run_script tool allows running arbitrary Lua against the Aseprite API, with output from Lua print() returned as the tool result. Requirements include Aseprite v1.2.10 or newer (Steam or standalone) and Node.js 18+. The trial version of Aseprite has no CLI and will not work. The server automatically searches for the Aseprite binary in common Steam and standalone install locations, and falls back to aseprite on the PATH. A custom location can be set via the ASEPRITE_BIN environment variable. Each call runs a fresh Aseprite process, so state does not carry over between calls; to keep changes, save within the same call. The project is licensed under MIT.
Pricing
Free
Detailed plans have not been confirmed in our catalog. Check the official website for current limits and billing terms.
Visit WebsitePrices and limits may change. Confirm the currency, billing period, seat minimum and usage caps on the official website.
Use Cases
- Teams use mcp-aseprite to inspect sprite metadata such as size, color mode, frames, palette size, layers, tags, slices, and frame durations.
- Teams use mcp-aseprite to export sprites to PNG, GIF, or JPG with options for frame range, layer filter, scale, color-mode conversion, and split by layer or tag.
- Teams use mcp-aseprite to pack sprites into a spritesheet with JSON metadata, supporting hash or array formats, trim, merge duplicates, and 5 layouts.
- Teams use mcp-aseprite to create new .aseprite files in RGB, grayscale, or indexed color mode with an optional background color.
- Teams use mcp-aseprite to run arbitrary Lua scripts against the Aseprite API, optionally opening a sprite first and saving it afterwards.
- Teams use mcp-aseprite to list layer names, animation tags, and slices from a sprite.
- Teams use mcp-aseprite as an escape hatch to run the Aseprite binary with any arguments.
Features
Control Aseprite through MCP
Create sprites with AI assistants
Export assets from Aseprite
Generate sprite sheets
Access the complete Lua scripting API
Reviews
No reviews yet. Be the first to share your experience!