About
Powered by Ray (video) and Photon (image) models by Luma AI
README
Setup
- Install Claude Desktop App or any MCP client
- Get API Key from https://lumalabs.ai/api/keys
- Run
sh setup.sh, here it will ask the API Key - paste it from 2.
Run
Open Claude Desktop or any MCP client
Features
Create Image
prompt: textaspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21" (default: "16:9")model: "photon-1", "photon-flash-1" (default: "photon-1")image_ref: list of image URLs with weights to influence generation (optional), max 8style_ref: single image URL with weight to influence style (optional), max 1character_ref: list of character image URLs (optional), max 4modify_image_ref: single image URL to modify with weight (optional), max 1
Create Video
prompt: textaspect_ratio: "1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21" (default: "16:9")model: "ray-2", "ray-flash-2", "ray-1-6" (default: "ray-2")loop: boolean (default: false)resolution: "540p", "720p", "1080p", "4k" (default: "720p")duration: "5s", "9s" (default: "5s")frame0_image: image URL (optional)frame1_image: image URL (optional)frame0_id: generation ID (optional)frame1_id: generation ID (optional)
Technical Notes
- Keyframes: Providing frame0_image/frame1_image gives more control over video start/end points
- Video Response Time: Typical video generation takes 15-60 seconds depending on duration and resolution
- Image Response Time: Typical generation takes 5-15 seconds depending on model complexity
Installing Luma Api
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/lumalabs/luma-api-mcpFAQ
Is Luma Api MCP free?
Yes, Luma Api MCP is free — one-click install via Unyly at no cost.
Does Luma Api need an API key?
No, Luma Api runs without API keys or environment variables.
Is Luma Api hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Luma Api in Claude Desktop, Claude Code or Cursor?
Open Luma Api on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
ARA
Generate images, video and audio from any AI agent — one connector.
by ARAOmni Video
An MCP server that transforms LLM-enabled IDEs into professional video editors by pre-processing footage into text proxies, generating motion graphics via HTML/
by buildwithtazaYouTube
Transcripts, channel stats, search
by YouTubeEverArt
AI image generation using various models.
by modelcontextprotocolCompare Luma Api with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All media MCPs
