Overview

The Lucas MCP Server lets you generate AI videos from any MCP-compatible platform. 

Ask for a video, get a video — the AI agent handles the workflow automatically.

Endpoint: https://lucas-mcp.idomoo.ai/mcp

Supported Platforms:

  • Amazon Quick Suite
  • Claude Code (CLI)
  • Cursor
  • Any MCP-compatible AI agent with custom header support

Authentication

Choose one of two methods:

Option A: OAuth 2.0 Bearer Token

Authorization: Bearer <your_oauth_access_token>

Option B: MCP API Key (for permanent configurations)

X-Lucas-MCP-Key: <your_mcp_key>

To obtain an MCP key, contact support or your professional services representative. You'll need your Studio account ID and account API key (found in Settings → Account → API Settings).

Available Tools

Workflow

create_brief → get_brief (poll) → create_blueprint → get_blueprint (poll) → create_video → get_video (poll)

1. create_brief

Generates a video concept from a natural language prompt.

ParameterTypeRequiredDescription
promptstringYesNatural language prompt describing the video
brand_idstringNoBrand ID to apply brand guidelines

2. get_brief

Retrieves the status and content of a brief. Poll until status='Done'.

ParameterTypeRequiredDescription
brief_idstringYesBrief ID returned from create_brief

Status values: 'In process', 'Done', 'Error'

3. create_blueprint

Generates a detailed video structure from a completed brief.

ParameterTypeRequiredDescription
brief_idstringYesBrief ID from a brief with status='Done'
durationintegerNoDesired video length in seconds (min: 15, max: 900)

4. get_blueprint

Retrieves the status and content of a blueprint. Poll until status='Done'.

ParameterTypeRequiredDescription
blueprint_idstringYesBlueprint ID returned from create_blueprint

Status values: 'In process', 'Done', 'Error'

5. create_video

Starts video rendering from a completed blueprint.

ParameterTypeRequiredDescription
blueprint_idstringYesBlueprint ID from a blueprint with status='Done'

6. get_video

Retrieves the status and URL of a rendered video. Poll until status='Done'.

ParameterTypeRequiredDescription
ai_video_idstringYesVideo ID returned from create_video

Status values: 'In process', 'Done', 'Error'

Response when status='Done':

  • video_url — URL to download or stream the video
  • format — Video format ('mp4' or 'hls')
  • duration — Video duration in seconds

Platform Setup

Amazon Quick Suite

  1. Go to Integrations > Actions
  2. Click Add MCP Server
  3. Enter name, description, and MCP server endpoint URL: https://lucas-mcp.idomoo.ai/mcp
  4. Click Next to configure service authentication
  5. Enter credentials:
    • Client ID: Your Studio account ID
    • Client Secret: Your account API key
    • Token URL: https://lucas-mcp.idomoo.ai/oauth/token
  6. Click Create and Continue
  7. The action appears in your existing actions list

Claude Code

claude mcp add --transport sse lucas https://lucas-mcp.idomoo.ai/mcp \  --header "X-Lucas-MCP-Key: <your_mcp_key>"

Cursor

  1. Go to Settings > Tools & MCP
  2. Click New MCP Server
  3. Add configuration:
{
  "mcpServers": {
    "lucas": {
      "type": "http",
      "url": "https://lucas-mcp.idomoo.ai/mcp",
      "headers": {
        "X-Lucas-MCP-Key": "<your_mcp_key>"
      }
    }
  }
}


Tip: When using the agent, reference the server name in your prompt (e.g., "using lucas mcp, create a video about...").

Support

  • Technical Support: support@idomoo.com