Luma Ai MCP Server

A Model Context Protocol server for Luma AI's Dream Machine API.

Local serverstdio

What is the Luma Ai MCP Server?

A Model Context Protocol server for Luma AI's Dream Machine API.

The short version

This MCP server integrates with Luma AI's Dream Machine API (v1) to provide tools for generating, managing, and manipulating AI-generated videos and images via Large Language Models. It implements the Model Context Protocol (MCP) to enable seamless interaction between AI assistants and Luma's creative tools.

  • Text-to-video generation
  • Advanced video generation with keyframes
  • Image-to-video conversion
  • Video extension and interpolation
  • Image generation with reference images
  • Audio addition to videos

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
Input:prompt (string, required): Text description of the image to generate
resolutionstring, required): Target resolution for the upscaled video (one of "540p", "720p", "1080p", or "4k")
durationstring, optional): Video duration (only "5s" and "9s" are currently supported)
aspect_ratiostring, optional): Image aspect ratio (same options as video)
loopboolean, optional): Whether to make the video loop
keyframesobject, optional): Start and end frames for advanced video generation:
Statequeued, dreaming, completed, failed)
offsetnumber, optional): Number of generations to skip
Note:The generation must be in a completed state to be upscaled
promptrequired): The prompt for the audio generation
negative_promptoptional): The negative prompt for the audio generation
callback_urloptional): URL to notify when the audio processing is complete
image_refarray, optional): Reference images to guide generation
style_refarray, optional): Style reference images
character_refobject, optional): Character reference images
Format{"url": "image_url", "weight": optional_float}
modify_image_refobject, optional): Image to modify
ReturnsList of available camera motion strings

How to install the Luma Ai MCP Server

{
  "mcpServers": {
    "luma": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/your/luma-ai-mcp-server",
        "-m",
        "luma_ai_mcp_server"
      ],
      "env": {
        "LUMA_API_KEY": "YOUR_LUMA_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LUMA_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Luma Ai to Input.”
  • “Use Luma Ai to Note.”
  • “Use Luma Ai to Format.”

Frequently asked questions

A Model Context Protocol server for Luma AI's Dream Machine API. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.