RunwayML + Luma AI

This MCP server provides tools to interact with the RunwayML and Luma AI APIs for video and image generation tasks.

- Generate videos from text prompts (RunwayML or Luma AI).
- Generate videos from images (RunwayML or Luma AI).
- Generate images from text prompts (Luma AI).
- Manage Luma AI generations (list, get, delete).
- Add audio to Luma AI generations.
- Upscale Luma AI generations.
- Enhance prompts using OpenRouter LLMs before generation.

- Node.js (v18 LTS or later recommended)
- npm (usually included with Node.js)
- API Keys:

- RunwayML API Secret
- Luma AI API Key
- OpenRouter API Key (for theenhance_prompttool)
- Clone or Download:Obtain the server code.
- Navigate to Directory:Open a terminal in the server's root directory (runwayml-mcp-server).
- Install Dependencies:

npm install

- Create.envfile:In the server's root directory, create a file named.env.
- Add API Keys:Add your API keys to the.envfile:

RUNWAYML_API_SECRET=your_runwayml_api_secret_here LUMAAI_API_KEY=your_luma_api_key_here OPENROUTER_API_KEY=your_openrouter_api_key_here

- Build the Server:Compile the TypeScript code:

npm run build

MCP Client Setup (e.g., Claude Desktop App, Cline)

Configure your MCP client to connect to this server. The exact steps depend on the client, but you'll typically need to provide:

- Name:A descriptive name (e.g.,runway-luma-server)
- Command:node
- Arguments:The full path to the compiled server index file (e.g.,/path/to/your/runwayml-mcp-server/build/server-index.js)
- Environment Variables:

- RUNWAYML_API_SECRET: Your RunwayML API Secret
- LUMAAI_API_KEY: Your Luma AI API Key
- OPENROUTER_API_KEY: Your OpenRouter API Key

{ "mcpServers": { "runway-luma-server": { "command": "node", "args": ["/full/path/to/runwayml-mcp-server/build/server-index.js"], "env": { "RUNWAYML_API_SECRET": "your_runwayml_api_secret_here", "LUMAAI_API_KEY": "your_luma_api_key_here", "OPENROUTER_API_KEY": "your_openrouter_api_key_here" }, "disabled": false, "autoApprove": [] } } }

(Remember to replace/full/path/to/with the actual path on your system)

- generate_text_to_video: Generates video from text.

- provider: (Optional)runwayml(default) orlumaai.
- promptText: (Required) The text prompt.
- runway_model: (Optional) Runway model (e.g., "gen-2").
- runway_resolution: (Optional) Runway resolution (1280:768or768:1280).
- runway_watermark: (Optional) Boolean, defaultfalse.
- luma_model: (Optional) Luma model (ray-flash-2,ray-2(default),ray-1-6).
- luma_aspect_ratio: (Optional) Luma aspect ratio (e.g.,16:9(default),1:1).
- luma_loop: (Optional) Boolean.
- duration: (Optional) Video duration in seconds (number).
- seed: (Optional) Generation seed (number).

- provider: (Optional)runwayml(default) orlumaai.
- promptImage: (Required) URL of the input image, or for Runway, an array[{uri: "url", position: "first" | "last"}].
- promptText: (Optional) Text prompt to accompany the image.
- runway_model: (Optional) Runway model (gen3a_turbo(default)).
- runway_duration: (Optional) Runway duration (5(default) or10).
- runway_ratio: (Optional) Runway resolution (1280:768or768:1280).
- runway_watermark: (Optional) Boolean, defaultfalse.
- luma_model: (Optional) Luma model (ray-flash-2,ray-2(default),ray-1-6).
- luma_aspect_ratio: (Optional) Luma aspect ratio (e.g.,16:9(default)).
- luma_loop: (Optional) Boolean.
- seed: (Optional) Generation seed (number).

- original_prompt: (Required) The prompt to enhance.
- model: (Optional) OpenRouter model name (defaults to a capable model likeanthropic/claude-3.5-sonnet).
- instructions: (Optional) Specific instructions for the enhancement.

