Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Aseprite Claude Connector

PYPI · ASEPRITE-CLAUDE-CONNECTOR

Let Claude draw in a running Aseprite, and export straight to Godot or Unity

0 this week 79 Trust /100

Last scanned (13 hours ago)

Scores higher than 76% of PyPI servers

Category Design and Media

Trust breakdown (7 categories)

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.

What we tested

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 →

Changelog

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.

Diagnostics

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 →

MCP tools · 187 exposed · ~18,843 tokens

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 →

Tool Tokens
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.

NameTypeReqDescription
file–––
pointsarrayyes–
previewboolean––
NameTypeReqDescription
resultobjectyes–

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``.

NameTypeReqDescription
boxesarrayyes–
file–––
from_frameinteger––
keys–––
layer–––
namestring––

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).

NameTypeReqDescription
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``.

NameTypeReqDescription
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.

NameTypeReqDescription
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.

NameTypeReqDescription
file–––
pathstringyes–

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``.

NameTypeReqDescription
backgroundstring––
file–––
frame–––
height–––
layer–––
max_sizeinteger––
scale–––
selectionboolean––
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``.

NameTypeReqDescription
backgroundstring––
columns–––
file–––
from_frame–––
layer–––
max_sizeinteger––
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``.

NameTypeReqDescription
backgroundstring––
file–––
frame–––
max_sizeinteger––
nextinteger––
opacitynumber––
previnteger––
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``.

NameTypeReqDescription
base_layer–––
edge–––
file–––
fill_layerstringyes–
frameinteger––
game_dir–––
namestringyes–
out_dir–––
outlineboolean––
sizeintegeryes–

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``.

NameTypeReqDescription
all_framesboolean––
bevelinteger––
detailnumber––
file–––
layer–––
save_path–––
strengthnumber––

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``.

NameTypeReqDescription
band–––
file–––
frame–––
layer–––
patchinteger––
seedinteger––

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``.

NameTypeReqDescription
files–––
only–––
tolerancenumber––

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``.

NameTypeReqDescription
file–––
NameTypeReqDescription
canvas–––
colorCount–––
content–––
empty–––
fillRatio–––
padding–––

No examples provided.

merge_layer_down ~31

Merge a layer into the layer directly beneath it.

NameTypeReqDescription
file–––
namestringyes–

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).

NameTypeReqDescription
directionstringyes–
file–––
namestringyes–

No output schema declared.

No examples provided.

move_layer_to_group ~37

Move a layer inside a layer group.

NameTypeReqDescription
file–––
groupstringyes–
layerstringyes–

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.

NameTypeReqDescription
pathstringyes–

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>``.

NameTypeReqDescription
out_json–––
out_pngstringyes–
paddinginteger––
spritesarrayyes–

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.

NameTypeReqDescription
file–––
layer–––
pointsarrayyes–
previewboolean––
source_path–––
source_rect–––
NameTypeReqDescription
resultobjectyes–

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.

NameTypeReqDescription
file–––
max_colorsinteger––

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``.

NameTypeReqDescription
file–––
heightintegeryes–
light_directionstringyes–
stepsinteger––
widthintegeryes–
xintegeryes–
yintegeryes–

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.

NameTypeReqDescription
filename–––
tag–––
unpinboolean––

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``.

NameTypeReqDescription
clear_edgesboolean––
colorsinteger––
crop_height–––
crop_width–––
crop_x–––
crop_y–––
despeckleboolean––
ditherstring––
file–––
height–––
image_pathstringyes–
layer_namestring––
palette–––
remove_backgroundboolean––
widthintegeryes–
xinteger––
yinteger––

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``.

NameTypeReqDescription
expected_height–––
expected_width–––
file–––
grid_multiple–––
max_colors–––
require_symmetric_paddingboolean––
NameTypeReqDescription
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``.

NameTypeReqDescription
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``.

NameTypeReqDescription
file–––
name–––
output_dirstringyes–
tag–––
variantsobjectyes–

No output schema declared.

No examples provided.

redo ~22

Redo the last undone edit (live editor).

NameTypeReqDescription
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``.

NameTypeReqDescription
all_framesboolean––
file–––
glows–––
layers–––
strengthnumber––
timestringyes–

No output schema declared.

No examples provided.

rename_layer ~33

Rename a layer.

NameTypeReqDescription
file–––
new_namestringyes–
old_namestringyes–

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``.

NameTypeReqDescription
file–––
new_namestringyes–
old_namestringyes–

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``.

NameTypeReqDescription
file–––
frameintegeryes–
nextinteger––
opacitynumber––
output_pathstringyes–
previnteger––

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``.

NameTypeReqDescription
file–––
from_colorstringyes–
to_colorstringyes–
toleranceinteger––

No output schema declared.

No examples provided.

resize_sprite ~36

Scale the whole sprite to new pixel dimensions.

NameTypeReqDescription
file–––
heightintegeryes–
widthintegeryes–

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.

NameTypeReqDescription
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``.

NameTypeReqDescription
degreesintegeryes–
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.

NameTypeReqDescription
codestringyes–
editboolean––
file–––
saveboolean––

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.

NameTypeReqDescription
all_spritesboolean––
folderstringyes–
only–––

No output schema declared.

No examples provided.

save_palette ~41

Write the sprite's palette to a file (.gpl, .pal, .png — by extension).

NameTypeReqDescription
file–––
pathstringyes–

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).

NameTypeReqDescription
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``.

NameTypeReqDescription
limitinteger––
querystringyes–

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.

NameTypeReqDescription
limitinteger––
querystringyes–

No output schema declared.

No examples provided.

select_all ~18

Select the whole canvas.

NameTypeReqDescription
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``.

NameTypeReqDescription
colorstringyes–
file–––
modestring––
toleranceinteger––

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.

NameTypeReqDescription
file–––
heightintegeryes–
modestring––
widthintegeryes–
xintegeryes–
yintegeryes–

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.

NameTypeReqDescription
file–––
numberintegeryes–

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.

NameTypeReqDescription
file–––
namestringyes–

No output schema declared.

No examples provided.

select_rectangle ~53

Set a rectangular selection. Most meaningful on the live editor.

NameTypeReqDescription
file–––
heightintegeryes–
widthintegeryes–
xintegeryes–
yintegeryes–

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``.

NameTypeReqDescription
filenamestringyes–

No output schema declared.

No examples provided.

Install

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

# add to Claude Code
claude mcp add umarmuhammad18-aseprite-claude-connector -- uvx aseprite-claude-connector
Common questions

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.