Aseprite MCP Tools

Name: Aseprite MCP Tools
Author: diivi

@diivi

Repository

About Aseprite MCP Tools

MCP server for interacting with the Aseprite API

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aseprite-mcp": {
      "command": "docker",
      "args": [
        "build",
        "-t",
        "aseprite-mcp:latest",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Aseprite MCP Tools?

A Python MCP server that gives AI assistants full control over Aseprite for creating pixel art and animated sprites, offering 104 tools across 17 categories.

How to use Aseprite MCP Tools?

Install the Python package and configure the server in your MCP client. The server provides tools for canvas, drawing, layers, animation, palettes, effects, export, and more—invoke them from your AI assistant to create and edit sprites.

Key features of Aseprite MCP Tools

104 tools across 17 categories for full Aseprite control
Drawing tools: pixels, lines, shapes, fills, gradients
Animation tools: frames, cels, tweening, onion skin rendering
Palette management: presets, color ramps, quantization
Visual feedback: scaled previews, frame diffs, color stats
Export: PNG, GIF, spritesheets, per-layer/per-tag export
Raw Lua escape hatch for custom scripting

Use cases of Aseprite MCP Tools

Generate pixel art characters from text descriptions
Animate sprites with motion tweening and onion skin previews
Export spritesheets and animation tags for game development
Automate palette swaps, outline effects, and color adjustments
Validate and sanitize sprite consistency across frames

FAQ from Aseprite MCP Tools

What tools are included?

104 tools spanning canvas creation, drawing (pixels, shapes, fills, gradients), layers, animation (frames, cels, tweening, tags), palettes (presets, ramps, quantization), effects (outlines, color replacement, dithering), transforms, slices, tilemaps, export/import, inspection, analysis, quality checks, a scene layer copier, a preview server, a workflow guide, and a raw Lua script runner.

Does it require Aseprite to be installed?

Yes. The server communicates with Aseprite through its Lua API in batch mode; Aseprite must be installed and accessible on the system.

Can I run arbitrary custom scripts?

Yes—the run_lua_script tool executes any Aseprite Lua code. This runs unrestricted code on your host; only pass scripts you trust.

Is this server only for pixel art?

The tool set is optimized for pixel art and sprite animation, but it can work with any Aseprite project (e.g., larger images, tilemaps, color management).