MCPLuma MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add --transport http -H "Authorization: Bearer YOUR_API_TOKEN" luma-dream-machine https://luma.mcp.acedata.cloud/mcp
Required:Authorization
README.md

AI video generation with Luma Dream Machine via MCP

MCP Luma

A Model Context Protocol (MCP) server for AI video generation using Luma Dream Machine through the AceDataCloud API.

Generate AI videos directly from Claude, VS Code, or any MCP-compatible client.

Features

  • Text to Video - Create AI-generated videos from text prompts
  • Image to Video - Animate images with start/end frame control
  • Video Extension - Extend existing videos with additional content
  • Multiple Aspect Ratios - Support for 16:9, 9:16, 1:1, and more
  • Loop Videos - Create seamlessly looping animations
  • Clarity Enhancement - Optional video quality enhancement
  • Task Tracking - Monitor generation progress and retrieve results

Quick Start

1. Get Your API Token

  1. Sign up at AceDataCloud Platform
  2. Go to the API documentation page
  3. Click "Acquire" to get your API token
  4. Copy the token for use below

2. Use the Hosted Server (Recommended)

AceDataCloud hosts a managed MCP server — no local installation required.

Endpoint: https://luma.mcp.acedata.cloud/mcp

All requests require a Bearer token. Use the API token from Step 1.

Claude.ai

Connect directly on Claude.ai with OAuth — no API token needed:

  1. Go to Claude.ai Settings → Integrations → Add More
  2. Enter the server URL: https://luma.mcp.acedata.cloud/mcp
  3. Complete the OAuth login flow
  4. Start using the tools in your conversation
Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Cursor / Windsurf

Add to your MCP config (.cursor/mcp.json or .windsurf/mcp.json):

{
  "mcpServers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
VS Code (Copilot)

Add to your VS Code MCP config (.vscode/mcp.json):

{
  "servers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Or install the Ace Data Cloud MCP extension for VS Code, which bundles all 11 MCP servers with one-click setup.

JetBrains IDEs
  1. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
  2. Click AddHTTP
  3. Paste:
{
  "mcpServers": {
    "luma": {
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Claude Code

Claude Code supports MCP servers natively:

claude mcp add luma --transport http https://luma.mcp.acedata.cloud/mcp \
  -h "Authorization: Bearer YOUR_API_TOKEN"

Or add to your project's .mcp.json:

{
  "mcpServers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Cline

Add to Cline's MCP settings (.cline/mcp_settings.json):

{
  "mcpServers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Amazon Q Developer

Add to your MCP configuration:

{
  "mcpServers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Roo Code

Add to Roo Code MCP settings:

{
  "mcpServers": {
    "luma": {
      "type": "streamable-http",
      "url": "https://luma.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}
Continue.dev

Add to `.continue

Tools (3)

generate_videoCreate AI-generated videos from text prompts or images
extend_videoExtend existing videos with additional content
get_task_statusMonitor generation progress and retrieve results

Environment Variables

AuthorizationrequiredBearer token from AceDataCloud platform

Configuration

claude_desktop_config.json
{"mcpServers": {"luma": {"type": "streamable-http", "url": "https://luma.mcp.acedata.cloud/mcp", "headers": {"Authorization": "Bearer YOUR_API_TOKEN"}}}}

Try it

Generate a 16:9 video of a futuristic city skyline at sunset.
Animate this image of a cat sitting on a fence, making it look like it's looking around.
Create a seamlessly looping video of ocean waves crashing on the shore.
Check the status of my video generation task with ID 12345.
Extend the video I just generated to include a transition to a night scene.

Frequently Asked Questions

What are the key features of MCPLuma?

Text to Video generation from prompts. Image to Video animation with start/end frame control. Video extension capabilities. Support for multiple aspect ratios including 16:9, 9:16, and 1:1. Seamless loop creation and clarity enhancement.

What can I use MCPLuma for?

Creating social media content directly from a chat interface. Rapid prototyping of video concepts for creative projects. Automating the generation of background animations for presentations. Extending short video clips for storytelling purposes.

How do I install MCPLuma?

Install MCPLuma by running: Add to ~/Library/Application Support/Claude/claude_desktop_config.json

What MCP clients work with MCPLuma?

MCPLuma works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep MCPLuma docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare