One Streamable HTTP endpoint, authenticated with a personal API key. Your agent makes the assets for your game and gets them ready for the engine, start to finish.
Create an account, pick a plan, then open your dashboard and create an API key. The plaintext key is shown once — store it somewhere safe.
The endpoint is https://api.gamedev.sh/mcp. Authenticate with an Authorization: Bearer <api-key> header. If your client asks for a connection type, choose HTTP, not SSE.
gamedev.shclaude mcp add --transport http gamedev-sh https://api.gamedev.sh/mcp \
--header "Authorization: Bearer gdsh_v1_YOUR_TOKEN"Describe what you need in plain words. Your agent picks the right tools, calls them and saves the results into your project — you never call a tool by hand. A generation can take a while, and every file stays downloadable for 24 hours.
Create a hero for my game: a fox ranger in a green cloak, with a bow.Costs are in tokens from your monthly allowance and are charged when a call succeeds — a failed call gives its tokens back. Your agent can check the balance with get_account at any time.
Which plan the key belongs to, what is left this month and where it went.
| Tool | What it does | Cost |
|---|---|---|
get_account | Plan, tokens left, the refill date and the token pack balance. | Free with an active plan |
get_usage | Recent calls: which tool ran, what it cost and when. | Free with an active plan |
Every tool answers with its result when it is ready within about 20 seconds. A slower call — an animation, a long track — answers with an operation_id instead, and your agent picks the result up with get_operation.
| Tool | What it does | Cost |
|---|---|---|
get_operation | Wait for a running call and return its result. | Free with an active plan |
list_operations | Recent calls with their status, to find a lost operation_id. | Free with an active plan |
Ready-made icons and sprites, tagged by subject, theme and style. Free with an active plan: no tokens are spent.
| Tool | What it does | Cost |
|---|---|---|
list_catalog_tags | Tags in use for one kind of asset, with how many assets carry each. | Free with an active plan |
search_catalog | Find icons or sprites by tags, best matches first, with small previews. | Free with an active plan |
get_catalog_asset | Download the assets you picked as transparent PNGs. | Free with an active plan |
Sprites and icons come back as transparent PNGs unless you turn background removal off; images keep their background. The price depends on the size of the canvas the model draws on. 1K, 2K, 4K set the pixel count, not a side: a square canvas is 1024, 2048, 4096 px on a side, other proportions keep about the same area, so at 1K 16:9 comes out 1376×768 and 21:9 1584×672.
| Tool | What it does | Cost |
|---|---|---|
generate_sprite | One 2D sprite — a character, enemy, prop or item — from a prompt, with optional reference images. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens +4 tokens to remove the background (on by default) |
generate_spritesheet | A set of matching sprites on a theme, like a weapon pack, each in its own cell of a square grid on one sheet. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens +4 tokens to remove the background (on by default) Same price for any grid from 2 × 2 to 10 × 10 |
generate_icon | One UI icon — an item, a skill, a currency — centered on a transparent square. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens +4 tokens to remove the background (on by default) |
generate_icon_spritesheet | A set of matching UI icons, like skill or inventory icons, each in its own cell of one sheet. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens +4 tokens to remove the background (on by default) Same price for any grid up to 8 × 8 |
generate_image | Full-canvas art that keeps its background: a level background, a splash screen, key art, a portrait. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens |
edit_sprite | Change an existing sprite — recolor it, swap its weapon, change its pose — and get it back cut out. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens +4 tokens to remove the background (on by default) |
edit_icon | Change an existing UI icon — recolor it, add a glow — and get it back on a transparent square. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens +4 tokens to remove the background (on by default) |
edit_image | Change an existing background, splash screen or key art; it keeps its background and proportions. | 1K (1024×1024 when square) — 20 tokens 2K (2048×2048 when square) — 25 tokens 4K (4096×4096 when square) — 40 tokens |
generate_animation | Animate a sprite — a walk cycle, an idle loop, an attack, a spinning coin — rendered as video and cut into frames, returned as a sprite sheet together with the full clip. | 25 tokens per second of clip, 4–10 s +4 tokens per frame to remove the background (on by default) Defaults: 4 s, 8 frames, cut out — 132 tokens |
remove_background | Cut the subject out of any image and return a transparent PNG of the same size. | 4 tokens per image |
Drawn on a real pixel grid and returned at native size: one image pixel per art pixel. Sizes from 16 to 256 px, all at one price.
| Tool | What it does | Cost |
|---|---|---|
generate_pixelart_sprite | One square pixel art sprite with a transparent background. | 25 tokens per image Same price at any size |
generate_pixelart_icon | One square pixel art UI icon with a transparent background. | 25 tokens per image Same price at any size |
generate_pixelart_image | Full-canvas pixel art that keeps its background: a level background, a title screen, a portrait. | 25 tokens per image Same price at any size |
Delivered as mp3, ogg, wav, flac or m4a.
| Tool | What it does | Cost |
|---|---|---|
generate_sound | A one-shot or looping sound effect from a description, up to 30 seconds. | 25 tokens per sound Same price for any length up to 30 s |
generate_music | A track from a description of genre, mood and instruments, up to 10 minutes. | 30 tokens per started 30 s 0:30 — 30 · 1:00 — 60 · 2:10 — 150 |
create_voice | A character voice from a description, with a short sample. | 20 tokens per voice |
generate_speech | Speech in a voice you made with create_voice. | 20 tokens per line Same price for 100–1,000 characters |
list_voices | The voices you created. | Free with an active plan |
delete_voice | Delete one of your voices to free a slot. | Free with an active plan |
Inputs are a public URL or base64. Free with an active plan: no tokens are spent.
| Tool | What it does | Cost |
|---|---|---|
crop_image | Crop to a rectangle, with optional rotate, flip, resize and re-encode. | Free with an active plan |
resize_image | Resize with contain / cover / fill / inside / outside fitting. | Free with an active plan |
trim_image | Cut uniform margins and report the offset for pivot correction. | Free with an active plan |
slice_image | Split a sheet into a columns × rows grid. | Free with an active plan |
outline_image | Draw a readability outline around opaque pixels. | Free with an active plan |
make_spritesheet | Combine frames into a uniform-grid spritesheet. | Free with an active plan |
pack_atlas | Pack sprites into an atlas with Phaser, Godot, Unity, LibGDX or XML metadata. | Free with an active plan |
Trim audio for your game. Free with an active plan: no tokens are spent.
| Tool | What it does | Cost |
|---|---|---|
trim_audio | Cut a section, fade it in or out, reverse it and re-encode. | Free with an active plan |