Luma Labs MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Luma Labs MCP or direct API to create AI videos, generate images, manage reusable files, and check generation status through natural language.

Luma Labs logoLuma Labs
Api Key

Luma Labs is an AI media generation platform for creating images, videos, and reusable assets through its Agents API. Use it to turn prompts and files into polished visual content fast.

11 Tools

Try Luma Labs now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Luma Labs
Try asking
TOOLS

Supported Tools

Every Luma Labs action and event your agent gets out of the box.

Delete File

Soft-delete a Luma file so new generations cannot reference it.

Edit Image

Submit a paid, asynchronous Luma image-edit job.

Edit Video

Submit a paid, asynchronous Ray 3.

Extract Image Layers

Submit a paid, asynchronous Luma image layer-extraction job.

Generate Image

Submit a paid, asynchronous Luma image generation job.

Generate Video

Submit a paid, asynchronous Ray 3.

Get File

Get a Luma file's metadata and current ingest, moderation, or deletion state.

Get Generation

Get the current state, failure details, and output URLs for a Luma generation.

List Files

List files in the connected Luma account, newest first, with optional state and purpose filters.

Reframe Video

Submit a paid, asynchronous Ray 3.

Upload File

Directly upload file bytes to Luma and return the file ID, metadata, and current upload/ingest state.

SETUP GUIDE

Connect Luma Labs MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Luma Labs
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Generate a photorealistic image of a futuristic workspace with warm sunset lighting'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Luma Labs API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Luma Labs Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a 5-second cinematic video of a red sports car driving through neon Tokyo streets at night'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Luma Labs actions with your Agent

Why Use Composio?

AI Native Luma Labs Integration

  • Supports both Luma Labs MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable image, video, and file workflows
  • Rich coverage for creating generations, checking status, and managing reusable Luma Labs assets

Managed Auth

  • Secure API key storage so your Luma Labs credentials don't end up in prompts or app code
  • Central place to manage, scope, and revoke Luma Labs access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned for AI agents, so media generation requests are easier for models to understand and execute
  • Clear tool inputs help agents send better prompts, file references, and generation parameters to Luma Labs
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Luma Labs
  • Scoped, least privilege access to Luma Labs generation and file workflows
  • Full audit trail of agent actions to support review, debugging, and compliance
FAQ

Frequently asked questions

Yes, Luma Labs requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Luma Labs.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Luma Labs tool your agent needs.Free to start.

Start building