121 Tools · 16 Categories · $10 One-Time

AI-Powered Pixel Art
with Aseprite

Aseprite MCP Pro is an MCP server with 121 tools that connects AI assistants like Claude and Cursor directly to the Aseprite editor via WebSocket. Create sprites, animate, manage palettes, and export for Godot — all through natural language. $10 one-time purchase, works on Windows, macOS, and Linux.

Get Aseprite MCP Pro — $10 View on GitHub
$10 one-time purchase · Lifetime updates

See It in Action

Watch AI create pixel art, animate sprites, and export for Godot — all from natural language prompts.

AI Client (Claude Code, Cursor, etc.)
        ↕ MCP Protocol (stdio)
    Node.js MCP Server
        ↕ WebSocket :6515
  Aseprite Lua Extension
        ↕ Aseprite Scripting API
      Aseprite Editor

Real-time bidirectional communication. The MCP server translates AI requests into Lua commands executed directly inside Aseprite.

How It Works

Connect your AI assistant to Aseprite in under 5 minutes.

Install the Extension

Copy the Lua extension into Aseprite's scripts folder. The extension connects to the MCP server via WebSocket on port 6515 automatically when Aseprite starts.

Build the MCP Server

Run npm install && npm run build in the server/ directory. This compiles the TypeScript MCP server that bridges your AI client to the Aseprite extension.

Start Creating with AI

Add the server to your AI client's MCP config. Open Aseprite, and your AI assistant now has access to 121 tools — creating sprites, drawing pixels, managing palettes, animating, and exporting assets.

121
Tools
16
Categories
10
Lospec Palettes
built-in
$10
One-time
no subscription

121 Tools, 16 Categories

Everything you need to let AI create, animate, and export pixel art in Aseprite.

Sprite

12 tools
  • create_sprite new canvas with size & color mode
  • open_sprite save_sprite
  • resize_sprite scale with algorithm
  • crop_sprite trim to content
  • get_screenshot capture current state
  • set_grid configure pixel grid

Drawing

13 tools
  • put_pixel individual pixels
  • draw_line draw_rect draw_ellipse
  • flood_fill bucket fill
  • brush_stroke freehand drawing
  • color_replace swap colors
  • draw_outline auto-outline shapes

Layer

10 tools
  • add_layer delete_layer rename_layer
  • set_visibility set_opacity
  • set_blend_mode multiply, screen, overlay, etc.
  • reorder_layer duplicate_layer
  • merge_layers flatten selections

Frame

8 tools
  • add_frame delete_frame
  • set_duration per-frame timing
  • navigate_frame jump to frame
  • duplicate_frame copy with contents
  • reverse_frames flip animation order

Palette

12 tools
  • get_palette set_color
  • load_lospec_palette 10 built-in palettes
  • sort_palette by hue, saturation, lightness
  • import_from_image extract palette
  • create_color_ramp gradient generation

Export

6 tools
  • export_png single frame or all frames
  • export_spritesheet grid or packed
  • export_gif animated GIF
  • export_tileset tileset images
  • export_per_layer each layer separately
  • export_per_tag animation clips

Editor

3 tools
  • execute_script run arbitrary Lua
  • undo step backward
  • redo step forward

Cel

5 tools
  • get_cel read cel data
  • set_position move cel on canvas
  • set_opacity cel-level transparency
  • clear_cel erase contents
  • link_cel share data between frames

Selection

7 tools
  • select_rect select_ellipse
  • select_by_color magic wand
  • select_all deselect
  • invert_selection toggle selected area

Tag

6 tools
  • create_tag name frame ranges
  • delete_tag rename_tag
  • set_tag_color visual organization
  • set_tag_range adjust frame span

Slice

5 tools
  • create_slice define sprite regions
  • delete_slice remove regions
  • set_9patch 9-slice scaling borders
  • set_pivot anchor points

Tilemap

5 tools
  • create_tilemap_layer tilemap setup
  • get_tile set_tile read/write tiles
  • get_tileset_info inspect tileset

Godot Integration

10 tools
  • export_spriteframes .tres for AnimatedSprite2D
  • export_animation_player .tres resource
  • export_atlas_texture AtlasTexture
  • export_tileset Godot TileSet resource
  • sync_to_project auto-copy to Godot
  • batch_export export all sprites at once

