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 |
| 3D Models | Convert 2D images to GLB models with PBR textures |
| Animation | Animated spritesheets from static sprites (4-64 frames) |
| 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 |
platform | No | Mobile, Desktop, Web |
genre | No | Hypercasual, Action, RPG, Puzzle, Platformer, etc. |
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) |
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), 4096 |
target_num_faces | No | Triangle count 1,000-100,000 (default: 50,000) |
high_detail_shape | No | Enable for complex shapes (slower) |
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 |
pixel_art_filter | No | none, small, medium, large |
Returns: spritesheet_url, video_url, gif_url
Credits: 5 per animation Processing time: 30-90 seconds
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 |
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) |
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 |
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 |
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 |
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. |
Credits: 3 per generation
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
License
Proprietary - See ludo.ai/terms for terms of service.