Lumiclip

lumiclip/lumiclip-mcp-server

Connects Claude or Cursor to Lumiclip's video clipping API. You get five tools: generate_clips takes a YouTube URL and returns a project_id, get_project_status polls for completion and delivers scored clips with download URLs, list_projects shows your queue, get_clip fetches details, and check_usage shows remaining credits. Clips come back reframed for vertical (9:16), subtitled, and ranked by score. Supports webhook callbacks or polling. Requires a Lumiclip API key from app.lumiclip.ai/developers. Works over stdio locally or via remote HTTP transport for n8n and similar platforms. Useful when you're batch processing podcast or interview content into social clips without leaving your editor.

tools: 5
auth: Secret needed
transport: STDIO
env var: 1
last updated: Apr 29, 2026

View on GitHub

Tools

5 tools

Public tool metadata for what this MCP can expose to an agent.

generate_clipsStart AI clip generation from a YouTube video. Returns {project_id, status, poll_url, estimated_minutes}. Poll with get_project_status every 10-15 seconds, or provide a callback_url for webhook notification.4 params

Start AI clip generation from a YouTube video. Returns {project_id, status, poll_url, estimated_minutes}. Poll with get_project_status every 10-15 seconds, or provide a callback_url for webhook notification.

Parameters* required

callback_urlstring

Webhook URL to receive a POST when all clips are ready with download links.

end_timenumber

End time in seconds to clip only a segment. Omit to process the full video.

start_timenumber

Start time in seconds to clip only a segment. Omit to process the full video.

urlstring

Full YouTube video URL (e.g. https://www.youtube.com/watch?v=...)

get_project_statusReturns {id, name, status, step, error, expected_clips, duration, clips[]}. Clips sorted by score, each with clip_status (pending/exporting/completed/failed) and download_url when ready.1 params

Returns {id, name, status, step, error, expected_clips, duration, clips[]}. Clips sorted by score, each with clip_status (pending/exporting/completed/failed) and download_url when ready.

Parameters* required

project_idstring

The project ID returned by generate_clips.

list_projectsReturns {projects[], total, limit, offset}. Each project has id, name, status, step, expected_clips, clips_count, duration, created_at.2 params

Returns {projects[], total, limit, offset}. Each project has id, name, status, step, expected_clips, clips_count, duration, created_at.

Parameters* required

limitnumber

Maximum projects to return. Defaults to 20, max 100.

statusstring

Filter by status.one of pending · processing · completed · completed_no_clips · failed

get_clipReturns full clip details: id, project_id, title, duration, score, reason, export_status, export_quality, is_exported, video_url, thumbnail_url.1 params

Returns full clip details: id, project_id, title, duration, score, reason, export_status, export_quality, is_exported, video_url, thumbnail_url.

Parameters* required

clip_idstring

The unique clip ID from a project's clips array.

check_usageReturns {plan, credits_remaining, credits_total, period_start, period_end}. Check before generate_clips to confirm enough credits.

Returns {plan, credits_remaining, credits_total, period_start, period_end}. Check before generate_clips to confirm enough credits.

No parameter schema in public metadata yet.

Configuration

LUMICLIP_API_KEY*secret

Your Lumiclip API key from app.lumiclip.ai/developers

Readme

@lumiclip/mcp-server

Turn long videos into short clips — from Claude, Cursor, or any AI assistant that supports MCP.

Give it a YouTube link. It finds the best moments, reframes for vertical video (9:16), adds subtitles, and returns download-ready clips.

Quick Start

Get an API key at app.lumiclip.ai/developers
Run:

LUMICLIP_API_KEY=sk_live_... npx @lumiclip/mcp-server

Setup

Claude Desktop / Cursor

Add to your config file — claude_desktop_config.json for Claude, .cursor/mcp.json for Cursor:

{
  "mcpServers": {
    "lumiclip": {
      "command": "npx",
      "args": ["@lumiclip/mcp-server"],
      "env": {
        "LUMICLIP_API_KEY": "sk_live_..."
      }
    }
  }
}

Cursor Directory

Install in Cursor

Smithery

npx @smithery/cli mcp add lumiclip/lumiclip

View the full README on GitHub

Details

Repository: github.com/lumiclip/lumiclip-mcp-server
Category: Media & Entertainment
Package: @lumiclip/mcp-server
Transport: STDIO
Auth: Required
Registry: MCP registry, active

Related Media & Entertainment MCP servers

View all

Clyptnelsonjordanme/clypt-mcp-serverModel Context Protocol server for Clypt — submit podcast URLs, receive clips and trailer.0stars

Soluble(s) — Podcast de journalisme de solutionspetitsolu/soluble-mcpSolutions journalism podcast (FR): ecology, climate, society. Search, transcripts, junior versions.0stars

Openversepipeworx-io/mcp-openverseOpenverse MCP — Creative-Commons-licensed image + audio search.0stars

Tastedivepipeworx-io/mcp-tastediveTasteDive MCP — cross-media recommendations (free with key)0stars

SocialCrawlridiodevelopment/socialcrawl-mcpOne API for social, commerce, travel, jobs, finance and web data, with exact credit pricing.0stars

Mcpopentweetio/mcp-serverManage your Twitter/X presence from any AI assistant — schedule, threads, and more0stars