Ludo MCP

🚀 Ludo AI MCP Server

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

✨ Features

🚀 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"
      }
    }
  }
}

📚 Documentation

Available Tools

Image Generation (createImage)

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

Credits: 0.5 per image

Edit Image (editImage)

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

Credits: 0.5 per image

Generate with Style (generateWithStyle)

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

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.

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.

Returns: url (transparent PNG)

Credits: 0.5 per image

3D Model Generation (create3DModel)

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

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.

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.

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.

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

Sound Effect Generation (createSoundEffect)

Generate game sound effects from text descriptions.

Credits: 3 per sound

Music Generation (createMusic)

Generate background music and themes.

Credits: 3 per track

Voice Generation (createVoice)

Generate unique character voices.

Credits: 3 per voice

Text - to - Speech (createSpeech)

Clone a voice from an audio sample.

Credits: 3 per generation

Text - to - Speech Preset (createSpeechPreset)

Use preset voices for text - to - speech.

Credits: 3 per generation

Retrieve Image Results (getImageResults)

Retrieve your recent API - generated images.

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

Credits: Free

Retrieve Sprite Results (getSpriteResults)

Retrieve your recent API - generated spritesheets.

Returns: Array of spritesheet objects with request_id, created_at

Credits: Free

Retrieve Video Results (getVideoResults)

Retrieve your recent API - generated videos.

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

Credits: Free

Retrieve Audio Results (getAudioResults)

Retrieve your recent API - generated audio.

Returns: Array of audio objects with request_id, created_at

Credits: Free

Retrieve 3D Model Results (get3DModelResults)

Retrieve your recent API - generated 3D models.

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.

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

📄 License

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

🔗 Support

• Documentation
• Ludo AI Website
• GitHub Issues