Call this FIRST. Returns the exact Arena.ai Agent workflow, tool order, the golden rules of pixel art and a ready-to-use example. No source reading needed.

Returns the binding policy: agents MUST only call MCP tools and MUST NOT modify repository code. Also reports source-integrity status. Read this before doing anything else.

SHA-256 check of every tracked source/config file against integrity/manifest.json. Use it to prove no agent edited the code. If clean=false, STOP and ask the human to restore.

List all built-in curated pixel-art palettes with roles and hex colors. Use the name with sprite_new_project or sprite_palette.

Inspect the active palette, switch to a built-in one, or install a custom palette. Also lists all semantic color roles for the current project.

Create an indexed pixel-art project: canvas size, palette, frames and layers. Always call this first. Classic sizes: 16×16 icons, 32×32 characters, 64×64 bosses.

List all projects currently held in the server session (shared across stdio and HTTP connections).

Inspect the whole project state: size, palette, roles, frames, durations, layers and tags.

Make a project the active one, so later calls can omit the project argument.

Remove a project from the in-memory session (does not delete exported files).

Add / remove / rename / show / hide / lock layers, or set layer opacity (opacity uses ordered dithering, never new colors). Layers exist per frame.

THE PRIMARY DRAWING TOOL for LLMs. Write the sprite as text rows; each character maps to a color via legend. "." / space = transparent. Use "---" on its own line between grids to create several animation frames in one call. Example: grid:"..ooo..\n.osssso.\n..ooo..", legend:{o:"outline",s:"skin"}. If legend is omitted, characters are auto-mapped to palette roles (outline, shadow, base, light, highlight, accent...).

Vector-ish pixel ops, all snapped to integer pixels. Ops: clear, pixel(s), rect, line, circle/ellipse, polygon, fill (flood), dither, gradient, noise, scatter, replace, outline, shade, mirror, shift, text (3×5 font), crop. Example ops:[{op:"rect",x:4,y:4,w:8,h:8,color:"base"},{op:"shade",light:"nw"},{op:"outline",color:"outline",mode:"selective"}]. The "shade" op adds hue-shifted light/shadow; "outline" adds a real silhouette outline.

One-call, seeded, hand-designed pixel-art recipes. Kinds: hero, slime, potion, gem, chest, sword, shield, tree, mushroom, ghost, coin, star, torch, planet, cloud, heart, portrait, tile_grass, tile_stone, tile_brick, tile_water, tile_lava. Animated kinds (slime/ghost/coin/star/torch/tile_water/tile_lava) create a full looping timeline automatically. Call sprite_catalog for the full list.

List every generator, animation preset, palette, built-in font character and available export format. Use it to discover capabilities instead of reading source files.

add / duplicate / delete / rename / select / set_duration / tag / reorder frames. Index is 0-based.

Build a full animation timeline from the active frame. Presets: idle_bob, walk_cycle, blink, pulse, squash_stretch, spin, shake, wave, flicker, explode, jump, glow, hue_cycle, float. Integer/nearest-neighbour only — never blurred. Example: {preset:"idle_bob", frames:6, durationMs:120, amplitude:1}.

Create intermediate frames between two keyframes using ordered-dither cross dissolve (pixel-art correct, no alpha blur). Example: {from:0,to:2,steps:3}.

Set a constant fps (10–12 fps is the pixel-art sweet spot), a constant duration, or per-frame durations. Example: {fps:10}.

pingpong (seamless back-and-forth), reverse, hold (freeze each frame N times) or deduplicate (remove identical frames). Example: {mode:'pingpong'}.

One-click pro polish: despeckle jaggies, enforce palette economy, add a selective dark outline, apply hue-shifted light/shadow (cool shadows, warm highlights), fix symmetry and center the silhouette. Example: {outline:true, shade:true, despeckle:true, limitColors:16}.

Scores color economy, silhouette, outline, shading and animation (0–100, grade S–D) and returns concrete next tool calls. Use it before exporting.

Return the frame as an ASCII grid + legend + color histogram. Perfect for text-only reasoning and for iterating on a specific frame without vision.

Render the sprite as an INLINE PNG image content block so you (the agent) can actually SEE the art. Use 'all' to get a contact sheet of the whole animation. Returns a text summary too.

Write real files (never source files). formats: png (per frame), gif, apng (lossless animated PNG), svg (animated), spritesheet (PNG + atlas JSON), gpl, css, json (project), gallery. Example: {formats:["png","gif","spritesheet","apng"], scale:8, atlas:"aseprite"}. Returns absolute paths and an inline preview.

Write a fully self-contained HTML animation player (inline base64 PNGs, playback controls, onion skin, zoom, palette swatches, frame tags). Works offline and in a sandboxed preview.

Serialize the full project (palette, layers, all frames, durations) to a .spriteproj.json inside the output root. Load it later with sprite_load_project.

Load a .spriteproj.json exported by sprite_save_project. Path is relative to the output root, or an absolute path to a project JSON file. Reading is safe; writing is still guarded.