Aseprite Agent MCP
Local pixel-art authoring with Aseprite: atomic edits, previews and verified Phaser export
- Pricing
- Open source
- Platforms
- CLI, Windows, macOS
- Runs
- Locally
- Version
- 0.3.0
- Listing updated
- 2 days ago
About Aseprite Agent MCP
Aseprite Agent MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add aseprite-agent-mcp --env ASEPRITE_PATH='<ASEPRITE_PATH>' -- uvx aseprite-agent-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"aseprite-agent-mcp": {
"command": "uvx",
"args": [
"aseprite-agent-mcp"
],
"env": {
"ASEPRITE_PATH": "<ASEPRITE_PATH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"aseprite-agent-mcp": {
"command": "uvx",
"args": [
"aseprite-agent-mcp"
],
"env": {
"ASEPRITE_PATH": "<ASEPRITE_PATH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"aseprite-agent-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"aseprite-agent-mcp"
],
"env": {
"ASEPRITE_PATH": "<ASEPRITE_PATH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"aseprite-agent-mcp": {
"command": "uvx",
"args": [
"aseprite-agent-mcp"
],
"env": {
"ASEPRITE_PATH": "<ASEPRITE_PATH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"aseprite-agent-mcp": {
"command": "uvx",
"args": [
"aseprite-agent-mcp"
],
"env": {
"ASEPRITE_PATH": "<ASEPRITE_PATH>"
}
}
}
}Configuration
ASEPRITE_PATHPath to your licensed Aseprite executableRequiredASEPRITE_MCP_WORKSPACERoot directory for asset filesASEPRITE_MCP_TOOLSTool profile, default coreASEPRITE_MCP_LOCK_WAITSeconds to wait for a busy workspace
What it does
- 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
Pricing
Open source
Requires a separately licensed Aseprite
Prices change. Check pypi.org before you buy.
Aseprite Agent MCP 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 to Aseprite Agent MCP

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media