acedatacloud avatar

Mcp Luma

acedatacloud/lumamcp

Brings Luma Dream Machine's AI video generation directly into Claude and other MCP clients through AceDataCloud's API. You get text-to-video, image-to-video with start/end frame control, and video extension capabilities. Supports multiple aspect ratios (16:9, 9:16, 1:1), looping animations, and optional clarity enhancement. The tools handle task submission and polling, so you can generate and extend videos without leaving your editor. Runs as a hosted HTTP server with OAuth for Claude.ai or as a local Python package. Useful when you need to prototype video content or animate static images without switching to a separate video generation platform.

tools
8
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Nov 1, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

luma_list_aspect_ratiosList 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 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.

No parameter schema in public metadata yet.

luma_list_actionsList 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.

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.

No parameter schema in public metadata yet.

luma_get_taskQuery 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...1 params

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...

Parameters* required
task_idstring
The task ID returned from a generation request. This is the 'task_id' field from any luma_generate_* or luma_extend_* tool response.
luma_get_tasks_batchQuery 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 vide...1 params

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 vide...

Parameters* required
task_idsarray
List of task IDs to query. Maximum recommended batch size is 50 tasks.
luma_generate_videoGenerate 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...6 params

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...

Parameters* required
aspect_ratiostring
Video aspect ratio. Options: '16:9' (landscape, default), '9:16' (portrait), '1:1' (square), '4:3', '3:4', '21:9' (ultrawide), '9:21'.one of 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9default: 16:9
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the video is generated.
enhancementboolean
If true, enable clarity enhancement for the video. Default is true.default: true
loopboolean
If true, generate a looping video where end connects seamlessly to start. Default is false.default: false
promptstring
Description of the video to generate. Be descriptive about the scene, motion, style, and mood. Examples: 'A cat walking through a garden with butterflies', 'Astronauts shuttle from space to volcano...
timeoutvalue
Timeout in seconds for the API to return data. Default is 300.
luma_generate_video_from_imageGenerate 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 t...8 params

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 t...

Parameters* required
aspect_ratiostring
Video aspect ratio. Usually should match your input image ratio.one of 16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9default: 16:9
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will call this URL when the video is generated.
end_image_urlstring
URL of the image to use as the last frame of the video. The video will animate towards this image.default:
enhancementboolean
If true, enable clarity enhancement. Default is true.default: true
loopboolean
If true, generate a looping video. Default is false.default: false
promptstring
Description of the video motion and content. Describe what should happen in the video, how objects should move, what transitions to include.
start_image_urlstring
URL of the image to use as the first frame of the video. The video will animate from this image.default:
timeoutvalue
Timeout in seconds for the API to return data. Default is 300.
luma_extend_videoExtend 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 o...3 params

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 o...

Parameters* required
end_image_urlstring
Optional URL of an image to use as the final frame of the extended video.default:
promptstring
Description of what should happen in the extended portion of the video. Describe the continuation of motion and new content.
video_idstring
ID of the video to extend. This is the 'video_id' field from a previous generation result.
luma_extend_video_from_urlExtend 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...3 params

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...

Parameters* required
end_image_urlstring
Optional URL of an image to use as the final frame of the extended video.default:
promptstring
Description of what should happen in the extended portion of the video.
video_urlstring
URL of the video to extend. Must be a valid video URL from a previous Luma generation.

Sponsors

Configuration

ACEDATACLOUD_API_TOKEN*secret

API token from Ace Data Cloud (https://platform.acedata.cloud)

Readme

LumaMCP

PyPI version PyPI downloads Python 3.10+ License: MIT MCP

A Model Context Protocol (MCP) server for AI video generation using Luma Dream Machine through the AceDataCloud API.

Generate AI videos directly from Claude, VS Code, or any MCP-compatible client.

Features


View the full README on GitHub

Details

Repository
github.com/acedatacloud/lumamcp
Website
platform.acedata.cloud/documents/luma-mcp?utm_source=mcp_registry&utm_medium=referral&utm_campaign=evergreen&utm_content=luma_mcp_listing_guide
Category
Media & Entertainment
Package
mcp-luma
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from acedatacloud

Related Media & Entertainment MCP servers

View all
1adkit avatarMeta Ads MCP Server by AdKitadkit/meta-ads-mcpMeta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.0stars
2adkit avatarX Ads MCP Server by AdKitadkit/x-ads-mcpX Ads (Twitter Ads) MCP server: run X campaigns, ad groups, ads and reports from AI.0stars
3agentlux avatarAgentLuxagentlux/agentlux-mcpHosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.0stars
4aiweather-anurag avatarOttasiaaiweather-anurag/ottasia-mcp-serverWhere to watch X in Y? 30 Asian and Middle Eastern streaming markets, via Claude.0stars
5benjaminb10 avatarViewlifybenjaminb10/viewlify-mcpTikTok videos that beat their creator's usual views, trends, hashtags and sounds by niche.0stars
6dailyaiagents-cpu avatarMonthly Burndailyaiagents-cpu/dailyai-osAggregates monthly cash burn across Anthropic, ElevenLabs, Cloudflare, Stripe fees, GitHub Action...0stars