The AutoSprite MCP (Model Context Protocol) server connects your AI coding assistant directly to AutoSprite. Describe a character in chat and your assistant can create it, animate it, and export a game-ready sprite sheet — without leaving your editor. MCP access is included with a **subscription plan**. Create your key on the [API Keys page](/app/api-keys) — the same key works for both MCP and the REST API. ## Setup Create a key on the [API Keys page](/app/api-keys). Your key starts with `vspk_`. Add AutoSprite to your editor's MCP config. For **Claude Code** (`~/.claude.json`): ```json { "mcpServers": { "autosprite": { "type": "http", "url": "https://www.autosprite.io/api/mcp", "headers": { "Authorization": "Bearer vspk_your_key_here" } } } } ``` Other editors use the same URL with a slightly different config shape — the [MCP setup page](/mcp) has copy-paste configs for every editor, with your key filled in automatically. Reload or restart your editor to connect. You're ready to generate. ## Supported editors Claude Code, Cursor, Windsurf, Cline, Gemini CLI, Codex, and Antigravity — anything that speaks the Model Context Protocol over HTTP. ## Available tools Once connected, your assistant gains these tools: ### Account - **get_account** — Get your credit balance. Call at most once per session; the balance only changes when you run a generation tool, which already reflects the outcome. Don't poll. ### Characters - **list_characters** — List your characters with pagination and search - **get_character** — Get details for a character, including its spritesheets - **create_character** — Create a character from a text prompt - **upload_character** — Create a character from your own image (URL, base64, or `uploadKey`) — free - **request_upload_url** — Get a presigned URL to upload a local image, then pass the `uploadKey` to `upload_character` - **generate_portrait** — Generate a close-up portrait of a character's face and shoulders - **generate_pose** — Generate a new pose for a character from a prompt - **pad_character** — Add padding around a character's base image to resize it within the frame ### Spritesheets - **generate_spritesheet** — Generate animations and queue a sprite sheet export - **regenerate_spritesheet** — Regenerate sheets at different sizes from existing videos (free) - **regenerate_single_spritesheet** — Regenerate one sheet from one existing video at a new size (free) - **get_spritesheet** — Get sprite sheet details and download URLs - **list_spritesheets** — List all sprite sheets for a character ### Jobs - **get_job_status** — Check the status of a generation job - **list_jobs** — List recent jobs with filtering ### Assets - **list_assets** — List static assets (props, objects) - **get_asset** — Get asset details - **get_asset_spritesheet** — Get the sprite sheet for an asset - **generate_asset_preview** — Generate preview images (`turbo` = 4 fast drafts, `ultra` = 1 polished; 1 credit) - **create_asset** — Create a static asset from a URL or `uploadKey` - **animate_asset** — Generate an animation video for an asset - **generate_asset_spritesheet** — Generate a sprite sheet from an asset animation - **generate_asset_3d_model** — Generate a 3D model from an asset image - **remove_asset_background** — Remove the background from an asset's image - **get_asset_job_status** — Check the status of an asset generation job ## Example prompts **Create a character with animations** ``` "Create a pixel art wizard with purple robes, then generate idle, walk, and cast-spell animations. Export as a 64x64 sprite sheet." ``` **Batch-generate across your library** ``` "List all my characters and generate walk animations for any that don't have them yet." ``` **Upload a local image** ``` "Upload my character image at ./assets/knight.png and generate idle and walk animations." ``` The assistant will call `request_upload_url`, upload the file, call `upload_character` with the `uploadKey`, then generate the animations. **Isometric / top-down RPG** ``` "Generate isometric walk and run animations in all 5 directions: up, right, down, northeast, and southeast." ``` Isometric animations are billed **per direction** (5 credits each). Valid suffixes are `up`, `right`, `down`, `northeast`, and `southeast` — passed as kinds like `iso_walk_up` or `iso_run_northeast`. West, northwest, and southwest are produced at render time by flipping their east-side pair, so they aren't generated and don't cost credits. ## Prefer plain HTTPS? Building a backend pipeline instead of working in an editor? The [REST API](/docs/api) exposes the same capabilities over HTTPS.

MCP setup page Get your API key

MCP Integration

MCP Integration