MCP server + CLI
Ask Claude Code, Codex or Cursor for a character and its moves. SpriteSheetGen generates them and drops a sprite sheet, a JSON atlas and a Godot SpriteFrames file into your project.
Walk cycles made with SpriteSheetGen (the knight's image is our logo art; only its animation is generated).
Set up SpriteSheetGen for me: follow https://spritesheetgen.com/agents/install.txt
It adds the MCP server and an agent skill that knows the tools, budgets and engine imports.npx -y @spritesheetgen/cli loginclaude mcp add spritesheetgen -s user -- npx -y @spritesheetgen/cli mcpcodex mcp add spritesheetgen -- npx -y @spritesheetgen/cli mcp{
"mcpServers": {
"spritesheetgen": {
"command": "npx",
"args": ["-y", "@spritesheetgen/cli", "mcp"]
}
}
}Node.js 20 or newer. The server talks over stdio and reads the key saved by login (or SPRITESHEETGEN_API_KEY), so logging in later needs no restart.
| Tool | Credits | What it does |
|---|---|---|
estimate_sprite | free | Price of a character or an action, your balance and the key's remaining budget |
improve_prompt | free | Turns a rough idea into a character description that generates well (small daily quota) |
create_character | paid | One character image from a description |
upload_character | free | Uses your own PNG, JPEG or WebP character instead |
animate_character | paid | One animation: walk, run, idle, attack or jump |
get_generation | free | Status and result of a generation; can wait for it |
list_characters | free | Characters you generated or uploaded |
list_actions | free | Animations a character already has, so you never pay twice |
export_sprite_sheet | free | Packs a finished animation, or a local GIF, into a folder on your machine |
Your agent estimates first, shows you the price and spends only after you say yes. Every paid call carries a max_credits cap and a client_key, so a retried request is never charged twice. New accounts receive 25 credits; current prices are on the pricing page.
The same features without MCP, with --json output for scripts:
spritesheetgen estimate --description "a small beetle knight" --json
spritesheetgen character --description "a small beetle knight" --client-key my-key-0001 --max-credits 5 --json
spritesheetgen animate --reference generation:CHARACTER_ID --action walk --client-key my-key-0002 --max-credits 10 --json
spritesheetgen export --id ANIMATION_ID --out ./assets/beetle-walk --name walk --individual-frames --preview --json
Packing a GIF you already have needs no key and costs nothing:
npx -y @spritesheetgen/cli export --file ./walk.gif --out ./assets/walk --name hero_walk --preview
The sample export: the knight's walk on a green screen, packed by the CLI (background removed, edges cleaned, frames aligned).
| File | Use it in |
|---|---|
sheet.png | Any engine: frames in a row or a grid, transparent background |
sheet.json | Phaser, PixiJS and other engines that read TexturePacker JSON (hash), with an animations block |
animation.tres | Godot 4: a SpriteFrames resource for AnimatedSprite2D, with speed and looping set |
preview.gif | A quick look |
export.json | The settings used, to repeat the export |
frames/*.png | Unity, GameMaker or any tool that wants single images (--individual-frames) |
this.load.atlas("knight", "sheet.png", "sheet.json");
this.anims.create({
key: "walk",
frames: this.anims.generateFrameNames("knight", { prefix: "knight_walk_", end: 11, zeroPad: 2 }),
frameRate: 14,
repeat: -1,
});
Put sheet.png and animation.tres in the same folder, add an AnimatedSprite2D and drag animation.tres onto its Sprite Frames property.
Everything above also works on spritesheetgen.com, plus free tools that run on your device: video to sprite sheet, GIF to sprite sheet, sprite sheet maker, sprite sheet cutter and sprite sheet to GIF.