- prompt: (Required) Text prompt.
- aspect_ratio: (Optional) Luma aspect ratio (16:9(default)).
- model: (Optional) Luma image model (photon-1(default),photon-flash-1).
- image_ref: (Optional) Array of image reference objects ({url: string, weight?: number}). Max 4.
- style_ref: (Optional) Array of style reference objects ({url: string, weight?: number}). Max 1.
- character_ref: (Optional) Character reference object ({ identity0: { images: [url1, ...] } }).
- modify_image_ref: (Optional) Modify image reference object ({url: string, weight?: number}).

- limit: (Optional) Number of results (default 10).
- offset: (Optional) Offset for pagination (default 0).

- generation_id: (Required) UUID of the generation.

- generation_id: (Required) UUID of the generation.

- generation_id: (Required) UUID of the generation.
- prompt: (Required) Prompt for the audio.
- negative_prompt: (Optional) Negative prompt for audio.

- generation_id: (Required) UUID of the generation.
- resolution: (Optional) Target resolution (1080p(default) or4k).

(Note: For tools involving generation (generate_,luma_upscale), the server initiates the task and returns immediately. Progress updates and the final result URL will be sent via MCP progress notifications.)

{ "tool_name": "luma_generate_image", "arguments": { "prompt": "Overhead shot of a dark, rainy cyberpunk city street at night. Bright neon signs reflect on wet pavement, resembling rivers of light flowing between towering chrome skyscrapers. Film noir aesthetic, photorealistic.", "aspect_ratio": "16:9" } }

(Wait for image generation to complete and get the image URL)

{ "tool_name": "generate_image_to_video", "arguments": { "provider": "lumaai", "promptImage": "{IMAGE_URL_FROM_STEP_1}", "promptText": "Slow pan left across the rainy cyberpunk cityscape, neon lights flickering subtly.", "luma_aspect_ratio": "16:9", "duration": 5 } }

{ "tool_name": "luma_generate_image", "arguments": { "prompt": "A single, sleek futuristic wireless earbud floats weightlessly in the center of a bright, minimalist white room with soft, diffused ambient light. Zero gravity effect.", "aspect_ratio": "1:1", "image_ref": [{ "url": "{PRODUCT_IMAGE_URL}", "weight": 0.8 }] } }

(Wait for image generation to complete and get the image URL)*

{ "tool_name": "generate_image_to_video", "arguments": { "provider": "lumaai", "promptImage": "{IMAGE_URL_FROM_STEP_1}", "promptText": "The earbud slowly rotates and drifts gently in zero gravity.", "luma_aspect_ratio": "1:1", "duration": 5 } }

Goal:Animate an existing image using RunwayML's Gen3a model.
- (Optional) Generate Base Image (Luma):Useluma_generate_imageif you don't have an image.
- Animate Image (RunwayML):

{ "tool_name": "generate_image_to_video", "arguments": { "provider": "runwayml", "promptImage": "{YOUR_IMAGE_URL}", "promptText": "Subtle zoom in, cinematic lighting.", "runway_model": "gen3a_turbo", "runway_duration": "5", "runway_ratio": "1280:768" // Or "768:1280" } }

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Server for advanced AI-driven video editing, semantic search, multilingual transcription, generative media, voice cloning, and content moderation.

Generates AI images and videos using the GPT4O Image Generator API.

An MCP server for AI-powered video creation using the FAL AI API.

Turn any language model into a multimodal powerhouse that can generate images, music, videos and more on the fly. Rostro's tools are designed to be used by language models from the ground up, expanding capabilities with minimal context bloat.

All-in-one AI creative studio — generate videos, images, audio in 11 Indian languages, and 3D models via MCP. Hosted at mcp.arcframe.ai.

AVCLabs MCP integrates AI-powered video upscaling, quality enhancement, and SAM3 image segmentation into MCP workflows. It enhances low-resolution videos, cleans noisy footage, and extracts target objects through text prompts.

Official Cannon Studio MCP for AI video, image, 3D, audio, workflow, pricing, model, and developer API guidance.

Hosted remote MCP server for AI image and video generation from one Streamable HTTP endpoint.

A server for creating fast and free lipsync videos for digital avatars, supporting both realistic and cartoon styles.

Analyzes image and video content from URLs or local files using the Gemini 2.0 Flash model.