# Aseprite Agent MCP

> Aseprite Agent MCP is an open-source MCP server for design and media. Local pixel-art authoring with Aseprite: atomic edits, previews and verified Phaser export. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://pypi.org/project/aseprite-agent-mcp/
- **Repository:** https://github.com/sarutobisasuke8/aseprite-agent-mcp
- **MCP Registry name:** io.github.SarutobiSasuke8/aseprite-agent-mcp
- **Categories:** design and media, games and play
- **Listing updated:** 2026-11-15

## About

This server drives your own licensed copy of Aseprite rather than bundling it; you point ASEPRITE_PATH at the executable and it runs Aseprite's Lua scripting. The README labels it an alpha and says it builds on the MIT-licensed aseprite-mcp project, adding a production layer on top.

That layer provides atomic edits that return image feedback, strict typed asset contracts, labelled previews of all frames, character-cast tools, workspace locking and crash-safe saves. Game assets can be exported as Phaser bundles that are verified against reopened native master files. In total 114 tools cover documents, drawing, layers, cels, frames, palettes, tags, slices, transforms, tilemaps and exports.

Because every tool schema costs agent context, the default profile exposes only 42 core tools. Setting ASEPRITE_MCP_TOOLS to all, a single group such as tilemap or palette, or an extra tool name widens it. It needs Python 3.10 or newer with uv or pipx, and an optional workspace directory for asset files.

## Features

- **Atomic edits:** Edits with image feedback and previews.
- **Phaser export:** Bundles verified against reopened native master files.
- **Tool profiles:** A 42-tool core set by default, or all 114 tools or one group.
- **Asset contracts:** Strict typed contracts for game assets.
- **Safe saves:** Workspace locking and crash-safe saves protect files.

## Good for

- Have an agent draw and animate a sprite
- Build a character cast with consistent assets
- Export verified sprite sheets for a Phaser game
- Edit palettes, layers and tilemaps from a chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add aseprite-agent-mcp --env ASEPRITE_PATH='<ASEPRITE_PATH>' -- uvx aseprite-agent-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aseprite-agent-mcp": {
      "command": "uvx",
      "args": [
        "aseprite-agent-mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "<ASEPRITE_PATH>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aseprite-agent-mcp": {
      "command": "uvx",
      "args": [
        "aseprite-agent-mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "<ASEPRITE_PATH>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aseprite-agent-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aseprite-agent-mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "<ASEPRITE_PATH>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aseprite-agent-mcp": {
      "command": "uvx",
      "args": [
        "aseprite-agent-mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "<ASEPRITE_PATH>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aseprite-agent-mcp": {
      "command": "uvx",
      "args": [
        "aseprite-agent-mcp"
      ],
      "env": {
        "ASEPRITE_PATH": "<ASEPRITE_PATH>"
      }
    }
  }
}
```

## FAQ

### Do I need Aseprite?

Yes, your own licensed copy with Lua scripting support. The package does not bundle it.

### How many tools does it expose?

42 in the default core profile and 114 with the all profile.

### What is its maturity?

The README describes it as an alpha.

### What do I need to run it?

Python 3.10 or newer, uv or pipx, and ASEPRITE_PATH set.

### Is Aseprite Agent MCP free?

Yes. Aseprite Agent MCP is open source, so you can use and self-host it for free.

### How do I add Aseprite Agent MCP to Claude Code?

Run this command in your terminal: claude mcp add aseprite-agent-mcp --env ASEPRITE_PATH='<ASEPRITE_PATH>' -- uvx aseprite-agent-mcp

### What are the best alternatives to Aseprite Agent MCP?

The closest alternatives to Aseprite Agent MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/aseprite-agent-mcp
