Luma API MCP

Setup

Open Claude Desktop or any MCP client

prompt: text
aspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21" (default: "16:9")
model: "photon-1", "photon-flash-1" (default: "photon-1")
image_ref: list of image URLs with weights to influence generation (optional), max 8
style_ref: single image URL with weight to influence style (optional), max 1
character_ref: list of character image URLs (optional), max 4
modify_image_ref: single image URL to modify with weight (optional), max 1

prompt: text
aspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21" (default: "16:9")
model: "ray-2", "ray-flash-2", "ray-1-6" (default: "ray-2")
loop: boolean (default: false)
resolution: "540p", "720p", "1080p", "4k" (default: "720p")
duration: "5s", "9s" (default: "5s")
frame0_image: image URL (optional)
frame1_image: image URL (optional)
frame0_id: generation ID (optional)
frame1_id: generation ID (optional)

Keyframes: Providing frame0_image/frame1_image gives more control over video start/end points
Video Response Time: Typical video generation takes 15-60 seconds depending on duration and resolution
Image Response Time: Typical generation takes 5-15 seconds depending on model complexity

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.

Tool

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.