MCP.so
Sign In

Luma AI MCP Server 🎥

@bobtista

About Luma AI MCP Server 🎥

No overview available yet

Basic information

Category

Other

Runtime

python

Transports

stdio

Publisher

bobtista

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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-here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Luma AI MCP Server?

The Luma AI MCP Server integrates with Luma AI’s Dream Machine API (v1) to provide tools for generating, managing, and manipulating AI‑generated videos and images through Large Language Models. It enables AI assistants like Claude Desktop to create videos, images, and advanced animations without leaving the chat interface.

How to use Luma AI MCP Server?

Obtain a Luma API key from Luma AI, then configure the server in your Claude Desktop configuration file (e.g., claude_desktop_config.json) by specifying the path to the server and setting the LUMA_API_KEY environment variable. Once set up, use tools like create_generation, get_generation, list_generations, upscale_generation, add_audio, generate_image, get_credits, and get_camera_motions directly in conversations.

Key features of Luma AI MCP Server

  • 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 and video upscaling
  • Credit management and generation tracking

Use cases of Luma AI MCP Server

  • Generate videos from a text description (e.g., “a cat playing piano”)
  • Convert a static image into an animated video
  • Extend or interpolate between two existing videos using keyframes
  • Add AI‑generated audio to a completed video generation
  • Upscale a finished video to a higher resolution (e.g., 1080p → 4K)

FAQ from Luma AI MCP Server

What API does the server use?

It uses Luma AI’s Dream Machine API (v1). A valid Luma API key must be set in the LUMA_API_KEY environment variable.

What video models and resolutions are supported?

Video models: ray-2 (default, best quality), ray-flash-2 (faster), and ray-1-6 (legacy). Resolutions: 540p, 720p, 1080p, 4k. Only durations of 5s or 9s are supported.

Can I upscale any video?

Only completed video generations can be upscaled, the target resolution must be higher than the original, and each generation can be upscaled only once.

What are the generation states?

Generations progress through queued, dreaming, completed, and failed. You can check status using the get_generation tool.

How is the server invoked?

The server runs via uv as an MCP‑compliant CLI command, configured in the host application’s MCP settings file (e.g., Claude Desktop’s claude_desktop_config.json).

Comments

More Other MCP servers