# Ludo AI Game Assets MCP server

> Generate game sprites, animations, 3D models, video, music, sound effects and voices with Ludo.ai

- Listing: https://mcp.tc/i/ludo-ai-game-assets
- Connect: use the server's own URL `https://mcp.ludo.ai/mcp` (with your API key); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: API key
- Category: [AI & Machine Learning](https://mcp.tc/c/ai-ml)
- Vendor: Ludo.ai
- Homepage: <https://ludo.ai>
- Docs: <https://ludo.ai/developers>
- Repository: <https://github.com/Ludo-AI/ludo-mcp>

## About

Connects to Ludo.ai to generate game assets from an assistant. It covers images and sprites, animated spritesheets, directional sprites from 3D models, 3D model creation with rigging and animation, short videos, sound effects, ambiance, music and voices. It also includes tools to search Ludo's documentation and list past generations.

Runs as a hosted Streamable HTTP endpoint at https://mcp.ludo.ai/mcp. Requests need an Authorization header with a Ludo API key (ApiKey YOUR\_API\_KEY). API access comes with the Pro and Studio plans. Generation tools return a job ID to poll, and returned asset URLs expire after 7 days, so download results promptly.

## What it can do

- Generate game art images and restyle from a reference image
- Animate sprites into spritesheets from prompts or keyframes
- Create, rig and animate 3D models
- Render directional sprites from 3D models
- Generate videos from images and edit or upscale them
- Create sound effects, ambiance, music and voices
- Remove backgrounds, upscale images, convert to pixel art
- Search Ludo docs and list past generations

## Tools (54)

- `validateApiKeyEndpoint`: Check whether an API key is valid. (read-only)
- `createImage`: Generate game-art images from a text prompt.
- `generateWithStyle`: Generate new images matching a reference image's style.
- `editImage`: Modify an existing image using text instructions.
- `animateSprite`: Turn a static sprite into a spritesheet from a motion prompt.
- `animateSpriteKeyframes`: Animate a sprite through up to three keyframes.
- `generatePose`: Re-pose an existing sprite while keeping the character.
- `rotateSprite`: Re-render a sprite from a different camera viewpoint.
- `transferMotion`: Apply motion from a video or preset onto a sprite.
- `getDocs`: Browse or read Ludo documentation. (read-only)
- `searchDocs`: Search Ludo documentation with a plain-language question. (read-only)
- `listAnimationPresets`: List animation presets, perspectives and directions. (read-only)
- `editSpritesheet`: Re-prompt, outpaint or repair a generated spritesheet.
- `rotateSpritesheet`: Re-render a sprite animation from a new view.
- `adjustSpritesheet`: Re-export a spritesheet with different sheet settings.
- `createSpriteAudio`: Generate a sound effect for a spritesheet animation.
- `listDirectionalSpriteStyles`: List styles, perspectives and directions for directional sprites. (read-only)
- `previewDirectionalSprites`: Preview a few frames of a 3D model in a style.
- `createDirectionalSprites`: Render a 3D model into one spritesheet per direction.
- `createDirectionalStills`: Render a 3D model into one still image per direction.
- `fitDirectionalAccessory`: Fit an accessory to a rigged 3D model for Directional Sprites: an item GLB (a sword, a gun, a staff, a bow, a shield, a helmet, a hat, a backpack...) held by one bone of the model - a hand, the head, the back or the…
- `attachDirectionalAccessories`: Put accessories on a rigged 3D model for Directional Sprites: up to 8 items, each at the \`placement\` fitDirectionalAccessory returned (or, without one, at the automatic fit plus the same size/move/turn adjustments).
- `createVideo`: Generate a short video from a source image and motion prompt.
- `createVideoFromReferences`: Generate a video from 1-5 reference images and a prompt.
- `editVideo`: Edit a generated video with a text prompt.
- `upscaleVideo`: Upscale a generated video to twice its resolution.
- `removeBackground`: Isolate the subject on a transparent background.
- `upscaleImage`: Upscale an image up to 4x.
- `createNormalMap`: Make the normal map of an image, for 2.5D lighting: a lossless WebP of the same size and alpha as the image (transparent pixels are flat), in the OpenGL convention (red = right, green = up, blue = towards the viewer…
- `convertToPixelArt`: Convert an image to pixel art, free and synchronous.
- `createTile`: Make a seamless base tile for a 2D map from a text description: the first step of a tileset.
- `createTileset`: Build a 16-tile tileset from seamless base tiles: every arrangement a map needs, so the edges and corners fall into place when a map is painted with it.
- `editTileset`: Change a whole tileset with one sentence: its look (cover the ground in snow, at sunset, another art style) or its boundary (replace the curb with a hedge).
- `create3DModel`: Convert a source image into a textured GLB 3D model.
- `create3DModelImage`: Make a character image ready for 3D model conversion.
- `rigModel`: Generate a skeleton and skin weights for a GLB.
- `animate3DModel`: Generate text-driven animations for a rigged model.
- `animate3DModelPreset`: Apply an animation preset to a rigged model.
- `createAnimation`: Generate a reusable animation from a text prompt (text-to-motion): the skeletal motion of a humanoid character, such as "overhead sword slash" or "zombie walk", made for no model in particular.
- `listMyAnimations`: List the account's own animations: the ones generated with createAnimation or in the web app's My Animations, newest first. (read-only)
- `createSoundEffect`: Produce a short sound effect from a text description.
- `createAmbiance`: Produce a looping ambiance soundscape from text.
- `createMusic`: Produce music from a description, with optional lyrics.
- `createAudioTransform`: Remix an existing audio sample guided by a prompt.
- `createVoice`: Design a new voice from a character description or image.
- `createSpeech`: Text to speech by cloning a voice from an audio sample.
- `createSpeechPreset`: Text to speech with a built-in preset voice.
- `listGenerations`: List past generations with filters and pagination. (read-only)
- `listApiJobs`: List the generation jobs you started through the API or MCP, most recent first. (read-only)
- `getApiJob`: Poll the status of a generation job started by any tool. (read-only)
- `cancelApiJob`: Cancel a queued job you started through the API or MCP; the credits held for it are refunded. (can modify or delete data)
- `getPricing`: What Ludo's paid service costs and includes, for an agent advising a user: every plan with its monthly and annual price, credits, seats, queue concurrency and what it includes or lacks; credit top-ups and their price… (read-only)
- `getAccount`: Show your account's credit balance, plan and auto top-up settings. (read-only)
- `submitApiFeedback`: Report a problem with the Ludo API itself to the Ludo team.

## Example prompts

- "Create a pixel art knight sprite and animate a walk cycle"
- "Turn this character image into a rigged 3D model"
- "Generate a looping windy forest ambiance for my level"
- "Remove the background from this image and upscale it 2x"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http ludo-ai-game-assets https://mcp.ludo.ai/mcp --header "Authorization: Bearer <YOUR_API_KEY>"
```

2. Replace the placeholder with your key before you run it, then check it with `/mcp` inside Claude Code.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Use the `mcp-remote` bridge, which keeps the key on this computer (a connector added on claude.ai with the key under **Request headers** also shows up here). Open **Settings → Developer → Edit Config** and add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "ludo-ai-game-assets": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ludo.ai/mcp",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ]
    }
  }
}
```

2. Replace the placeholder with your key and restart Claude Desktop.

The bridge needs Node.js on your computer.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Ludo%20AI%20Game%20Assets&connectorUrl=https%3A%2F%2Fmcp.ludo.ai%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://mcp.ludo.ai/mcp`. Under **Request headers**, add `Authorization: Bearer <YOUR_API_KEY>` with your key from Ludo.ai, then click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=ludo-ai-game-assets&config=eyJ1cmwiOiJodHRwczovL21jcC5sdWRvLmFpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciA8WU9VUl9BUElfS0VZPiJ9fQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "ludo-ai-game-assets": {
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

### VS Code

Add it to `.vscode/mcp.json`. VS Code asks for the key the first time and stores it securely:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "ludo-ai-game-assets": {
      "type": "http",
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "api-key",
      "description": "API key",
      "password": true
    }
  ]
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "ludo-ai-game-assets": {
      "serverUrl": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add ludo-ai-game-assets --url https://mcp.ludo.ai/mcp --bearer-token-env-var LUDO_AI_GAME_ASSETS_API_KEY
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.ludo-ai-game-assets]
url = "https://mcp.ludo.ai/mcp"
bearer_token_env_var = "LUDO_AI_GAME_ASSETS_API_KEY"
```

Set `LUDO_AI_GAME_ASSETS_API_KEY` to your key in the shell that runs Codex.

### Gemini CLI

```bash
gemini mcp add --transport http --header "Authorization: Bearer <YOUR_API_KEY>" ludo-ai-game-assets https://mcp.ludo.ai/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "ludo-ai-game-assets": {
      "type": "http",
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.ludo.ai/mcp`.

## Recent changes

- 2026-11-17 14:53 UTC: 3 tools added and 5 tools changed. Source: automatic check. Added: createTile, createTileset, editTileset. Changed: animateSprite, animateSpriteKeyframes, create3DModel, editSpritesheet, listGenerations.
- 2026-11-17 11:51 UTC: 1 tool changed. Source: automatic check. Changed: createVideo.
- 2026-11-16 14:52 UTC: 7 tools changed. Source: automatic check. Changed: animateSprite, animateSpriteKeyframes, createSpriteAudio, createVideo, editSpritesheet, generateWithStyle, transferMotion.
- 2026-11-11 20:58 UTC: 3 tools changed. Source: automatic check. Changed: createDirectionalSprites, createDirectionalStills, previewDirectionalSprites.
- 2026-11-11 14:53 UTC: 2 tools added and 5 tools changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Added: createAnimation, listMyAnimations. Changed: animate3DModelPreset, createDirectionalSprites, listAnimationPresets, previewDirectionalSprites, transferMotion.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/ludo-ai-game-assets#history (Atom feed: https://mcp.tc/i/ludo-ai-game-assets/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.9.10
- MCP protocol version: 2025-11-25
- Last checked: 2026-11-18 (reachable)
- Listed: 2026-11-01
- Updated: 2026-11-17

---
Source: https://mcp.tc/i/ludo-ai-game-assets (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
