mcp.film

mcp.film / Video Generation / Luma AI MCP Server

Luma AI MCP Server

Communityby Community (bobtista)paidverified Oct 21, 2026

Community MCP with the widest tool surface on Luma's legacy Dream Machine API.

What it does

Community Python server for Luma's Dream Machine API v1: text/image-to-video on ray-2 and ray-flash-2, video extension and interpolation, Photon image generation, upscaling, audio addition and credit checks. Luma has since moved its platform to the Agents API — uni-1 and uni-1-max for images, ray-3.2 for video, a new base URL and a new key name — which this server does not speak and for which no MCP exists. Its reason to exist next to Luma's own `luma-official` server is breadth: extension, interpolation, upscaling and credit checks that the first-party two-tool server never shipped.

Connect

Claude Code
claude mcp add luma -- uv run --project /path/to/luma-ai-mcp-server -m luma_ai_mcp_server
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "luma": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/luma-ai-mcp-server",
        "-m",
        "luma_ai_mcp_server"
      ],
      "env": {
        "LUMA_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "luma": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/path/to/luma-ai-mcp-server",
        "-m",
        "luma_ai_mcp_server"
      ],
      "env": {
        "LUMA_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}
Auth: api_key · env LUMA_API_KEY — https://lumalabs.ai/dream-machine/api — the Agents API uses a different key under LUMA_AGENTS_API_KEY at agents.lumalabs.ai/v1

Sample tools

create_generationget_generationlist_generationsupscale_generationadd_audiogenerate_imageget_creditsget_camera_motions

Field notes

Correction on 2026-09-08: this entry previously called the repo MIT and claimed it was the only Luma server in MCP form. Neither holds — there is no LICENSE file in the repo and GitHub reports no license, so the code is technically all-rights-reserved, and Luma's own lumalabs/luma-api-mcp exists (listed here as `luma-official`). Tiny (6 stars) and last committed 2025-04-01 — functional rather than maintained; runs from a cloned repo via uv. Kept listed because nothing has been switched off: api.lumalabs.ai/dream-machine/v1/ping still answers `pong` as of 2026-10-21 and the Agents API docs announce no Dream Machine sunset, but the repo has not moved since April 2025. Luma publishes no MCP server for the Agents API, so ray-3.2 and uni-1 are reachable only over REST or the Go/Python/JS SDKs, or through fal, Replicate and Runway hub MCPs.

Also in Video Generation

Pairs well with