ASEPRITE MCPLive and staged

AI pixel art that stays editable in Aseprite

SpriteRelay connects your AI assistant to Aseprite. It builds and edits real .aseprite files, with layers, frames, animation tags and palettes, live in the open editor or staged for safe batch work.

  • One-time purchase
  • Runs locally
  • No account
  • Licensed Aseprite required
kobold-hood-staff-venom.asepriteReal export
Five kobold enemy variants in different elements and gear.

attack · staff

Layers

  1. Aura
  2. Effects
  3. Staff · front
  4. Head · hood
  5. Body
  6. Staff · back
  7. Shadow

Palette · 48 slots

Tags

  • idle 4f
  • walk 6f
  • attack · staff 6f
  • hurt 3f
  • death 6f

Tag data {"spawn":3,"muzzle":"muzzle · staff","projectile":"bolt","speed":140,"note":"spawn the projectile on this frame at the muzzle slice's pivot; speed in px/s"}

Open the file

Not a picture of a sprite. The sprite.

One of 100 kobold enemies an AI agent built through SpriteRelay, playing from its real exported sheet. The layers, the 48-colour palette, the tags and the hitbox data are read from the file.

builds published
13
.aseprite files, built step by step
33
frames, every one a real export
2,485
named, editable layers
300

Setup routes for Claude, Codex, Cursor, VS Code and other stdio MCP clients. See the setup guide

A cozy room at night: a stone fireplace, a bed, an armchair, and a window with rain and a lighthouse outside.
A frame from Cozy rainy night: 480×270, 11 layers, 672 frames in one file.

Real pixels

Zoom in. Every pixel is on the grid.

Image generators paint something that looks like pixel art. SpriteRelay gives your assistant the file itself: one colour per pixel, a real palette, named layers, frame timings and animation tags. You can open it, recolour it, and keep drawing.

  • Layers, frames, tags, slices, palettes and tilemaps
  • Exports: sheets with JSON, GIFs, atlases, palette variants
  • Every change is reviewable before it becomes permanent

Move over the picture to look closer.Tap the picture to look closer.

Play

Play with the real exports

These pages load the actual exported sheets and data, so what you play is what the file contains.

How it works

See the change. Review it. Keep it, or recover.

New to MCP? Read the Aseprite MCP guide.

  1. Understand the document

    Inspect layers, frames, tags, linked cels, palettes, and available capabilities.

  2. Apply a validated change

    Use structured operations in the open document or a staged working copy.

  3. Review the result

    Render previews, compare changes, and inspect animation behaviour before accepting it.

  4. Keep or recover

    Undo an existing-document Live patch, or explicitly commit and roll back staged work.

LIVE

Live Aseprite editing

Use an AI assistant to inspect and change the active document while Aseprite remains open, see the result immediately, then continue or undo without leaving the editor.

Existing-document patches form one labelled native undo step. Creating a new document is the exception.

Watch the Live demo

CLI

Staged Aseprite automation

Run batch sprite workflows in a retained temporary working copy: inspect, patch, preview, and export before choosing what is written to a production path.

file_commit is the only caller-path writer. It supports backups when overwriting, durable manifest journals, journal-based post-commit verification, and rollback.

Watch the CLI demo

Pricing

Choose Live, staged, or both

No subscription. Pay once, keep the version you bought.

Staged production

SpriteRelay CLI

$7.99 once

Work in a retained staged copy so project files change only when you explicitly commit.

  • Aseprite does not need to remain open
  • Preview before writing to a project path
  • Backups when overwriting, plus manifest journals, verification, and rollback
Get CLI — $7.99

Immediate editing

SpriteRelay Live

$11.99 once

Inspect and change the document already open in Aseprite, see the result immediately, then continue or undo.

  • Requires open Aseprite and the matched Bridge
  • One labelled undo step per existing-document patch
  • Guarded export remains an explicit action
Get Live — $11.99

One-time USD prices, licensed per natural person. Aseprite is required and licensed separately. Complete is a digital download with automatic access after successful payment. No shipping charges.

Choose with confidence

QuestionSpriteRelay CLISpriteRelay Live
Must Aseprite be open?No. It launches licensed Aseprite in batch mode.Yes. It works with the running editor and active document.
Where do edits happen?In a retained temporary working copy.Immediately in the attached document.
How do I recover?Discard staged work before commit. Overwrites create backups; manifest commits add durable journals, verification, and rollback.One labelled native undo step for an existing-document patch. Creating a new document is outside existing undo history.
Best forRepeatable batch production, exports, and controlled release work.Visual iteration in the document already open in Aseprite.

Included with your purchase

You receive the files for the product you choose. Complete includes both private packages and the matched Live Bridge. Read the setup guide

