Aseprite MCP Server
Automates Aseprite to create, edit, animate, and export game assets, including generating Aseprite files, spritesheets, animation GIFs, and atlas metadata.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Aseprite MCP Server create a 32x32 pixel-art knight idle animation from references/knight.png"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Aseprite MCP Server & Multi-Agent Asset Pipeline
Model Context Protocol (MCP) server & automated Multi-Agent Asset Pipeline for automating Aseprite to create, edit, animate, and export game assets.
Multi-Agent Architecture (Asset Pipeline)
[Gambar Referensi / Prompt Anda]
│
▼
┌───────────────────────┐
│ 1. Vision & Style │ ──> Ekstrak Palette (HEX), Style Shading,
│ Analyzer Agent │ Ketebalan Outline, & Grid Resolution
└───────────────────────┘
│ (Style Specification Spec: style_spec.json)
▼
┌───────────────────────┐
│ 2. Game Asset │ ──> Menerjemahkan Ide Objek ke Bentuk Geometri /
│ Architect Agent │ Silhouette Piksel & Keyframe Animasi
└───────────────────────┘
│ (Asset Blueprint Spec: blueprint_spec.json)
▼
┌───────────────────────┐
│ 3. Aseprite Scripting │ ──> Menyusun Kode Lua (Layering, Mirroring,
│ Engineer (MCP) │ Canvas, Color Indexing, Cel Transforms)
└───────────────────────┘
│ (Output: build.lua)
▼
[Aseprite CLI / Socket] ──> Langsung Terbuka di Canvas Aseprite Anda!Related MCP server: Aseprite MCP Tools
Folder Structure
references/: Taruh gambar referensi Anda di sini (.png,.jpg,.jpeg).output/<folder-baru>/: Setiap pembuatan aset dikelompokkan ke dalam subfolder tersendiri:style_spec.json(Spesifikasi gaya dari Agent 1)blueprint_spec.json(Spesifikasi struktur & animasi dari Agent 2)build.lua(Script Lua dari Agent 3)<asset>.aseprite(Master file Aseprite lengkap dengan layer & tags)<asset>_sheet.png(Atlas spritesheet)<asset>_sheet.json(Metadata JSON atlas untuk Godot / Unity)<asset>_<tag>.gif(Animasi per aksi)<asset>_preview.png(Preview still frame resolusi tinggi)
Quickstart
# Install dependencies
bun install
# atau
npm install
# Build TypeScript
bun run build
# atau
npm run buildComplete Indonesian Guide
Panduan lengkap dalam Bahasa Indonesia: 👉 PANDUAN_INTEGRASI.md
Available Tools
12 toolsaseprite_analyze_styleC
Extract palette (HEX), shading style, outline rules, and grid specs from a reference image or text prompt.
Inputs: prompt (required), width, height, referenceImage.
aseprite_apply_paletteC
Apply a color palette preset (e.g. 'pico-8', 'endesga-32', 'gameboy') or custom hex colors to a sprite.
Inputs: filepath (required), customPalette, palettePreset.
aseprite_convertC
Convert a sprite file to another format (.png, .gif, .aseprite) with optional pixel-perfect integer scaling (e.g. 2x, 4x, 8x).
Inputs: inputPath (required), outputPath (required), scale, frameRange.
aseprite_create_animationC
Add animation frames, configure frame durations (ms), and set animation tags (e.g. 'idle', 'walk', 'jump').
Inputs: filepath (required), tags, totalFrames, frameDurations, +1 more.
aseprite_create_spriteC
Create a new sprite file (.aseprite or .png) with custom dimensions, color mode, layers, frames, and palette.
Inputs: filepath (required), width, frames, height, +4 more.
aseprite_draw_pixelsB
Draw pixels or a 2D character matrix onto a specific layer and frame of an existing sprite.
Inputs: filepath (required), frame, layer, matrix, +2 more.
aseprite_export_spritesheetC
Export a sprite or animation into a packed spritesheet texture (.png) and metadata (.json) for game engines.
Inputs: filepath (required), sheetPath (required), trim, format, +7 more.
aseprite_get_infoA
Get Aseprite executable path, version, and test CLI/Lua scripting capability.
Inputs: no named parameters.
aseprite_inspect_spriteB
Inspect an existing sprite file (.aseprite or image) to read dimensions, layers, frames, animation tags, and palette.
Inputs: filepath (required).
aseprite_open_in_guiC
Directly open an .aseprite file on your screen inside the Aseprite GUI window.
Inputs: filepath (required).
aseprite_run_luaB
Execute arbitrary Lua script inside Aseprite headless environment for advanced custom workflows.
Inputs: code (required), params.
aseprite_run_pipelineB
Run the 3-stage Multi-Agent Asset Pipeline (Vision & Style Analyzer -> Game Asset Architect -> Scripting Engineer). Outputs all files grouped in a dedicated folder in /output//.
Inputs: prompt (required), width, height, assetName, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools have clearly distinct resource+action targets, but aseprite_run_lua and aseprite_run_pipeline both execute workflows and could be confused, and aseprite_analyze_style partially overlaps palette/inspection concerns of aseprite_apply_palette and aseprite_inspect_sprite.
Every tool uses the aseprite_ prefix with a consistent verb_noun pattern (create_sprite, draw_pixels, apply_palette, export_spritesheet, inspect_sprite, run_lua), making the set highly predictable.
12 tools is a well-scoped size for a sprite-editing server, covering distinct phases (info, create, draw, animate, palette, export, inspect) without obvious redundancy.
Core pixel-art lifecycle is covered from creation through drawing, animation, palette, export, and inspection, but there are gaps in editing existing sprites (e.g. add/remove layers or frames, delete/resize operations) that could create dead ends for iterative workflows.
Maintenance
Related MCP Connectors
Generate, edit, style-match, turn, and animate game-ready pixel art at exact sizes.
Pixel art for your game, from your coding agent. Generate sprites, items and tiles in your game's style (64 to 1024 px), make variants, reskins and N/E/S/W directions, then edit everything in a full pixel art editor that syncs into your project. Works with Claude, Claude Code, Cursor and ChatGPT; sign in with OAuth, no API key.
Generate pixel art sprites, animations, 8-direction rotations and palettes for games.
AI game assets for agents: consistent sprites, 2D animations, tiles, maps, music and engine exports.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to create, draw, and refine Aseprite documents through deterministic canvas, layer, frame, tag, and palette tools, with pixel analyzers, style validation, and preview/diff visual feedback. It also supports spritesheet and animated GIF export, producing multi-layer game-ready assets.1MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to create and edit pixel art and animated sprites in Aseprite through 104 tools covering drawing, layers, animation, palettes, tilemaps, exports, visual analysis, and raw Lua scripting.116MIT
- AlicenseBqualityCmaintenanceEnables an AI agent to create and edit pixel art directly in Aseprite — building sprites, layers, frames, animation tags and palettes, painting pixels and primitives, inspecting the rendered result, and exporting GIFs or sprite sheets. All work lands on real .aseprite files that can be opened and edited by hand.43157 npm1MIT
- AlicenseCqualityCmaintenanceEnables AI assistants to create and edit pixel art and sprite animations by driving Aseprite's 73 tools for sprites, layers, frames, cels, drawing, selections, palettes, tags, slices, tilemaps, filters and export, with a generic escape hatch to any of its 183 menu commands or Lua scripting API. It runs either headless in batch mode on files or live against an open Aseprite window so edits are visible and undoable.73157 npm2MIT