Skip to content
MCP server

Aseprite Agent MCP

Local pixel-art authoring with Aseprite: atomic edits, previews and verified Phaser export

Runs locallyStatus and history
Install
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-mcp

Add 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 executableRequired
  • ASEPRITE_MCP_WORKSPACERoot directory for asset files
  • ASEPRITE_MCP_TOOLSTool profile, default core
  • ASEPRITE_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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media