Local Aseprite MCP // Live + Staged

Aseprite MCP server for live editing and staged automation

Edit live. Stage safely. Stay in control.

Connect a compatible AI assistant or agent to editable .aseprite projects through local Model Context Protocol software. Edit the open document with Live, or inspect, preview, commit, and verify through CLI's staged production workflow.

  • Local software
  • One-time purchase
  • Licensed Aseprite required
A lakeside landscape cycling through dawn, noon, dusk and storm skies.
Four Skies
LiveWork in the open documentImmediate preview + native undo
CLIProtect the production fileStaged preview + verified commit

Control at every step

See the change. Review the result. Keep it—or recover.

  1. 01

    Understand the document

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

  2. 02

    Apply a validated change

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

  3. 03

    Review the result

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

  4. 04

    Keep or recover

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

Live

Immediate visual control

Work in the document already open in Aseprite. Existing-document patches form one labelled native undo step; new-document creation is the exception.

CLI

A controlled production boundary

Work in a retained staged copy, then explicitly commit. Overwrites create backups; manifest commits add durable journals, verification, and rollback.

Buyer confidence

Know where every change goes.

01 // Editable sourceKeep the project structureWork with real .aseprite layers, frames, tags, palettes, and linked cels.
02 // Live recoveryUndo the complete patchExisting-document patches form one labelled native undo step; new-document creation is the exception.
03 // CLI boundaryReview before committingPreview staged work before an explicit commit to a project path; manifest commits add a durable journal for later verification and rollback.
04 // Operation safetyUse validated actionsNo raw-Lua or arbitrary-code channel is exposed through either product.

One-time pricing

Choose Live, staged, or both.

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.

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 labeled 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

Ready for local setup.

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

Package filesPrivate release packagesOne or both .tgz files, according to your purchase.
Live BridgeMatched Aseprite extensionIncluded with Live and Complete.
Setup materialsDocumentation and checksumsInstall, pairing, recovery, notices, and AI-assisted setup guidance.
Licence and updatesPer-user major-version entitlementIncludes updates within the same major version if released; a future major version may be priced separately.

Watch SpriteRelay in Aseprite.

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.

Live workflow

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 workflow

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
Both workflows

Verify before you keep the result

Read document structure, render previews, compare changes, and inspect animation behavior before accepting or delivering work.

Use immediate visual feedback in Live or review staged artifacts in CLI.

Editable sourcePreserve document structureWork with layers, frames, tags, palettes, and linked cels. When supported and enabled, persistent UUIDs keep layer targeting reliable after renames or reordering.
Repeatable productionAutomate the work around each spriteCompose reusable parts, generate palette variants, edit tilemaps, audit animations, and build repeatable export recipes.
Visual checksCatch problems before deliveryFind empty or duplicate frames, inspect timing, compare rendered changes, and preview outputs before keeping them.

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.

6 + 6Top-level tools across CLI and Live
166Patch operations in the CLI public inventory
216Patch operations in the Live public inventory
UnderstandRead the document and environment.
ChangeApply validated sprite operations.
ReviewRender and compare visual results.
DeliverExport or commit explicit outputs.
RecoverUndo, verify, journal, or roll back.
Why compact matters

Less overhead. More room for the task.

Six purpose-built tools group typed operation families behind clear boundaries, giving the agent fewer top-level routes to evaluate.

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.
01Less context overheadFewer top-level definitions compete with project instructions.
02Less token overheadA compact surface is designed to reduce repeated tool-description tokens.
03Clearer operation choiceTyped families, validation, and capability gates narrow valid actions.

Frequently asked questions

Know what you are buying.

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.

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.