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 from a text prompt alone (no source image needed). To match the art style of an existing image use generateWithStyle, to modify an existing image use editImage, and to cut out a subject use removeBackground.

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 (Left)" pose with generatePose
2. Use the returned motion_prompt directly in animateSprite for optimal animation results

Credits: 0.5 per image

---

Rotate Sprite (rotateSprite)

Rotate the camera view of an existing sprite to a new angle, keeping the same character and pose. Useful for generating turnaround / directional views of a sprite.

Returns: url, camera_rotation, camera_elevation

Credits: 0.5 per image

---

Remove Background (removeBackground)

Remove the background from a single image, returning the subject isolated on a transparent background. For broader edits (not just cutting out the subject), use editImage instead.

Returns: a single result with 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: Varies by duration and model. Standard model: 1.9 credits/sec with a 4-credit minimum (e.g. ~1.2s = 4, 3s ≈ 5.7, 4s ≈ 7.6). Higher-quality models cost more per second. 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: Varies by duration and model, 4-credit minimum. Tango: 4 credits/sec (default 1.5s = 6, up to 16 at 4s); Forge: 2 credits/sec (1.5s = 4, up to 8 at 4s)

---

Edit Spritesheet (editSpritesheet)

Edit a spritesheet you previously generated: re-prompt its animation, outpaint beyond the frame, or repair a bad loop. Pass back the spritesheet_url you received from animateSprite, transferMotion, or an earlier edit — it must be a spritesheet you generated in the last 7 days (external URLs are not accepted).

Returns: same shape as animateSprite (spritesheet_url, video_url, gif_url, num_frames, num_cols, num_rows, ...)

Credits: Varies by duration: 2 credits/sec with a 4-credit minimum (3s = 6, 4s = 8)

---

Video Generation (createVideo)

Generate short videos from images.

Credits: Varies by duration and model. Standard model: 1 credit/sec (3s = 3, 5s = 5, 8s = 8, 10s = 10). Higher-quality models cost more per second.

---

Video from References (createVideoFromReferences)

Generate a video from 1-5 reference images and a text prompt. Unlike createVideo, which animates a single source image, this composes a new scene that borrows characters, objects, and style from the references.

Returns: url, duration, has_audio

Credits: Varies by duration and model. Eagle: 1.5 credits/sec (5s = 7.5); Eagle with Audio: 2 credits/sec (5s = 10)

---

Edit Video (editVideo)

Edit a video you previously generated with a text prompt and optional reference images (video-to-video). Pass back the url you received from createVideo, createVideoFromReferences, or an earlier edit — it must be a video you generated in the last 7 days (external URLs are not accepted).

Returns: url, duration, has_audio

Credits: Varies by duration: 2 credits/sec (5s = 10)

---

Upscale Video (upscaleVideo)

Upscale a video you previously generated to twice its resolution (2x). Pass back the url you received from createVideo, createVideoFromReferences, or editVideo — it must be a video you generated in the last 7 days (external URLs are not accepted). Only videos below 960x960 pixels can be upscaled; larger sources are rejected.

Returns: url, duration, has_audio

Credits: Flat rate by duration, independent of model: 0.2 credits/sec (5s = 1)

---

Sound Effect Generation (createSoundEffect)

Generate game sound effects from text descriptions.

Credits: 2 per sound

---

Ambiance Generation (createAmbiance)

Generate ambient soundscapes and background atmospheres from text descriptions.

Credits: 2 per generation

---

Music Generation (createMusic)

Generate background music and themes.

Credits: 3 per track

---

Audio Transform (createAudioTransform)

Remix or transform an existing audio sample using a text prompt.

Credits: 3 per generation

---

Voice Generation (createVoice)

Generate unique character voices.

Credits: 1 per voice

---

Text-to-Speech (createSpeech)

Clone a voice from an audio sample.

Credits: 1 per generation

---

Text-to-Speech Preset (createSpeechPreset)

Use preset voices for text-to-speech.

Credits: 1 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

---

How Generation Calls Work

Every generation tool is synchronous: the call blocks until the asset is ready and returns the result (with its URLs) directly in the response. There is no separate polling step, and dropping the connection before the call returns cancels the request. Long-running operations such as 3D models and animations can take 30–120 seconds, so allow a generous client-side timeout.

Retrieving Results Later

Every generation tool also accepts an optional request_id. This does not make the call asynchronous — it tags the result so you can fetch it again afterwards from the matching results endpoint (for example from a different session, or to list everything tied to one request). The result is persisted only after the synchronous call has completed successfully.

# Generate a sprite animation — this call blocks and returns the spritesheet directly
animateSprite with request_id="my-anim-001", initial_image="url", motion_prompt="walking"

# Later, re-fetch that same result (e.g. in another session) by its request_id
getSpriteResults with request_id="my-anim-001"

Results are available for 7 days, and each results endpoint is free and returns up to 100 recent API-generated assets.

---

Asset URL Expiration

All generated asset URLs (images, spritesheets, videos, audio, 3D models) point to Google Cloud Storage links that expire after 7 days. Any asset that needs to outlive that window — especially assets destined for production use — must be downloaded and saved locally (or re-uploaded to permanent storage) right away. Never store the returned URLs as permanent references.

The server also announces this to MCP clients via its instructions field during the initialize handshake, so models connected through clients that surface server instructions will be reminded automatically.

---

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.