@runapi.ai/luma-mcp
This server gives authenticated RunAPI access to the retired Luma model line, primarily for checking existing (historical) tasks.
login— authenticate through a browser PKCE flow, saving the API key to~/.config/runapi/config.json;forcere-runs login when credentials already exist locally.get_task— fetch the current status and latest result payload for an existing Luma task using itstask_id(optionalactiondefaults tomodify_video).check_pricing— look up pricing for the Luma line, though the README states it returns no supported model because the line is retired.modify_video— the schema exposes task creation, but the README says this model was retired on 2026-10-14; new requests return HTTP 410 before task creation or balance deduction, so only pre-existing tasks can be queried.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@runapi.ai/luma-mcp modify video at https://example.com/vid.mp4 to apply a cinematic look"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Why This Package?
@runapi.ai/luma-mcp is a focused Model Context Protocol server for the Luma model line on RunAPI.
It gives MCP-compatible assistants direct access to 0 endpoints and 0 model variants without loading the full RunAPI catalog.
Use this per-model server when an agent should stay scoped to Luma. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.
luma-modify-video was retired on 2026-10-14T00:00:00Z. New requests return HTTP 410 before task creation or balance deduction. Existing tasks can still be queried. This model ID is not mapped to another model.
Related MCP server: kling-mcp
Install
Add it to Claude Code:
claude mcp add luma -s user -- npx -y @runapi.ai/luma-mcpUse project scope when the server should be shared with a repository:
claude mcp add luma -s project -- npx -y @runapi.ai/luma-mcpCodex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:
{
"mcpServers": {
"luma": {
"command": "npx",
"args": ["-y", "@runapi.ai/luma-mcp"]
}
}
}No models in this package accept new tasks. check_pricing returns no supported model. For historical task lookup, ask your assistant to call the login tool. It opens a browser login and saves credentials to ~/.config/runapi/config.json, the same file used by runapi login.
Headless and CI hosts can still set RUNAPI_API_KEY before starting the MCP host.
Ready-made examples are in examples/ for Claude, Cursor, Windsurf, VS Code, and Roo Code.
Tools
Tool | Auth | Purpose |
| get_task | Yes | Fetch the current status and latest payload for an existing task. |
| check_pricing | No | Returns no supported model because this model line is retired. |
Models
Luma covers 0 model variants across 0 endpoints. Each tool accepts the models listed for it:
Tool | Models |
Model availability can change between releases. Use check_pricing or the Luma model page for the current catalog view.
Agent Prompts
Query an existing task with get_task. New requests for this retired model return HTTP 410.
Check the status of my existing Luma task with RunAPI.The assistant calls get_task with the task id and returns its status and available result.
Configuration
The server resolves auth in this order:
RUNAPI_API_KEYenvironment variable, useful for headless and CI hosts~/.config/runapi/config.json, created by the MCPlogintool orrunapi loginNo key, which still allows
check_pricing
The config file is normally managed by login. A pre-provisioned headless config can use:
{
"apiKey": "your_runapi_key"
}Do not commit real API keys.
Links
Resource | URL |
Luma model page | |
npm package | |
GitHub repository | |
RunAPI MCP overview | |
RunAPI docs |
License
Licensed under the Apache License, Version 2.0.
Available Tools
3 toolscheck_pricingC
Look up RunAPI pricing for the luma model line.
Inputs: model, action.
get_taskB
Fetch the current status and latest result payload for a luma task.
Inputs: task_id (required), action.
loginA
Authenticate RunAPI by opening a browser PKCE login flow and saving the API key to ~/.config/runapi/config.json.
Inputs: force.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes: pricing lookup, task status retrieval, and authentication. There is no overlap or realistic chance of an agent confusing one for another.
check_pricing and get_task follow a consistent verb_noun snake_case pattern, and login is also snake_case but is a bare verb with no noun. The minor deviation is conventional and still readable.
Three tools is borderline thin for a model-serving MCP; one slot is consumed by login and another by pricing, leaving only a single task-status tool. A minimal client could work with this, but it feels under-scoped.
The surface has a major dead end: get_task retrieves results but no tool submits or creates a Luma task, so the core generate/run workflow cannot be initiated. Pricing and login are covered, but the primary lifecycle operation is missing.
Maintenance
Related MCP Connectors
Make images and videos, price requests, list AI models and read your balance, from one API key.
Create and manage cinematic AI video renders through the Future Video Studio Agent API.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Create AI images, video, and audio, quote generation costs, and edit Sequencer projects.
Related MCP Servers
AlicenseAqualityFmaintenanceEnables AI video and image generation through the Runway API. Supports video generation from images and text prompts, image creation, video upscaling and editing, and task management.718 npm23MIT- AlicenseBqualityBmaintenanceEnables interaction with Kling AI models for video generation and avatar tasks via RunAPI, including task creation, status polling, and pricing checks.980 npmApache 2.0
- AlicenseBqualityBmaintenanceEnables AI image and video generation tasks (text-to-image, image-to-video, edit, upscale, etc.) via RunAPI, with support for polling and pricing lookups.1084 npm1Apache 2.0
- AlicenseAqualityBmaintenanceEnables creating and managing HappyHorse video generation tasks (edit, image-to-video, text-to-video) via RunAPI, with optional polling for completion and pricing lookup.654 npmApache 2.0