Analysis

6 tools
  • color_stats palette usage analysis
  • compare_frames frame-to-frame diff
  • visual_diff highlight pixel changes
  • find_unused_colors palette cleanup
  • get_bounds content bounding box
  • validate_animation check consistency

Advanced

13 tools
  • symmetry_draw mirrored drawing
  • interpolate_frames generate in-betweens
  • create_color_ramp gradient palettes
  • animation_preview play in editor
  • flip rotate shift transforms
  • dithering ordered/Floyd-Steinberg
  • reference_image overlay reference
  • autotile_rules tile auto-mapping
  • load_lospec_palette community palettes
  • cross_sprite_copy copy between files

Templates

2 tools
  • character_template pre-configured character sprite
  • tileset_template pre-configured tileset layout

Key Features

Purpose-built for pixel art workflows.

Built-in Pixel Art Intelligence

The AI skill guide teaches proper pixel art technique — clean lines, anti-aliasing rules, limited palettes, and sub-pixel animation. AI doesn't just draw; it draws correctly.

Godot Engine Integration

10 dedicated tools for Godot export. One-click SpriteFrames .tres, AnimationPlayer .tres, AtlasTexture, and TileSet resources. Sync sprites directly to your Godot project folder.

10 Lospec Palettes Built-in

PICO-8, Endesga-32, SLSO8, DB32, Resurrect 64, and more. Load community-curated palettes instantly. Sort by hue, saturation, or lightness. Create color ramps between any two colors.

Frame Interpolation

AI draws key poses, and the interpolation tool generates in-between frames automatically. Speed up animation workflows dramatically — especially for walk cycles and attack animations.

execute_script — Unlimited Power

Run arbitrary Lua scripts inside Aseprite. Anything the scripting API supports, AI can do. Batch operations, custom filters, procedural generation — the sky is the limit.

Full Drawing Toolkit

13 drawing tools: pixels, lines, rectangles, ellipses, flood fill, brush strokes, color replace, outlines. Symmetry drawing for character sprites. Dithering with ordered and Floyd-Steinberg algorithms.

Smart Palette Management

12 palette tools. Import palettes from images, create color ramps, sort colors, find unused entries. Load from Lospec's community library with one command.

Complete Export Pipeline

Export to PNG, sprite sheets (grid or packed), GIF, per-layer, per-tag. Export tilesets with proper spacing. Everything you need to get assets into your game engine.

Animation Workflows

Frame management, tag-based organization, cel linking, duration control, frame reversal. Preview animations directly in Aseprite. Validate animation consistency across layers.

Production-Grade Connection

WebSocket with heartbeat on port 6515. Auto-reconnect with exponential backoff. No file polling, no CLI subprocess spawning. Instant feedback between AI and Aseprite.

What Can AI Do in Aseprite?

Real examples of what you can ask your AI assistant to do.

Create a Character Sprite Sheet

"Create a 32x32 character sprite with idle, walk, and attack animations using the PICO-8 palette."

AI creates the sprite, loads the palette, draws the character frame by frame, organizes with tags, and exports as a sprite sheet ready for your game engine.

Uses: create_sprite load_lospec_palette put_pixel add_frame create_tag export_spritesheet

Build a Tileset for Your Game

"Create a 16x16 tileset with grass, dirt, water, and stone tiles. Add autotile rules for transitions."

AI creates the tileset layout, draws each tile, sets up autotile rules for smooth transitions, and exports in a format ready for Godot or Tiled.

Uses: tileset_template draw_rect flood_fill autotile_rules export_tileset

Animate with Key Poses

"Draw key frames for a sword attack animation, then interpolate the in-between frames."

AI draws the key poses (wind-up, swing, follow-through), then uses frame interpolation to generate smooth in-between frames. Tag the animation and set per-frame durations.

Uses: add_frame put_pixel interpolate_frames set_duration create_tag

Export to Godot in One Command

"Export this sprite as SpriteFrames .tres and sync it to my Godot project at res://assets/player/."

