mcp.film / Video Generation / Luma AI MCP Server

Luma AI MCP Server

Communityby Community (bobtista)paidverified Aug 11, 2026

Community MCP for Luma's legacy Dream Machine API; Luma's current stack is the Agents 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. Still the only direct-API option in MCP form, but it is pointed at the previous generation.

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

Tools you'll see

create_generationget_generationlist_generationsupscale_generationadd_audiogenerate_imageget_creditsget_camera_motions

Field notes

MIT but tiny (7 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: docs.lumalabs.ai still serves the Dream Machine reference and api.lumalabs.ai/dream-machine/v1/ping still returns 200 as of 2026-08-11. 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.

Pairs well with

MartiniMartini Official Featured

The film set for AI videos — direct entire productions from your agent.

text-to-video · image-to-videoremote · credits

D-ID MCP ServerD-ID Official

D-ID's hosted MCP connecting agents to the D-ID API and docs for avatar video.

avatar-video · talking-headremote · freemium

fal MCP Serverfal.ai Official

One hosted endpoint to search, run and chain 1,000+ image, video and audio models.

text-to-video · image-to-videoremote · credits