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, `Cr

... View full README on GitHub