AI exports the tagged animations as a Godot SpriteFrames resource, copies it to your project directory, and you can use it immediately with AnimatedSprite2D.

Uses: export_spriteframes sync_to_project

Palette Exploration

"Load the Endesga-32 palette, analyze which colors I'm using, and remove unused entries."

AI loads the palette, runs color statistics to find which entries are actually used in the sprite, highlights unused colors, and cleans up the palette for you.

Uses: load_lospec_palette color_stats find_unused_colors

Batch Process Sprites

"Run a Lua script that adds a 1px dark outline to every frame in this sprite."

AI writes and executes a Lua script that iterates through all frames, detects edges, and draws a consistent outline — a task that would take ages manually.

Uses: execute_script draw_outline

Frequently Asked Questions

Common questions about Aseprite MCP Pro.

What is Aseprite MCP Pro?

Aseprite MCP Pro is a premium MCP (Model Context Protocol) server that connects AI assistants like Claude, Cursor, and Cline directly to the Aseprite pixel art editor via WebSocket. It provides 121 tools across 16 categories for sprite creation, drawing, layer management, animation, palette management, Godot integration, analysis, and advanced pixel art techniques.

Which AI assistants work with Aseprite MCP Pro?

Any MCP-compatible AI client works, including Claude Code, Claude Desktop, Cursor, VS Code with Cline extension, Windsurf, and other tools that support the Model Context Protocol standard. The MCP protocol is an open standard, so new clients are added regularly.

How do I install it?

Copy the Lua extension into Aseprite's scripts folder, build the MCP server with npm install && npm run build, and add it to your AI client's .mcp.json configuration. The extension connects to the MCP server via WebSocket on port 6515 automatically.

Does it work with Godot?

Yes. Aseprite MCP Pro includes 10 dedicated Godot integration tools. Export SpriteFrames .tres for AnimatedSprite2D, AnimationPlayer .tres resources, AtlasTexture, and TileSet resources. Sync sprites directly to your Godot project folder with one command.

What Aseprite version is required?

Aseprite v1.3 or later with WebSocket and scripting support. Also requires Node.js 18+. Works on Windows, macOS, and Linux.

How much does it cost?

$10 as a one-time purchase. This includes all 121 tools, lifetime updates for v1.x, unlimited projects, unlimited machines, and Discord support. There is no subscription.

Can AI create animations?

Yes. The frame and animation tools let AI create key poses, generate in-between frames with interpolation, set per-frame durations, organize animations with tags, preview results, and export as sprite sheets or GIF. AI handles the repetitive frame-by-frame work while you focus on key poses.

What palettes are included?

10 popular Lospec palettes are built-in: PICO-8 (16 colors), Endesga-32 (32 colors), SLSO8 (8 colors), DB32, Resurrect 64, and more. You can also import palettes from any image, create color ramps between colors, and sort palettes by hue, saturation, or lightness.

Quick Setup Guide

Get up and running in under 5 minutes.

1. Install the Aseprite Extension

Copy the Lua extension file into Aseprite's scripts folder. On Windows this is typically:

%APPDATA%/Aseprite/scripts/

Restart Aseprite. The extension will connect to the MCP server automatically.

2. Build the MCP Server

Open a terminal in the server/ directory:

cd server
npm install
npm run build

3. Configure Your AI Client

Add the server to your AI client's MCP configuration file (e.g., .mcp.json for Claude Code):

{
  "mcpServers": {
    "aseprite-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}

4. Start Creating

Open Aseprite with the extension loaded. Start your AI assistant and begin creating — it now has access to 121 tools for pixel art creation, animation, palette management, and Godot export.

Simple, One-Time Pricing

Pay once, use forever. Lifetime updates for v1.x included.

$10
One-time payment
  • ✓ All 121 tools across 16 categories
  • ✓ 10 Lospec palettes built-in
  • ✓ Godot integration (10 tools)
  • ✓ Lifetime updates (v1.x)
  • ✓ Unlimited projects & machines
  • ✓ Discord support channel
Buy on itch.io — $10 Questions? Join our Discord

Also by us

🎮 Godot MCP Pro
163 AI tools for Godot Engine — $15 → 🗺 Tiled MCP Pro
122 AI tools for Tiled Map Editor →