# Aseprite Mcp Pro

> Aseprite MCP Pro — AI-powered pixel art creation for Aseprite via Model Context Protocol. 121 tools for sprites, drawing, animation, palettes, export, and Godot integration.

- **Type:** MCP server
- **Install:** `agentstack add mcp-youichi-uda-aseprite-mcp-pro`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [youichi-uda](https://agentstack.voostack.com/s/youichi-uda)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [youichi-uda](https://github.com/youichi-uda)
- **Source:** https://github.com/youichi-uda/aseprite-mcp-pro
- **Website:** https://aseprite-mcp.abyo.net/

## Install

```sh
agentstack add mcp-youichi-uda-aseprite-mcp-pro
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Aseprite MCP Pro

AI-powered pixel art creation with Aseprite via the Model Context Protocol.

**96 tools** for complete control over sprites, layers, animations, palettes, and export — with built-in Godot Engine integration.

## What is Aseprite MCP Pro?

Aseprite MCP Pro connects AI assistants (Claude, etc.) directly to your running Aseprite editor. The AI can create sprites, draw pixel art, manage animations, manipulate palettes, and export for game engines — all through natural language.

### Tool Categories

| Category | Tools | Description |
|----------|-------|-------------|
| Sprite | 12 | Create, open, save, resize, crop, screenshot |
| Layer | 10 | Full layer stack control with groups and blend modes |
| Frame | 8 | Animation frame management and duration |
| Cel | 5 | Cel positioning, opacity, linking |
| Drawing | 13 | Pixels, lines, rectangles, ellipses, flood fill, brush strokes |
| Selection | 7 | Rectangle, ellipse, by-color, invert |
| Palette | 10 | Full palette manipulation, auto-generate |
| Tag | 6 | Animation tags with direction and repeat |
| Slice | 5 | Named regions, 9-patch, pivot points |
| Tilemap | 5 | Tilemap layers and tileset management |
| Export | 6 | PNG, sprite sheets, GIF, per-layer, per-tag |
| Godot | 8 | SpriteFrames .tres, AtlasTexture, TileSet generation |
| Analysis | 5 | Color stats, frame diff, animation validation |

## Architecture

```
AI Client (Claude Code, etc.)
    ↕ stdio / MCP Protocol
Node.js MCP Server
    ↕ WebSocket
Aseprite Lua Extension (this repo)
    ↕ Aseprite Scripting API
Aseprite Editor
```

## Installation

### Free Version (Extension Only)

This repository contains the Aseprite Lua extension. To use it, you need the MCP server component.

1. Download or clone this repository
2. Copy the `extension/` folder to your Aseprite extensions directory:
   - **Windows**: `%APPDATA%\Aseprite\extensions\aseprite-mcp-pro\`
   - **macOS**: `~/Library/Application Support/Aseprite/extensions/aseprite-mcp-pro/`
   - **Linux**: `~/.config/aseprite/extensions/aseprite-mcp-pro/`
3. Restart Aseprite

### Full Version (Extension + Server)

Get the complete package with the MCP server at:

**[Buy Me a Coffee](https://buymeacoffee.com/)** (coming soon)

## Godot Integration

Works alongside [Godot MCP Pro](https://godot-mcp.abyo.net/) for a complete AI-driven game art pipeline:

1. Create & animate sprites in Aseprite via AI
2. Auto-export sprite sheets + `.tres` SpriteFrames resources
3. Import directly into your Godot project

## Related Projects

- [Godot MCP Pro](https://godot-mcp.abyo.net/) — AI-powered Godot development (163 tools)
- [Tiled MCP Pro](https://tiled-mcp-pro.abyo.net/) — AI-powered tile map editing (122 tools)

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [youichi-uda](https://github.com/youichi-uda)
- **Source:** [youichi-uda/aseprite-mcp-pro](https://github.com/youichi-uda/aseprite-mcp-pro)
- **License:** MIT
- **Homepage:** https://aseprite-mcp.abyo.net/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-youichi-uda-aseprite-mcp-pro
- Seller: https://agentstack.voostack.com/s/youichi-uda
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.