io.github.AceDataCloud/mcp-luma

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.

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.

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.

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.

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.

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.

Extend an existing video with additional content. This allows you to continue a previously generated video, adding more motion and content after the original video ends. Use this when: - A generated video is too short and you want to add more - You want to continue the story or motion from a previous video - You're building a longer video piece by piece Returns: Task ID and the extended video information.

Extend an existing video using its URL. Similar to luma_extend_video, but uses the video URL instead of video ID. This is useful when you have the video URL but not the original video ID. Use this when: - You have the video URL from a previous generation - You want to extend a video but don't have the video_id Returns: Task ID and the extended video information.