SpriteLab MCP Server

Overview

The SpriteLab MCP server exposes every generation mode as tools for Claude Code, Cursor, Claude Desktop, Windsurf and any other MCP client — generate pixel art without leaving your editor or agent.

Same key, same billing

The MCP server sits on top of the REST API: your sl_live_… key, top-up credits only, automatic refunds on failure, and the same subscriber gate on Micro, Reskin and Backgrounds.

Setup

Endpoint: https://spritelab.dev/mcp (streamable HTTP).

Claude Code

terminal

claude mcp add --transport http spritelab https://spritelab.dev/mcp \
  --header "Authorization: Bearer sl_live_YOUR_KEY"

Cursor / Windsurf / generic

mcp.json

{
  "mcpServers": {
    "spritelab": {
      "url": "https://spritelab.dev/mcp",
      "headers": { "Authorization": "Bearer sl_live_YOUR_KEY" }
    }
  }
}

claude.ai web connectors need OAuth, which we don't support yet; use the key-header clients above.

Tools

Thirteen tools, one per generation mode plus the free iteration and probe calls. Costs and the subscriber gate are identical to the REST API.

Tool	Cost	What it does
`generate_sprite`	1 / 6 CR	Text to sprite: transparent bg, clean palette, 1px outline
`generate_sprite_pack`	2 / 9 CR	A whole grid of sprites in one call, split into individual PNGs. Cheapest per sprite
`generate_rotation`	4 / 15 CR	4-direction rotation sheet (front/right/back/left) for characters & mobs: frames + spritesheet + GIF
`resize_sprite`	Free	Re-render any generated sprite at a new size or tuning. The iteration loop
`convert_image`	3 CR	Any image to faithful pixel art
`micro_sprite`	3 / 10 CR	Exact-size 16-64px sprites on a true pixel grid (subscribers)
`reskin_sprite`	2 / 6 CR / variant	Themed variants of an existing sprite, identical dimensions (subscribers)
`generate_background`	4 / 15 CR	Full-frame scene art up to 8K (subscribers)
`generate_tileset`	10 / 30 CR	Autotiling tileset + drop-in Godot 4 & Tiled files (subscribers)
`animate_sprite`	20 CR	Submit an animation job (async)
`check_animation_job`	Free	Poll an animation job; returns spritesheet + GIF URLs when done
`get_credits`	Free	Balance + tier
`enhance_prompt`	Free	Rewrite a rough subject into a stronger sprite prompt

Saving results to disk

Tool results are deliberately compact: a small JSON summary, a preview image when it's tiny, and a download_url. Your agent saves the real asset with the same key:

terminal

curl -H "Authorization: Bearer sl_live_YOUR_KEY" \
  "https://spritelab.dev/api/v1/sprites/SPRITE_ID/download" \
  --output assets/sprites/knight.png

So prompts like this just work in Claude Code:

> generate a 64px armoured knight sprite and save it to
  assets/sprites/knight.png, then make ice and lava variants
  of it in the same folder

Notes for agents

For a coherent set, generate the hero first and pass its sprite_id as style_reference_id on later generate_sprite calls: palette and proportions match automatically.
Prefer epic quality unless the user asks for better; it's a sixth of the cost and usually enough.
Iterate with resize_sprite (free), not by regenerating.
animate_sprite returns immediately; poll check_animation_job every 4-5 seconds, typical total 60-120s.
Every result reports credits_remaining; failed generations refund automatically.
Rate limit: 60 requests per minute per key, shared with the REST API.

Billing

Identical to the REST API: top-up (purchased) credits only, the monthly subscription bucket is never touched, and Micro / Reskin / Backgrounds need an active subscription. Full cost table lives in the API billing section. Key issuing is invite-only during the private beta — ask in the Discord.