luma_list_aspect_ratios
List all available aspect ratios for Luma video generation.
Shows all available aspect ratio options with their use cases.
Use this to understand which aspect ratio to choose for your video.
Returns:
Table of all aspect ratios with their descriptions and use cases.
luma_list_actions
List all available Luma API actions and corresponding tools.
Reference guide for what each action does and which tool to use.
Helpful for understanding the full capabilities of the Luma MCP.
Returns:
Categorized list of all actions and their corresponding tools.
luma_get_task
Query the status and result of a video generation task.
Use this to check if a generation is complete and retrieve the resulting
video URLs, thumbnails, and other metadata.
Use this when:
- You want to check if a generation has completed
- You need to retrieve video URLs from a previous generation
- You want to get the full details of a generated video
Task states:
- 'pending': Generation is still in progress
- 'completed': Generation finished successfully
- 'failed': Generation failed (check error message)
Returns:
Task status and generated video information including URLs, dimensions, and thumbnail.
luma_get_tasks_batch
Query multiple video generation tasks at once.
Efficiently check the status of multiple tasks in a single request.
More efficient than calling luma_get_task multiple times.
Use this when:
- You have multiple pending generations to check
- You want to get status of several videos at once
- You're tracking a batch of generations
Returns:
Status and video information for all queried tasks.
luma_generate_video
Generate AI video from a text prompt using Luma Dream Machine.
This is the simplest way to create video - just describe what you want and Luma
will generate a high-quality AI video.
Use this when:
- You want to create a video from a text description
- You don't have reference images
- You want quick video generation
For using reference images (start/end frames), use luma_generate_video_from_image instead.
Returns:
Task ID and generated video information including URLs, dimensions, and thumbnail.
luma_generate_video_from_image
Generate AI video using reference images as start and/or end frames.
This allows you to control the video by specifying what the first frame
and/or last frame should look like. Luma will generate smooth motion between them.
Use this when:
- You have a specific image you want to animate
- You want to create a video transition between two images
- You need precise control over the video's visual content
At least one of start_image_url or end_image_url must be provided.
Returns:
Task ID and generated video information including URLs, dimensions, and thumbnail.