Aseprite Claude Connector
PYPI · ASEPRITE-CLAUDE-CONNECTOR
Let Claude draw in a running Aseprite, and export straight to Godot or Unity
Available components
Last scanned (13 hours ago)
Scores higher than 76% of PyPI servers
Category Design and Media
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 0 of 29 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency100
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to UmarMuhammad18/aseprite-claude-connector). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 1 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability77
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 19541 tokens (~101/item across 193 items; 187 tools + 6 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (11% of tools); any adoption earns full credit.Pass
Tool Safety96
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 6 of 7 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "cancel_ask_point" implies "withdraw" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Partial
- An AI judge read all 189 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Checks we ran (15)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Stability in Stability & Change Management (scores 0 for this)Stability not yet verified: not enough scan history yet (needs a 30-day window).
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 20 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 19 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 17 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 13 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 12 Nov 26 64
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed pypi/aseprite-claude-connector@0.4.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | UmarMuhammad18/aseprite-claude-connector |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/UmarMuhammad18/aseprite-claude-connector/.github/workflows/publish.yml@refs/tags/v0.4.0 |
| Rekor log index | 3815509317 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:7a41c49640632cabb03de5769d75b305b5d88394ad2765070cd745e4e636b370 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | Known build tool | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 29 packages
| Packages resolved | 29 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
iso_recessed_panel ~131
Draw a recessed docking socket/port on an isometric face — a light lit lip framing a dark recessed interior. ``points`` = the 4 corner [x, y] pairs of a face (e.g. the ``face_se`` returned by draw_iso_box). This is the consistent I/O-port style. One undo step. Headless: pass ``file``. ``preview`` true also returns a before/after picture of the canvas with the changed-pixel count and bbox.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| points | array | yes | – |
| preview | boolean | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
lift_symbols ~208
Move floating symbols ("!", "?", Zzz, hearts, sparkles) off a character's layer onto a new layer, and animate them there. ``boxes`` are ``[x, y, w, h]`` round each symbol (or group); only pixels not joined to the body are taken, so a box can overlap a wing. They're found on ``from_frame`` and erased from every frame of ``layer``. ``keys``, one per frame (frames are made as needed): ``{"frame": 2, "symbols": [[dx, dy], null], "ms": 100}``, an offset per box, or null to hide it. Frames without a key show them in place. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| boxes | array | yes | – |
| file | – | – | – |
| from_frame | integer | – | – |
| keys | – | – | – |
| layer | – | – | – |
| name | string | – | – |
No output schema declared.
No examples provided.
list_layers ~60
The full layer tree, top of stack first: name, path, kind (image/group/tilemap), visibility, and opacity — including layers nested in groups (which ``get_sprite_info`` lists only at the top level).
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
No output schema declared.
No examples provided.
list_slices ~41
List every slice with its bounds, pivot, and 9-patch center. Read-only. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
No output schema declared.
No examples provided.
list_sprites ~66
Live editor only: list every open document — filename (or "(unsaved)"), size, frame/layer counts, tags, unsaved-changes flag, which one is active in the editor, and which one Claude's edits go to (``pinned``).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_tags ~21
List animation tags with their frame ranges.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
No output schema declared.
No examples provided.
load_palette ~52
Replace the sprite's palette from a palette file (.gpl, .pal, .ase, .png strip — anything Aseprite reads). One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| path | string | yes | – |
No output schema declared.
No examples provided.
look ~213
See the canvas: returns a frame as an image, scaled up with sharp pixels. Defaults to the active frame with all visible layers. ``layer`` shows one layer or group alone (even if hidden). ``x``/``y``/``width``/``height`` crop to a region, and ``selection`` crops to the current selection. ``scale`` is an integer zoom (1-32); omit it to fit ``max_size``. ``background`` is ``checker``, ``transparent``, or a #rrggbb color. Prefer a crop when you only need part of the canvas: images use up conversation space. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| background | string | – | – |
| file | – | – | – |
| frame | – | – | – |
| height | – | – | – |
| layer | – | – | – |
| max_size | integer | – | – |
| scale | – | – | – |
| selection | boolean | – | – |
| width | – | – | – |
| x | – | – | – |
| y | – | – | – |
No output schema declared.
No examples provided.
look_animation ~164
See an animation: returns a tag or frame range as one image, frames left to right and top to bottom. Defaults to every frame, capped at 64. A range of up to 6 frames is a strip and longer ones are a grid, unless ``columns`` is set. The result lists each cell's frame and duration. ``layer``, ``scale``, ``max_size``, and ``background`` work as in ``look``. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| background | string | – | – |
| columns | – | – | – |
| file | – | – | – |
| from_frame | – | – | – |
| layer | – | – | – |
| max_size | integer | – | – |
| scale | – | – | – |
| tag | – | – | – |
| to_frame | – | – | – |
No output schema declared.
No examples provided.
look_onion ~120
See motion: returns ``frame`` as an image with earlier frames ghosted in red and later frames in blue, so the whole arc shows at once. Defaults to the active frame. The picture form of ``render_onion_composite``. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| background | string | – | – |
| file | – | – | – |
| frame | – | – | – |
| max_size | integer | – | – |
| next | integer | – | – |
| opacity | number | – | – |
| prev | integer | – | – |
| scale | – | – | – |
No output schema declared.
No examples provided.
make_autotiles ~301
Build the 47-tile autotile set for one terrain (``fill_layer``, like grass) over another (``base_layer``, like dirt, or clear), so a map painter picks the right edge and corner for every neighbour. Both textures come from the top-left ``size`` square of their layer, so ``make_seamless`` them first. ``edge`` is how far the fill stops from an open side, and ``outline`` gives its border a darker shade of its own colours. Writes ``name``.png. With ``game_dir`` (or the remembered game folder, if ``out_dir`` isn't given), a Godot project also gets ``name``.tres, a TileSet whose terrain paints the set, and a Unity project gets the sheet sliced into tiles plus ``name``_rule.asset, a Rule Tile (needs the 2D Tilemap Extras package). ``out_dir`` writes the PNG and a JSON map of each tile's neighbours. Returns a picture of the set. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| base_layer | – | – | – |
| edge | – | – | – |
| file | – | – | – |
| fill_layer | string | yes | – |
| frame | integer | – | – |
| game_dir | – | – | – |
| name | string | yes | – |
| out_dir | – | – | – |
| outline | boolean | – | – |
| size | integer | yes | – |
No output schema declared.
No examples provided.
make_normal_map ~221
Make a normal map so the art reacts to 2D lights in Godot and Unity: a torch moving past shades it. Forms round off over ``bevel`` pixels from their outline, ``detail`` (0-1) lets bright areas stand forward, and ``strength`` steepens it all. It goes on a hidden "Normal map" layer, and ``save_path`` also writes it as a PNG strip matching an exported sprite sheet (frames side by side). In Godot, set it as the normal map of a CanvasTexture whose diffuse is the sprite; in Unity, add it to the sprite's Secondary Textures as ``_NormalMap``. Made from ``layer``, or everything visible by default. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| all_frames | boolean | – | – |
| bevel | integer | – | – |
| detail | number | – | – |
| file | – | – | – |
| layer | – | – | – |
| save_path | – | – | – |
| strength | number | – | – |
No output schema declared.
No examples provided.
make_seamless ~159
Make a texture repeat with no visible edge, for ground, walls, or water tiles. The layer (the active one by default) fills the canvas: it is shifted by half so its old edges meet in the middle, and that cross, ``band`` pixels wide (an eighth of the size by default), is rebuilt from ``patch``-sized pieces of the texture itself. Check it with ``look`` after ``expand_canvas`` or by exporting a few side by side. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| band | – | – | – |
| file | – | – | – |
| frame | – | – | – |
| layer | – | – | – |
| patch | integer | – | – |
| seed | integer | – | – |
No output schema declared.
No examples provided.
match_palettes ~114
Put sprites of one character or set on one shared palette: colours closer than ``tolerance`` that stand in for each other (one sprite uses one, another sprite the other) merge into whichever is used most, across the open sprites (live; ``only`` picks them by filename or tag) or ``files``. Alpha is kept. One undo step per sprite. Check first with ``check_consistency``.
| Name | Type | Req | Description |
|---|---|---|---|
| files | – | – | – |
| only | – | – | – |
| tolerance | number | – | – |
No output schema declared.
No examples provided.
measure_padding ~61
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``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| canvas | – | – | – |
| colorCount | – | – | – |
| content | – | – | – |
| empty | – | – | – |
| fillRatio | – | – | – |
| padding | – | – | – |
No examples provided.
merge_layer_down ~31
Merge a layer into the layer directly beneath it.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| name | string | yes | – |
No output schema declared.
No examples provided.
move_layer ~54
Reorder a layer in the stack. ``direction`` is up | down | top | bottom (bottom = stack index 1).
| Name | Type | Req | Description |
|---|---|---|---|
| direction | string | yes | – |
| file | – | – | – |
| name | string | yes | – |
No output schema declared.
No examples provided.
move_layer_to_group ~37
Move a layer inside a layer group.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| group | string | yes | – |
| layer | string | yes | – |
No output schema declared.
No examples provided.
open_sprite ~112
Open a sprite file and make it the active document; returns its filename, size, and frame/layer counts. Live: opens a new tab in the editor and makes it the sprite Claude works on. Headless: each call is a fresh process, so this is a "can Aseprite read this file" probe returning the file's info — to edit a file headless, pass it as the ``file`` argument of the editing tools instead.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
pack_atlas ~131
Pack several sprites into one texture, with every frame of each, plus a JSON map in the hash layout of Aseprite's sprite-sheet export. Frames that repeat exactly share pixels. ``sprites`` are files on disk or, live, the file names of open sprites; unsaved sprites can't be named. The JSON goes beside the PNG unless ``out_json`` says otherwise, and frames are keyed ``<sprite> <index>``.
| Name | Type | Req | Description |
|---|---|---|---|
| out_json | – | – | – |
| out_png | string | yes | – |
| padding | integer | – | – |
| sprites | array | yes | – |
No output schema declared.
No examples provided.
paint_with_stamp ~138
Stamp an image at each [x, y] in ``points`` (points are stamp centers). The stamp comes from ``source_path`` (a PNG) or ``source_rect`` ([x, y, width, height] cut from the composited sprite). One undo step for the whole scatter. Headless: pass ``file``. ``preview`` true also returns a before/after picture of the canvas with the changed-pixel count and bbox.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| layer | – | – | – |
| points | array | yes | – |
| preview | boolean | – | – |
| source_path | – | – | – |
| source_rect | – | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | object | yes | – |
No examples provided.
palette_from_sprite ~65
Derive the palette FROM the sprite's actual pixels (Aseprite's color quantization) — the inverse of ``quantize_to_palette``. Returns the new palette as hex. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| max_colors | integer | – | – |
No output schema declared.
No examples provided.
palette_ramp_walk ~135
Shade by WALKING the arranged palette ±N indices toward lighter/darker (per light direction), instead of snapping to the luminance-nearest color — so hand-ordered shading ramps are respected. ``steps`` = max indices to walk at the fully-lit/shadowed edges. RGB sprite with an ordered ramp palette; one undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| height | integer | yes | – |
| light_direction | string | yes | – |
| steps | integer | – | – |
| width | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
pin_sprite ~131
Live editor only: choose the sprite Claude's edits go to. Every tool then works on it even while the artist looks at another tab. Pick it by ``filename`` (full path or basename), by a ``tag`` it has (the way to tell unsaved sprites apart), or give neither to pin the sprite the artist has open now ("work on this one"). ``unpin`` goes back to following whichever sprite is active. Sprites Claude creates or opens are pinned on their own.
| Name | Type | Req | Description |
|---|---|---|---|
| filename | – | – | – |
| tag | – | – | – |
| unpin | boolean | – | – |
No output schema declared.
No examples provided.
pixelate_reference ~380
Turn a reference picture into pixel art on a new layer: the faithful way to recreate a photo or painting. The picture (or the ``crop_*`` part of it, in its own pixels) is shrunk to ``width`` x ``height`` by averaging, so each pixel is the true colour of that area. ``height`` defaults to the picture's aspect. It is then snapped to ``colors`` colours chosen from the picture, or to ``palette`` (#rrggbb list) to match an existing one. ``dither`` is ``none``, ``ordered``, or ``diffusion``. ``despeckle`` removes lone noise pixels. ``remove_background`` clears a white sheet or flat backdrop (and the light fringe it leaves), before the palette is chosen so no colours are spent on it. ``clear_edges`` drops bits of neighbouring art a crop catches at its edges, keeping the subject and anything floating clear of the edges. To cut every pose out of a character sheet at once, use ``split_sheet``. Refine the result by hand, and check it with ``compare_to_reference``. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| clear_edges | boolean | – | – |
| colors | integer | – | – |
| crop_height | – | – | – |
| crop_width | – | – | – |
| crop_x | – | – | – |
| crop_y | – | – | – |
| despeckle | boolean | – | – |
| dither | string | – | – |
| file | – | – | – |
| height | – | – | – |
| image_path | string | yes | – |
| layer_name | string | – | – |
| palette | – | – | – |
| remove_background | boolean | – | – |
| width | integer | yes | – |
| x | integer | – | – |
| y | integer | – | – |
No output schema declared.
No examples provided.
qa_sweep ~139
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``.
| Name | Type | Req | Description |
|---|---|---|---|
| expected_height | – | – | – |
| expected_width | – | – | – |
| file | – | – | – |
| grid_multiple | – | – | – |
| max_colors | – | – | – |
| require_symmetric_padding | boolean | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| checks | – | – | – |
| failed | – | – | – |
| measurements | – | – | – |
| passed | – | – | – |
No examples provided.
quantize_to_palette ~62
Snap every opaque pixel of the active cel to its nearest color in the sprite's palette (alpha preserved) — enforce palette discipline after intake or shading. RGB sprite; one undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
No output schema declared.
No examples provided.
recolor_variants ~177
Recolor the sprite into team colors or seasons in one batch. ``variants`` maps each variant's name to a color swap, like ``{"red": {"#3050c0": "#c03030"}, "green": {"#3050c0": "#30a040"}}``. Writes one strip ``<name>_<variant>.png`` per variant into ``output_dir``, frames left to right, and returns a picture comparing them. Colors must match exactly, and any that were never found are listed in ``unmatched``. Leaves the sprite untouched. ``tag`` limits it to one animation. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| name | – | – | – |
| output_dir | string | yes | – |
| tag | – | – | – |
| variants | object | yes | – |
No output schema declared.
No examples provided.
redo ~22
Redo the last undone edit (live editor).
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
No output schema declared.
No examples provided.
relight_scene ~208
Show a scene at another time of day: ``dawn``, ``noon``, ``sunset``, or ``night``. Each colour's lightness, warmth, and saturation shift the way that light would, and each maps to one new colour, so the colour count stays the same. ``glows`` are lanterns or windows, ``[[x, y, radius], ...]``, whose pools stay warm and lit. ``strength`` (0-1) blends toward the original. Works on ``layers`` (every visible image layer by default), writing a copy named like "Ground (night)" above each and hiding the original, so switching back is a visibility toggle. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| all_frames | boolean | – | – |
| file | – | – | – |
| glows | – | – | – |
| layers | – | – | – |
| strength | number | – | – |
| time | string | yes | – |
No output schema declared.
No examples provided.
rename_layer ~33
Rename a layer.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| new_name | string | yes | – |
| old_name | string | yes | – |
No output schema declared.
No examples provided.
rename_tag ~55
Rename the animation tag ``old_name`` to ``new_name``. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| new_name | string | yes | – |
| old_name | string | yes | – |
No output schema declared.
No examples provided.
render_onion_composite ~130
Write a PNG of ``frame`` with up to ``prev`` earlier frames ghosted in red and ``next`` later frames ghosted in blue (Aseprite's onion-skin convention) at the given ghost ``opacity`` — so you can *see* the motion arc in one image. Does not modify the sprite. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| frame | integer | yes | – |
| next | integer | – | – |
| opacity | number | – | – |
| output_path | string | yes | – |
| prev | integer | – | – |
No output schema declared.
No examples provided.
replace_color ~97
Replace every pixel matching ``from_color`` (within ``tolerance``, a 0-255 RGB distance) with ``to_color`` across the active cel, preserving each pixel's alpha unless ``to_color`` carries its own. One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| from_color | string | yes | – |
| to_color | string | yes | – |
| tolerance | integer | – | – |
No output schema declared.
No examples provided.
resize_sprite ~36
Scale the whole sprite to new pixel dimensions.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| height | integer | yes | – |
| width | integer | yes | – |
No output schema declared.
No examples provided.
reverse_frames ~63
Reverse frame order (cels on every layer, plus durations) — the whole sprite by default, or the inclusive [from_frame..to_frame] range. One undo step.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| from_frame | – | – | – |
| to_frame | – | – | – |
No output schema declared.
No examples provided.
rotate_sprite ~52
Rotate the whole sprite by 90, 180, or 270 degrees clockwise (lossless). One undo step. Headless: pass ``file``.
| Name | Type | Req | Description |
|---|---|---|---|
| degrees | integer | yes | – |
| file | – | – | – |
No output schema declared.
No examples provided.
run_lua ~185
Run arbitrary Lua inside Aseprite and return its result (advanced escape hatch — equivalent to local code execution). ``J(value)`` is available for JSON returns; wrap your own edits in ``app.transaction`` for clean undo. The prelude also provides ``editCel(fn)`` and ``findLayer(s, name)``. Set ``save=true`` (headless) to persist changes to ``file``. Your code must ``return`` a value. Set ``edit=true`` when the code only edits the active sprite: it then runs as one undo step, under the pixel cap and dry run. Without ``edit`` the rails don't apply, and in a dry run this tool refuses to run.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
| edit | boolean | – | – |
| file | – | – | – |
| save | boolean | – | – |
No output schema declared.
No examples provided.
save_all_sprites ~139
Live editor only: save open work into ``folder`` as ``.aseprite`` files, so nothing is lost when tabs are closed. Unsaved sprites are saved there and become those files (named after their first tag); sprites that already have a file and unsaved changes are COPIED there, leaving their own file untouched. ``all_sprites`` copies unchanged ones too. ``only`` limits it to sprites with these filenames or tags. Never overwrites: a taken name gets a number.
| Name | Type | Req | Description |
|---|---|---|---|
| all_sprites | boolean | – | – |
| folder | string | yes | – |
| only | – | – | – |
No output schema declared.
No examples provided.
save_palette ~41
Write the sprite's palette to a file (.gpl, .pal, .png — by extension).
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| path | string | yes | – |
No output schema declared.
No examples provided.
save_sprite ~126
Save the active sprite to disk: to ``path`` if given (save-as; the document's filename follows it), else to its own filename — errors if the sprite is untitled and no ``path`` is given. Live: persists the edits sitting in the open editor. Headless: mutating tools already save to ``file`` on their own; use this with both arguments to write a copy of ``file`` under a new ``path`` (the source file on disk stays untouched).
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| path | – | – | – |
No output schema declared.
No examples provided.
search_api_docs ~72
Search Aseprite's Lua scripting API reference, bundled with this server. Use it before writing ``run_lua`` code, for a class, method, or property such as ``Image:drawImage`` or ``selection bounds``.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| query | string | yes | – |
No output schema declared.
No examples provided.
search_manual ~73
Search Aseprite's user manual: how features work in the editor, such as tilemaps, onion skinning, or slices. The first search downloads the manual from GitHub to your cache, then it refreshes every 30 days.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | – |
| query | string | yes | – |
No output schema declared.
No examples provided.
select_all ~18
Select the whole canvas.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
No output schema declared.
No examples provided.
select_by_color ~83
Select every pixel matching ``color`` (composited, within ``tolerance`` 0-255 per channel) — a global magic wand. ``mode`` is ``replace``/``add``/``subtract``.
| Name | Type | Req | Description |
|---|---|---|---|
| color | string | yes | – |
| file | – | – | – |
| mode | string | – | – |
| tolerance | integer | – | – |
No output schema declared.
No examples provided.
select_ellipse ~84
Select an ellipse inscribed in the given rectangle. ``mode`` is ``replace`` (default), ``add``, or ``subtract`` against the current selection.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| height | integer | yes | – |
| mode | string | – | – |
| width | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
select_frame ~55
Make a frame active, so the next edits land on it. Headless forgets this between calls, so use it as a step in ``edit_batch`` there.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| number | integer | yes | – |
No output schema declared.
No examples provided.
select_layer ~69
Make a layer active, so the next edits land on it. ``name`` may be a "Group/Layer" path. Headless forgets this between calls, so use it as a step in ``edit_batch`` there.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| name | string | yes | – |
No output schema declared.
No examples provided.
select_rectangle ~53
Set a rectangular selection. Most meaningful on the live editor.
| Name | Type | Req | Description |
|---|---|---|---|
| file | – | – | – |
| height | integer | yes | – |
| width | integer | yes | – |
| x | integer | yes | – |
| y | integer | yes | – |
No output schema declared.
No examples provided.
set_active_sprite ~87
Live editor only: make one of the open documents active, found by exact filename or basename match (e.g. "turret.aseprite"). Returns which sprite matched and how. Subsequent tools operate on it, even if the artist clicks another tab. Unsaved sprites share a name: pick those with ``pin_sprite``.
| Name | Type | Req | Description |
|---|---|---|---|
| filename | string | yes | – |
No output schema declared.
No examples provided.
How do I install the Aseprite Claude Connector MCP server?
Aseprite Claude Connector runs locally as a PyPI package, launched with uvx aseprite-claude-connector. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · aseprite-claude-connector
claude mcp add umarmuhammad18-aseprite-claude-connector -- uvx aseprite-claude-connector
What is the Aseprite Claude Connector MCP server?
Aseprite Claude Connector is an MCP server listed in the public MCP registry as io.github.UmarMuhammad18/aseprite-claude-connector. Let Claude draw in a running Aseprite, and export straight to Godot or Unity. This page covers its PyPI package (aseprite-claude-connector).
Is the Aseprite Claude Connector MCP server safe to use?
Aseprite Claude Connector scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Aseprite Claude Connector MCP server expose?
Aseprite Claude Connector exposes 187 tools: status, get_sprite_info, describe_sprite, get_pixel, set_sprite_metadata, and 182 more. Their descriptions and schemas cost roughly 18,843 tokens of context every time the server is loaded.
Is the Aseprite Claude Connector MCP server still maintained?
Aseprite Claude Connector is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Aseprite Claude Connector MCP server under?
Aseprite Claude Connector declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.
What did VerifyMCP test on the Aseprite Claude Connector MCP server?
VerifyMCP ran 15 checks on Aseprite Claude Connector, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Aseprite Claude Connector: Stability. One category scores 0 for that reason, because we only credit what we can confirm. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.