# mcp-luma

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add acedatacloud-mcp/mcp-luma

# Browse available tools
npx -y @smithery/cli@latest tool list acedatacloud-mcp/mcp-luma

# Get full schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-luma luma_list_aspect_ratios

# Call a tool
npx -y @smithery/cli@latest tool call acedatacloud-mcp/mcp-luma luma_list_aspect_ratios '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-luma--acedatacloud-mcp.run.tools`

**Required config:**
- `x-api-key` (header) — AceDataCloud API Bearer Token (get from https://platform.acedata.cloud)

## Tools (8)

- `luma_list_aspect_ratios` — List all available aspect ratios for Luma video generation.
- `luma_list_actions` — List all available Luma API actions and corresponding tools.
- `luma_get_task` — Query the status and result of a video generation task.
- `luma_get_tasks_batch` — Query multiple video generation tasks at once.
- `luma_generate_video` — Generate AI video from a text prompt using Luma Dream Machine.
- `luma_generate_video_from_image` — Generate AI video using reference images as start and/or end frames.
- `luma_extend_video` — Extend an existing video with additional content.
- `luma_extend_video_from_url` — Extend an existing video using its URL.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-luma <tool-name>
```

## Prompts (3)

- `luma_video_generation_guide` — Guide for choosing the right Luma tool for video generation.
- `luma_workflow_examples` — Common workflow examples for Luma video generation.
- `luma_prompt_suggestions` — Prompt writing suggestions for Luma video generation.