Ludo MCP Server

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

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.

---

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.