SpriteSheetGen logoSpriteSheetGen

Game Asset Generator MCP

Ask your AI coding agent for a game character and its animations. SpriteSheetGen generates them, and the sprite sheet is packed on your machine, straight into your project.

1. Paste this into Claude Code, Codex or another agent with MCP

Set up SpriteSheetGen for me: follow https://spritesheetgen.com/agents/install.txt

2. Create an API key, then run this in your own terminal and paste the key there

npx -y @spritesheetgen/cli login
Create an API keyThe key never goes into the chat. A new key cannot spend until you give it a budget.

What the game assets MCP does

It gives your agent nine tools. The agent turns your description into a character image (or animates an image you made), adds one action at a time and packs the result into files your engine reads:

  • sheet.png: every frame in a grid on a transparent background

  • sheet.json: TexturePacker JSON with frame rectangles and the animation, read by Phaser and most engines

  • animation.tres: a Godot 4 SpriteFrames resource you assign to an AnimatedSprite2D

  • export.json: frame size, frame count and fps, plus single frames and a preview GIF on request

Eight-frame walk cycle of a chibi knight with a red cape and round shield, made through the MCP server and packed into a transparent sprite sheet
Made by an agent through this MCP server: “a small knight with a red cape and a round shield”, then a walk animation, exported as an 8-frame transparent sheet (shown at half size).

How it works

1. Install with one prompt

Paste the prompt above into your agent. It reads install.txt, installs the skill that teaches it the workflow, and adds the MCP server, with no key in its configuration.

2. Give it a key with a budget

Create a key on your account page, tick “Generate characters and actions” and set how many credits it may spend per day and in total. Then run npx -y @spritesheetgen/cli login in your own terminal and paste the key; it is stored for your user only.

3. Ask for what your game needs

For example: “Make a knight with walk and attack animations for my Godot project.” The agent checks what you already have, shows the price and waits for your yes before it spends anything.

4. Files land in your project

Each animation is exported into a new folder, for example assets/sprites/knight_walk. Nothing you already have is overwritten.

The tools

ToolCreditsWhat it does
estimate_spritefreePrice of a character or an action, your balance and the key's remaining budget
create_character5A character image from a description
animate_character10One animation of a character: walk, run, idle, attack or jump
get_generationfreeStatus and result of a generation
list_charactersfreeCharacters you generated or uploaded
list_actionsfreeAnimations a character already has
improve_promptfreeTurns a rough idea into a description that generates well
upload_characterfreeYour own PNG, JPEG or WebP character, ready to animate
export_sprite_sheetfreePacks an animation into a sprite sheet on your machine

MCP for game development, without surprises on the bill

  • The key's own daily and total budget is the hard limit. A new key has a budget of 0.

  • Every paid call carries the price you approved; if the price is higher, nothing is charged.

  • A retry after a timeout reuses the same purchase key, so the same request is never charged twice.

  • A failed generation returns credits to your balance; it does not restore the key's used budget. Exports, listings and estimates are free.

Manual setup

If you prefer to set it up yourself (Node.js 20 or newer):

  • Claude Code: claude mcp add spritesheetgen -s user -- npx -y @spritesheetgen/cli@latest mcp

  • Codex: codex mcp add spritesheetgen -- npx -y @spritesheetgen/cli@latest mcp

  • Cursor and other MCP clients (mcp.json): { "mcpServers": { "spritesheetgen": { "command": "npx", "args": ["-y", "@spritesheetgen/cli@latest", "mcp"] } } }

  • The skill: npx -y @spritesheetgen/cli@latest skill install --dir ~/.claude/skills (or ~/.codex/skills)

  • The key: npx -y @spritesheetgen/cli login

The same commands work without MCP: npx -y @spritesheetgen/cli --help. The package is @spritesheetgen/cli on npm.

Putting the sprites into your engine

  • Godot 4: set an AnimatedSprite2D's Sprite Frames to animation.tres and play the animation.

  • Phaser 3: load sheet.png and sheet.json with this.load.atlas.

  • Unity: slice sheet.png by cell size using the frame size in export.json.

  • GameMaker: use Import Strip and set frame count, frames per row (columns) and frame size from export.json.

Already have animations as GIFs or videos? The free GIF to sprite sheet and video to sprite sheet tools pack them in the browser.

FAQ

Which agents does it work with?

Any agent that supports MCP servers over stdio: Claude Code, Codex, Cursor and others. Claude Code and Codex also get the skill, which teaches them to estimate first and ask before spending.

Does my agent see my API key?

The login workflow does not send the key to chat, MCP configuration or tool answers. It is stored under your local user account; an agent with access to those files may still read it. Keep the key out of chat and give it only the budget it needs.

What does it cost?

A character image is 5 credits and each animation 10 credits, the same as on the website. New accounts get 25 free credits. Exporting, listing and estimating are free.

Can I animate my own character art?

Yes. The agent can upload a PNG, JPEG or WebP you made or are licensed to use, then animate it like a generated character.

Where are the sprite sheets made?

On your machine, by the same code the website uses. The server only generates the character and the animation; packing, background removal and pixelation run locally.

Can my agent spend more than I allow?

No. Each key has its own daily and total credit budget, checked on the server. When it is used up, the agent gets an error and has to ask you.

More free sprite tools

  • Video to Sprite Sheet

    Turn an MP4 or WebM clip into a clean, aligned sprite sheet with a transparent background.

  • GIF to Sprite Sheet

    Split an animated GIF into frames and pack them into an engine-ready sprite sheet.

  • Sprite Sheet Maker

    Pack separate PNG frames into one sprite sheet with a JSON atlas and Godot resource.

  • Sprite Sheet to GIF

    Preview a sprite sheet as a looping animation and export a transparent GIF.

  • Sprite Sheet Cutter

    Slice a sprite sheet into individual PNG frames by grid, with automatic grid detection.

  • AI Sprite Sheet Generator

    Create an animated character from a text description with AI credits.