Ludo AI MCP Server

Generate game assets using AI through the Model Context Protocol (MCP).

Features

Category	Capabilities
Images	Sprites, icons, screenshots, backgrounds, UI assets, textures, background removal
3D Models	Convert 2D images to GLB models with PBR textures
Animation	Animated spritesheets from static sprites (4-64 frames), motion transfer from video or presets
Video	Generate short videos from images (3-10 seconds)
Audio	Sound effects, background music, character voices, TTS

Quick Start

1. Get an API Key

Sign up at ludo.ai and get your API key from app.ludo.ai.

2. Configure Your MCP Client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "ludo": {
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Cursor

Add to your MCP settings in Cursor preferences:

{
  "mcpServers": {
    "ludo": {
      "url": "https://mcp.ludo.ai/mcp",
      "headers": {
        "Authorization": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Available Tools

Image Generation (createImage)

Generate sprites, icons, backgrounds, UI assets, and textures.

Parameter	Required	Description
prompt	Yes	Detailed description of the image
image_type	Yes	sprite, icon, screenshot, art, asset, sprite-vfx, ui_asset, fixed_background, texture, 3d, generic
art_style	No	Pixel Art (16-Bit), Pixel Art (8-Bit), Low Poly, Cartoonish, Stylized 3D, Flat Design, Anime/Manga, Voxel Art, etc.
perspective	No	Side-Scroll, Top-Down, Isometric, First-Person, Third-Person, 2.5D
aspect_ratio	No	default, ar_1_1, ar_4_3, ar_16_9, ar_9_16
n	No	Number of variations (1-8, default: 1)
request_id	No	Client-provided ID to retrieve results later

Credits: 0.5 per image

---

Edit Image (editImage)

Modify an existing image using text instructions (smart editing).

Parameter	Required	Description
image	Yes	URL or base64-encoded image to edit
prompt	Yes	Description of changes (e.g., "remove the background", "make it darker", "add clouds to the sky")
reference_image	No	URL or base64 reference image for style/content guidance
n	No	Number of variations (1-4, default: 1)
request_id	No	Client-provided ID to retrieve results later

Credits: 0.5 per image

---

Generate with Style (generateWithStyle)

Generate new content while maintaining the visual style of a reference image.

Parameter	Required	Description
style_image	Yes	URL or base64-encoded reference image for style matching
prompt	Yes	Description of what to generate (e.g., "a warrior character", "a treasure chest")
image_type	Yes	sprite, icon, screenshot, art, asset, sprite-vfx, ui_asset, fixed_background, texture, 3d, generic
n	No	Number of variations (1-4, default: 1)
request_id	No	Client-provided ID to retrieve results later

Credits: 0.5 per image

---

Generate Pose (generatePose)

Generate a new pose for an existing sprite. Use this BEFORE animateSprite to get the best animation results - the starting pose should match your intended animation.

Parameter	Required	Description
image	Yes	URL or base64-encoded sprite image
pose	Yes	Target pose: Idle (Front), Idle (Back), Walk / Run (Left), Attack Ready, Jumping, Crouching, Flying, Defending / Blocking, or any custom description
description	No	Additional instructions to guide pose generation
n	No	Number of variations (1-4, default: 1)
request_id	No	Client-provided ID to retrieve results later

Returns: url, pose, motion_prompt

Example workflow:

1. Generate a "Walk / Run (Left)" pose with generatePose
2. Use the returned motion_prompt directly in animateSprite for optimal animation results

Credits: 0.5 per image

---

Remove Background (removeImageBackground)

Remove the background from an image, returning a transparent PNG.

Parameter	Required	Description
image	Yes	URL or base64-encoded image
request_id	No	Client-provided ID to retrieve results later

Returns: url (transparent PNG)

Credits: 0.5 per image

---

3D Model Generation (create3DModel)

Convert a 2D image to a 3D GLB model with textures.

Parameter	Required	Description
image	Yes	URL or base64-encoded image
texture_type	No	pbr (default), simple, none
texture_size	No	1024, 2048 (default)
target_num_faces	No	Triangle count 1,000-200,000 (default: 50,000)
request_id	No	Client-provided ID to retrieve results later

Returns: model_url (GLB file) + 4 snapshot images from different angles

Credits: 3 per model Processing time: 60-120 seconds

---

Sprite Animation (animateSprite)

Create animated spritesheets from static images.

Parameter	Required	Description
initial_image	Yes	URL or base64 of the starting frame
motion_prompt	Yes	Animation description (e.g., "walking cycle", "idle breathing", "attack slash")
image_type	No	sprite, sprite-vfx, ui_asset
frames	No	4, 9, 16, 25, 36 (default), 49, 64
frame_size	No	64, 128, 256 (default), 0 (max resolution)
loop	No	Seamless loop (default: true)
model	No	standard (default) or new (higher quality)
duration	No	Standard: 1.2-3s, New: 4s
final_image	No	Ending frame for interpolation
gif	No	Generate an animated GIF (default: false)
individual_frames	No	Extract individual frame images (default: false)
spritesheet_with_background	No	Also return the spritesheet with background intact, before background removal (default: false)
request_id	No	Client-provided ID to retrieve results later

Returns: spritesheet_url, video_url, gif_url, individual_frame_urls, spritesheet_with_background_url, individual_frame_with_background_urls, num_frames, num_cols, num_rows

Credits: 5 per animation Processing time: 30-90 seconds

---

Animation Presets (listAnimationPresets)

List available animation presets for use with motion transfer. Returns preset animations, perspectives, and directions — no video URLs are exposed.

Returns:

• animations — Array of presets with id, name, category, description, duration, preview_url
• perspectives — Array with id, name, description (all animations support all perspectives)
• directions — ["N", "NE", "E", "SE", "S", "SW", "W", "NW"] (all animations support all directions)

Credits: Free

---

Motion Transfer (transferMotion)

Transfer motion from a video or animation preset onto a static sprite, producing an animated spritesheet.

Parameter	Required	Description
image	Yes	URL or base64-encoded sprite image
video	No	URL of the video to use as motion source. You can use videos from the animateSprite endpoint or provide your own. Videos up to 4 seconds will produce better results. Either video or preset_id + perspective + direction must be provided.
preset_id	No	ID of an animation preset to use instead of a video URL. Use the animation-presets endpoint to list available presets. When using a preset, perspective and direction are required.
direction	No	Direction for the animation preset. When using a preset, direction is required. Values: N, NE, E, SE, S, SW, W, NW
perspective	No	Perspective ID to use with the animation preset. When using a preset, perspective is required.
frames	No	Number of frames in the output spritesheet
frame_size	No	Size of each frame in pixels
loop	No	Trim animation for seamless loop
crop	No	Crop frames to fit content
margin_ratio	No	Padding around sprite (0.0-1.0)
margin_ratio_mode	No	manual (default), none
gif	No	Generate an animated GIF (default: false)
individual_frames	No	Extract individual frame images (default: false)
spritesheet_with_background	No	Also return the spritesheet with background intact, before background removal (default: false)
request_id	No	Client-provided ID to retrieve results later

Returns: spritesheet_url, video_url, gif_url, individual_frame_urls, spritesheet_with_background_url, individual_frame_with_background_urls, num_frames, num_cols, num_rows

Credits: 5 per transfer

---

Video Generation (createVideo)

Generate short videos from images.

Parameter	Required	Description
image	Yes	URL or base64 starting frame
prompt	Yes	Motion description (e.g., "camera zooms in", "character walks forward")
duration	No	3, 5 (default), 8, 10 seconds
model	No	standard (default) or new
final_image	No	Ending frame for interpolation
request_id	No	Client-provided ID to retrieve results later

Credits: 3s=5, 5s=8, 8s=12, 10s=15

---

Sound Effect Generation (createSoundEffect)

Generate game sound effects from text descriptions.

Parameter	Required	Description
description	Yes	Sound description (e.g., "laser gun firing", "footsteps on gravel", "coin pickup")
duration	No	0-10 seconds (0 = automatic)
request_id	No	Client-provided ID to retrieve results later

Credits: 3 per sound

---

Music Generation (createMusic)

Generate background music and themes.

Parameter	Required	Description
description	Yes	Music description (e.g., "epic orchestral battle theme", "calm piano melody", "8-bit chiptune")
lyrics	No	Optional lyrics for vocal tracks
request_id	No	Client-provided ID to retrieve results later

Credits: 3 per track

---

Voice Generation (createVoice)

Generate unique character voices.

Parameter	Required	Description
voice_description	Yes	Character description (e.g., "gruff old warrior", "cheerful young girl")
text	Yes	Text to speak (max 200 characters)
type	No	human (default) or non-human
request_id	No	Client-provided ID to retrieve results later

Credits: 3 per voice

---

Text-to-Speech (createSpeech)

Clone a voice from an audio sample.

Parameter	Required	Description
text	Yes	Text to speak (max 1000 characters)
sample	Yes	URL or base64 audio sample for voice cloning
request_id	No	Client-provided ID to retrieve results later

Credits: 3 per generation

---

Text-to-Speech Preset (createSpeechPreset)

Use preset voices for text-to-speech.

Parameter	Required	Description
text	Yes	Text to speak (max 1000 characters)
voice_preset_id	Yes	Serious woman, Wise woman, Calm woman, Patient man, Determined man, Deep voice man, Teen boy, Sweet girl, etc.
emotion	No	Default, Happy, Sad, Angry, Fearful, Surprised, Neutral
language	No	auto, English, Spanish, French, German, Japanese, Korean, etc.
request_id	No	Client-provided ID to retrieve results later

Credits: 3 per generation

---

Retrieve Image Results (getImageResults)

Retrieve your recent API-generated images.

Parameter	Required	Description
request_id	No	Filter to a specific request

Returns: Array of image objects with url, request_id, created_at

Credits: Free

---

Retrieve Sprite Results (getSpriteResults)

Retrieve your recent API-generated spritesheets.

Parameter	Required	Description
request_id	No	Filter to a specific request

Returns: Array of spritesheet objects with request_id, created_at

Credits: Free

---

Retrieve Video Results (getVideoResults)

Retrieve your recent API-generated videos.

Parameter	Required	Description
request_id	No	Filter to a specific request

Returns: Array of video objects with url, request_id, created_at

Credits: Free

---

Retrieve Audio Results (getAudioResults)

Retrieve your recent API-generated audio.

Parameter	Required	Description
request_id	No	Filter to a specific request

Returns: Array of audio objects with request_id, created_at

Credits: Free

---

Retrieve 3D Model Results (get3DModelResults)

Retrieve your recent API-generated 3D models.

Parameter	Required	Description
request_id	No	Filter to a specific request

Returns: Array of 3D asset objects with request_id, created_at

Credits: Free

---

Async Usage

You can use request_id to build fire-and-forget workflows. Tag any generation request with a request_id, then poll the corresponding results endpoint to pick up the output when it's ready — no need to keep the connection open.

1. Pass a request_id in your generation request
2. Poll the corresponding results endpoint to retrieve the output

# Fire off a sprite animation
animateSprite with request_id="my-anim-001", initial_image="url", motion_prompt="walking"

# Retrieve the result whenever you're ready
getSpriteResults with request_id="my-anim-001"

All generation endpoints accept an optional request_id parameter. Results are available for 7 days and each results endpoint returns up to 100 recent API-generated assets.

---

Asset URL Expiration

All generated asset URLs (images, spritesheets, videos, audio, 3D models) are temporary and expire after 7 days. If you need to keep an asset, download it before it expires.

---

Example Prompts

Creating Game Assets

Create a pixel art knight character with sword and shield, side view, 16-bit style

Generate an isometric treasure chest icon for a mobile RPG

Create a low-poly stylized tree for a casual mobile game

Animations

Animate this character with a smooth walking cycle, 16 frames

Create an idle breathing animation for this character sprite

Animate this fire sprite as a looping VFX effect

Audio

Create a satisfying coin pickup sound effect for a platformer

Generate an epic orchestral boss battle theme, intense and dramatic

Create a voice for a wise old wizard saying "The journey begins now"

API Documentation

Full API documentation with all parameters and response formats: api.ludo.ai/api-documentation

Support

• Documentation
• Ludo AI Website
• GitHub Issues

License

Proprietary - See ludo.ai/terms for terms of service.