Unity-first MCP server for the live Aseprite editor (and headless batch).
Strong foundation with complete schemas and descriptions for all 10 tools. Tool names follow verb_noun convention (tween_*, render_*, measure_*, qa_*, batch_*). Descriptions are detailed and context-aware (avg ~150 chars), explaining WHAT the tool does and WHEN to use it. All parameters have types and descriptions. However, some descriptions lack actionable error guidance, and parameter constraints (enums for easing, format) could be more explicit. Output schemas are not formally documented in the visible code. Error handling is present but generic in places.
Palette-lock every ``.aseprite`` in ``folder``: snap each sprite (first frame, alpha preserved) to a palette and export images to ``out_dir``. Give a ``preset`` (gameboy/pico8/cga) or an explicit ``palette`` list of #rrggbb. Non-destructive; continues past per-file errors. Headless.
Export every ``.aseprite`` in ``folder`` (first frame) to an image, optionally integer-upscaled by ``scale``. Non-destructive: writes ``<name>.<format>`` to ``out_dir`` (default = ``folder``); never modifies the source. Continues past per-file errors. Headless. (``file`` is ignored — this operates on a folder.)
Resize every ``.aseprite`` in ``folder`` (first frame, nearest-neighbor) and write images to ``out_dir``. Give either ``scale`` (multiplier) or explicit ``width``/``height``. Non-destructive; continues past per-file errors. Headless.
Pixel-exact diff of two composited frames (count, ratio, change bbox): the "did this frame actually move / did my edit leak into other frames" check an agent can't do by eye.
Measure the transparent 'sticker' padding around the content: content bounding box, per-side padding (left/right/top/bottom), fill ratio, and distinct opaque color count. Read-only. Headless: pass ``file``.
Output schemas not formally documented. Tools return structured data (e.g., frame_diff returns count/ratio/bbox, qa_sweep returns per-check pass/fail) but no JSON Schema definitions visible in code. LLMs cannot plan downstream calls without knowing response structure.
Easing parameter in tween_* tools accepts free-form string ('linear', 'ease_in', 'ease_out', 'smoothstep') but is not declared as an enum. LLMs may hallucinate invalid values like 'ease_in_out' or 'cubic'. Should be enum: ['linear', 'ease_in', 'ease_out', 'smoothstep'].
Batch tools (batch_export, batch_resize, batch_apply_palette) accept 'format' parameter as free-form string with no enum constraint. Should enumerate valid formats (png, jpg, gif, bmp, etc.) to prevent invalid requests.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 62 | 2026-07-28+ | v2 |
Audit the active sprite against project conventions and return per-check pass/fail. Any rule you pass is checked: exact canvas size (``expected_width``/``expected_height``), ``grid_multiple`` (canvas dims divisible by N), ``max_colors`` (distinct opaque colors ≤ N), and ``require_symmetric_padding`` (equal left/right + top/bottom margins). Read-only. Headless: pass ``file``.
Write a PNG of one frame with its neighbors ghosted (prev tinted red, next tinted blue, Aseprite's own convention) so an agent can *see* motion arcs without flipping frames.
Append a motion-smear frame that blends two frames (overlap averaged, single-frame areas ghosted). True pixel-content smear frames were found in no other tool — this is a first attempt at that, not a claim of a solved feature.
Fade a layer's cels across [from_frame..to_frame]: opacity interpolates from ``from_opacity`` to ``to_opacity`` (0-255) with the chosen easing. Every frame in the range needs a cel on the layer. One undo step.
Insert ``count`` in-between frames between ``from_frame`` and ``to_frame`` that interpolate the cel's position (a motion tween of the start cel's image). ``easing``: linear, ease_in, ease_out, or smoothstep. Headless: pass ``file``.
Error handling descriptions are minimal. Tools state 'Headless: pass file' but do not explain what happens if file is invalid, missing, or unreadable. No recovery guidance (e.g., 'If file not found, check path and retry' or 'Unsupported format, use .aseprite files').
batch_apply_palette accepts 'preset' (gameboy/pico8/cga) or 'palette' (array of #rrggbb) but does not document mutual exclusivity or what happens if both are provided. LLMs may pass both, causing ambiguous behavior.