Skip to main content
Glama
ext-sakamoro

Aseprite MCP Tools

by ext-sakamoro

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ASEPRITE_PATHYesPath to the Aseprite executable/Applications/Aseprite.app/Contents/MacOS/aseprite
ASEPRITE_MCP_LOG_LEVELNoLog level for the MCP serverINFO

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
create_canvasA

Create a new Aseprite canvas with specified dimensions.

Args: width: Width of the canvas in pixels height: Height of the canvas in pixels filename: Name of the output file (default: canvas.aseprite)

add_layerC

Add a new layer to the Aseprite file.

Args: filename: Name of the Aseprite file to modify layer_name: Name of the new layer

add_frameB

Add a new frame to the Aseprite file.

Args: filename: Name of the Aseprite file to modify after_frame: Frame index after which to add the new frame (0-based, optional)

draw_pixelsA

Draw pixels on the canvas with specified colors.

Args: filename: Name of the Aseprite file to modify pixels: List of pixel data, each containing: {"x": int, "y": int, "color": str} where color is a hex code like "#FF0000"

draw_lineB

Draw a line on the canvas.

Args: filename: Name of the Aseprite file to modify x1: Starting x coordinate y1: Starting y coordinate x2: Ending x coordinate y2: Ending y coordinate color: Hex color code (default: "#000000") thickness: Line thickness in pixels (default: 1)

draw_rectangleB

Draw a rectangle on the canvas.

Args: filename: Name of the Aseprite file to modify x: Top-left x coordinate y: Top-left y coordinate width: Width of the rectangle height: Height of the rectangle color: Hex color code (default: "#000000") fill: Whether to fill the rectangle (default: False)

draw_circleB

Draw a circle on the canvas.

Args: filename: Name of the Aseprite file to modify center_x: X coordinate of circle center center_y: Y coordinate of circle center radius: Radius of the circle in pixels color: Hex color code (default: "#000000") fill: Whether to fill the circle (default: False)

fill_areaC

Fill an area with color using the paint bucket tool.

Args: filename: Name of the Aseprite file to modify x: X coordinate to fill from y: Y coordinate to fill from color: Hex color code (default: "#000000") tolerance: Tolerance for color matching (0-255, default: 0)

export_spriteB

Export the Aseprite file to another format.

Args: filename: Name of the Aseprite file to export output_filename: Name of the output file format: Output format (default: inferred from extension, can be "png", "gif", "jpg", etc.) scale: Export scale factor (default: 1.0) frame_range: Frame range to export (e.g., "1-5" or "2,4,6")

export_layersA

Export each layer of the sprite as a separate file.

Args: filename: Name of the Aseprite file to export output_dir: Directory to save the exported layers format: Output format (default: "png") scale: Export scale factor (default: 1.0)

create_paletteB

Create or replace a palette in an Aseprite file.

Args: filename: Name of the Aseprite file to modify colors: List of hex color codes (e.g., ["FF0000", "00FF00", "0000FF"]) palette_name: Optional name for the palette

apply_preset_paletteA

Apply a predefined palette to an Aseprite file.

Args: filename: Name of the Aseprite file to modify preset: Preset palette name. Options: gameboy, gameboy-pocket, nes, pico-8, cga, monochrome, sepia

extract_palette_from_imageC

Extract a color palette from an existing image.

Args: filename: Name of the Aseprite file to extract palette from max_colors: Maximum number of colors to extract (default: 16) output_filename: Optional filename to save the palette

get_palette_infoC

Get information about the current palette in an Aseprite file.

Args: filename: Name of the Aseprite file to inspect

remap_colorsB

Remap colors in an Aseprite file.

Args: filename: Name of the Aseprite file to modify color_map: Dictionary mapping old colors to new colors (e.g., {"FF0000": "00FF00"})

batch_resizeB

Batch resize multiple Aseprite files.

Args: input_dir: Directory containing input files output_dir: Directory for resized files width: Target width (optional) height: Target height (optional) scale: Scale factor (optional, alternative to width/height) maintain_aspect_ratio: Maintain aspect ratio when resizing file_pattern: File pattern to match (default: "*.aseprite")

batch_exportB

Batch export multiple Aseprite files to another format.

Args: input_dir: Directory containing input files output_dir: Directory for exported files format: Export format (png, gif, jpg, etc.) scale: Export scale factor file_pattern: File pattern to match (default: "*.aseprite")

batch_apply_paletteC

Apply a palette to multiple Aseprite files.

Args: input_dir: Directory containing input files palette_file: Path to palette file or preset name file_pattern: File pattern to match (default: "*.aseprite") create_backup: Create backup of original files

batch_process_customB

Apply a custom Lua script to multiple Aseprite files.

Args: input_dir: Directory containing input files lua_script: Lua script to execute on each file output_dir: Optional output directory for modified files file_pattern: File pattern to match (default: "*.aseprite")

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 19 tools

Disambiguation4/5

Most tools have distinct purposes targeting specific Aseprite operations like drawing shapes, palette management, or batch processing, but some overlap exists between 'export_sprite' and 'batch_export' which could cause confusion in selection. Descriptions help clarify, but the boundary between single-file and batch export is not entirely clear from names alone.

Naming Consistency5/5

Tool names consistently follow a verb_noun pattern throughout, such as 'add_frame', 'draw_circle', and 'batch_export', with no deviations in style. This predictability makes it easy for agents to understand and navigate the toolset without confusion from mixed conventions.

Tool Count4/5

With 19 tools, the count is slightly high but reasonable for a comprehensive Aseprite manipulation server, covering operations from creation to export and batch processing. It feels well-scoped for the domain, though it borders on being heavy, which could overwhelm agents but is justified by the functionality offered.

Completeness5/5

The toolset provides complete coverage for Aseprite file manipulation, including CRUD-like operations (e.g., create_canvas, add_frame/layer), drawing functions, palette management, and batch processing. No obvious gaps exist; agents can handle full workflows from sprite creation to export and modification without dead ends.

Maintenance

ActivityInactive
ResponsivenessNo issues