Private release packages
One or both .tgz files, according to your purchase.
Matched Aseprite extension
The Live Bridge, included with Live and Complete.
Documentation and checksums
Install, pairing, recovery, notices, and AI-assisted setup guidance.
Per-user major-version entitlement
Includes updates within the same major version if released; a future major version may be priced separately.

Why SpriteRelay

Keep your Aseprite projects editable, reviewable, and ready to ship

Use Live for immediate visual decisions and CLI for controlled production changes without giving up source structure or a clear recovery path.

Preserve document structure

Work with layers, frames, tags, palettes, and linked cels. When supported and enabled, persistent UUIDs keep layer targeting reliable after renames or reordering.

Automate the work around each sprite

Compose reusable parts, generate palette variants, edit tilemaps, audit animations, and build repeatable export recipes.

Catch problems before delivery

Find empty or duplicate frames, inspect timing, compare rendered changes, and preview outputs before keeping them.

Use validated actions

No raw-Lua or arbitrary-code channel is exposed through either product.

Technical interface

Broad capability. A compact MCP surface.

SpriteRelay groups a wide Aseprite operation set into a small number of purpose-built tools, helping agents choose the right action without navigating hundreds of endpoints or exposing an arbitrary-code channel.

Top-level tools across CLI and Live
6+6
Patch operations in the CLI public inventory
166
Patch operations in the Live public inventory
216

Six purpose-built tools group typed operation families behind clear boundaries. This is designed to reduce tool-schema context and repeated definition tokens while making operation selection clearer; actual token use depends on the MCP client, model, and request. Inventory counts include reserved and capability-gated entries.

Read the technical reference

Questions

Know what you are buying

Still unsure? Email support@spriterelay.com before you spend anything.

What is SpriteRelay?

SpriteRelay is local Aseprite MCP software. Live edits the active document through the matched Bridge; CLI stages batch automation before an explicit production commit.

What is Aseprite MCP?

It is a Model Context Protocol workflow that gives a compatible AI assistant structured tools for Aseprite. Read the Aseprite MCP guide.

What is the difference between Live and CLI?

Live targets the document open in Aseprite for immediate iteration. CLI works in a staged copy for batch and controlled production work, with preview and explicit commit. Overwrites create backups, while manifest commits support durable journals, verification, and rollback.

What software does SpriteRelay require?

You need Node.js 18 or newer, your own licensed Aseprite installation, and an MCP client that supports local stdio servers. Live also requires Aseprite to remain open with the matched Bridge installed. See the setup guide.

Is this an AI image generator?

No. SpriteRelay gives your AI assistant structured tools to build and edit real .aseprite files: layers, frames, tags, palettes, tilemaps and exports. The pixels are placed on Aseprite's own grid, and the file stays editable by you afterwards.

Is the licence per user?

Yes. One licensed person may use SpriteRelay on multiple devices they control. Each additional direct user needs a licence unless separate written team or site terms apply. The EULA controls.

Which updates are included?

A licence includes updates within the same major version if released. A future major version may require another purchase, and no future update is promised. See the update terms.

What is the refund policy?

Direct buyers may request a refund within 14 days. For immediately delivered digital content, that right may end after delivery begins if the buyer consented and acknowledged the loss of the right. Storefront terms and mandatory law also apply; see the refund terms.

What support is included?

Best-effort installation, compatibility, documentation, and reproducible-bug support may be available at support@spriterelay.com. Response and resolution times are not guaranteed.

Which Aseprite versions are supported?

The current CLI baseline is Aseprite 1.3.18.1 with Lua API 40. Live requires Aseprite 1.3-rc5 or newer with Lua API 25 or newer. Version-sensitive CLI features are capability-gated.

What does SpriteRelay Complete contain?

Complete contains SpriteRelay Live, SpriteRelay CLI, and the matched SpriteRelay Live Bridge under one per-user licence.

What happens if a Live edit is interrupted?

An interrupted mutation is marked uncertain and is never silently replayed. Inspect the document and undo if needed before continuing.

Will it overwrite my source files?

CLI changes staged copies until file_commit. Live patches the open document but does not save it to disk; existing-document patches form one undo step, with new-document creation as the exception. Permanent exports require an explicit commit; manifest commits use durable journals.

Does SpriteRelay upload my artwork?

SpriteRelay itself does not upload artwork during ordinary use; core processing and optional diagnostics stay on your device. Your MCP client or AI provider may process data under its own privacy terms. Read how SpriteRelay handles local processing or the privacy terms.

Can the agent execute arbitrary Lua?

No. Both products accept validated operations; neither exposes a raw-Lua or arbitrary-code channel.

Live when creating. Staged when shipping.

Put Aseprite inside your AI workflow without giving up control.

Get Complete — $14.99

One-time, per-user purchase. Aseprite licensed separately. EULA terms apply.