Lumiclip

io.github.lumiclipPublished by GitHub account lumiclipv3.0.0Updated Oct 24, 2026

Turn YouTube videos into short-form clips from any AI assistant

VerifiedSTDIODesktop onlyProductivity & Workflow Media & Design

Server details

Identifier: io.github.lumiclip/lumiclip
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account lumiclip for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.lumiclip%2Flumiclip.svg)](https://sourceweft.com/mcp/io.github.lumiclip%2Flumiclip?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Turns a YouTube video into short vertical clips with subtitles, returning download-ready files from an AI assistant.

What you can do: Lumiclip starts clip generation from a YouTube URL and returns a project ID immediately. Tools let the assistant poll project status, list past projects, fetch details for a single clip, and check plan credits and usage. Finished clips are ranked by score and come with download URLs, vertical 9:16 framing, and subtitles. A callback URL can be supplied so results are pushed by webhook instead of polled.
When to use it: Useful when you want an assistant to repurpose long YouTube videos into short-form clips without leaving the chat, for example to pull highlight moments for social posting. It fits workflows where clip generation is one step among others, such as n8n automations or custom integrations.
Requirements: Runs locally over stdio via npx @lumiclip/mcp-server, so Node.js is needed. A Lumiclip API key is required in the LUMICLIP_API_KEY environment variable; the API base URL can be overridden with LUMICLIP_API_URL. Network access to the Lumiclip API and YouTube is required. A remote Streamable HTTP endpoint is also documented for clients that support it.

Before you install

The API key LUMICLIP_API_KEY is a secret and is passed in plain text in configuration and in the Authorization bearer header. Clip generation consumes paid credits, and an insufficient-credits error means you must buy more. Generated clips and thumbnails are hosted on Lumiclip's CDN, and the source YouTube URL is sent to Lumiclip's servers. Webhook callbacks can be signed with an X-Lumiclip-Signature header derived from the API key.

Installation

In SourceWeft

Open Lumiclip in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

[smithery badge] [Lumiclip MCP server]

Quick Start

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

Setup

Claude Desktop / Cursor

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

json

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

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

Cursor Directory

Install in Cursor

Smithery

Remote (Streamable HTTP)

For n8n, custom integrations, or any client that supports remote MCP:

Endpoint: https://mcp.lumiclip.ai/mcp
Auth: Authorization: Bearer sk_live_...
Transport: Streamable HTTP (POST)

Tools

Tool	What it does
`generate_clips`	Start clip generation from a YouTube URL. Returns a `project_id` right away.
`get_project_status`	Check progress and get clips when ready. Clips are sorted by score (best first).
`list_projects`	List your projects with status and clip counts.
`get_clip`	Get full details for a single clip.
`check_usage`	See your plan, remaining credits, and usage.

How It Works

Call generate_clips with a YouTube URL
Get back a project_id immediately
Poll get_project_status every 10–15 seconds (or pass a callback_url for webhook)
When done, clips are sorted by score (best first), each with a download_url

Statuses

Project: pending → processing → completed (or completed_no_clips / failed)

Processing steps: queued → DOWNLOADING_VIDEO → EXTRACTING_AUDIO → TRANSCRIBING → DETECTING_HIGHLIGHTS → CUTTING_CLIPS → EXPORTING_CLIPS → done

Clips: pending → exporting → completed (or failed). The download_url is available when clip_status is completed.

API Reference

`generate_clips`

Start clip generation from a YouTube video.

Field	Type	Required	Description
`url`	string	Yes	Full YouTube video URL
`start_time`	number	No	Start time in seconds (to process only a segment)
`end_time`	number	No	End time in seconds (to process only a segment)
`callback_url`	string	No	Webhook URL to receive results when done

json

{  "project_id": "43dbe622-8ac6-4579-9625-0ad7f0f9db0b",  "status": "processing",  "poll_url": "/api/v1/projects/43dbe622-8ac6-4579-9625-0ad7f0f9db0b",  "estimated_minutes": 5,  "message": "Processing started. Poll with get_project_status every 10-15 seconds until status is 'completed'."}

{  "project_id": "43dbe622-8ac6-4579-9625-0ad7f0f9db0b",  "status": "processing",  "poll_url": "/api/v1/projects/43dbe622-8ac6-4579-9625-0ad7f0f9db0b",  "estimated_minutes": 5,  "message": "Processing started. Poll with get_project_status every 10-15 seconds until status is 'completed'."}

`get_project_status`

Check progress and get clips.

json

{  "id": "43dbe622-...",  "name": "Video Title",  "status": "completed",  "step": "done",  "error": null,  "expected_clips": 9,  "duration": 639,  "created_at": "2026-03-15T02:21:46.226Z",  "clips": [    {      "id": "32538b9c-...",      "title": "One Dating Theory Leads to Chaos",      "duration": 41.83,      "score": 90,      "reason": "Sharp universal joke that hooks instantly with strong reactions.",      "clip_status": "completed",      "download_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-....mp4",      "quality": "1080p",      "thumbnail_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-...-thumb.jpg",      "created_at": "2026-03-15T02:29:10.954Z",      "updated_at": "2026-03-15T02:30:43.907Z"    }  ]}

{  "id": "43dbe622-...",  "name": "Video Title",  "status": "completed",  "step": "done",  "error": null,  "expected_clips": 9,  "duration": 639,  "created_at": "2026-03-15T02:21:46.226Z",  "clips": [    {      "id": "32538b9c-...",      "title": "One Dating Theory Leads to Chaos",      "duration": 41.83,      "score": 90,      "reason": "Sharp universal joke that hooks instantly with strong reactions.",      "clip_status": "completed",      "download_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-....mp4",      "quality": "1080p",      "thumbnail_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-...-thumb.jpg",      "created_at": "2026-03-15T02:29:10.954Z",      "updated_at": "2026-03-15T02:30:43.907Z"    }  ]}

Clips are sorted by score (highest first).

`list_projects`

json

{  "projects": [    {      "id": "43dbe622-...",      "name": "Video Title",      "status": "completed",      "step": "done",      "expected_clips": 9,      "clips_count": 8,      "duration": 639,      "created_at": "2026-03-15T02:21:46.226Z"    }  ],  "total": 1,  "limit": 20,  "offset": 0}

{  "projects": [    {      "id": "43dbe622-...",      "name": "Video Title",      "status": "completed",      "step": "done",      "expected_clips": 9,      "clips_count": 8,      "duration": 639,      "created_at": "2026-03-15T02:21:46.226Z"    }  ],  "total": 1,  "limit": 20,  "offset": 0}

`get_clip`

json

{  "id": "32538b9c-...",  "project_id": "43dbe622-...",  "title": "One Dating Theory Leads to Chaos",  "duration": 41.83,  "score": 90,  "reason": "Sharp universal joke that hooks instantly.",  "export_status": "completed",  "export_quality": "1080p",  "is_exported": true,  "video_url": "https://cdn.lumiclip.ai/...",  "video_url_720p": "https://cdn.lumiclip.ai/...",  "video_url_1080p": "https://cdn.lumiclip.ai/...",  "thumbnail_url": "https://cdn.lumiclip.ai/...",  "created_at": "2026-03-15T02:29:10.954Z",  "updated_at": "2026-03-15T02:30:43.907Z"}

{  "id": "32538b9c-...",  "project_id": "43dbe622-...",  "title": "One Dating Theory Leads to Chaos",  "duration": 41.83,  "score": 90,  "reason": "Sharp universal joke that hooks instantly.",  "export_status": "completed",  "export_quality": "1080p",  "is_exported": true,  "video_url": "https://cdn.lumiclip.ai/...",  "video_url_720p": "https://cdn.lumiclip.ai/...",  "video_url_1080p": "https://cdn.lumiclip.ai/...",  "thumbnail_url": "https://cdn.lumiclip.ai/...",  "created_at": "2026-03-15T02:29:10.954Z",  "updated_at": "2026-03-15T02:30:43.907Z"}

`check_usage`

No input required.

json

{  "plan": "pro",  "credits_remaining": 450,  "credits_total": 500,  "period_start": "2026-03-01T00:00:00.000Z",  "period_end": "2026-04-01T00:00:00.000Z"}

{  "plan": "pro",  "credits_remaining": 450,  "credits_total": 500,  "period_start": "2026-03-01T00:00:00.000Z",  "period_end": "2026-04-01T00:00:00.000Z"}

Errors

HTTP Status	Error	What to do
400	Invalid YouTube URL	Check the URL format
401	Unauthorized	Check your API key
402	Insufficient credits	Buy more credits or use a shorter video
429	Rate limit exceeded	Wait and try again
500	Internal server error	Try again later

Webhooks

Pass a callback_url when calling generate_clips to receive a POST when all clips are ready.

Completed:

json

{  "event": "project.completed",  "project_id": "43dbe622-...",  "status": "completed",  "source_url": "https://www.youtube.com/watch?v=H51iLa1leOU",  "clips": [    {      "id": "32538b9c-...",      "title": "One Dating Theory Leads to Chaos",      "duration": 41.83,      "score": 90,      "download_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-....mp4",      "thumbnail_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-...-thumb.jpg",      "quality": "1080p"    }  ]}

{  "event": "project.completed",  "project_id": "43dbe622-...",  "status": "completed",  "source_url": "https://www.youtube.com/watch?v=H51iLa1leOU",  "clips": [    {      "id": "32538b9c-...",      "title": "One Dating Theory Leads to Chaos",      "duration": 41.83,      "score": 90,      "download_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-....mp4",      "thumbnail_url": "https://cdn.lumiclip.ai/exports/premium/.../clip-32538b9c-...-thumb.jpg",      "quality": "1080p"    }  ]}

Failed:

json

{  "event": "project.failed",  "project_id": "43dbe622-...",  "status": "failed",  "error": "YouTube video is unavailable",  "clips": []}

{  "event": "project.failed",  "project_id": "43dbe622-...",  "status": "failed",  "error": "YouTube video is unavailable",  "clips": []}

Clips are sorted by score (highest first). We retry up to 3 times if your server doesn't respond.

Signature verification (optional): Each callback includes an X-Lumiclip-Signature header. Compute HMAC-SHA256 of the request body using SHA-256(your_api_key) as the signing key. Compare with the header value (sha256=<hex>).

Using with n8n

Option A — Webhook (recommended):

Create a workflow with a Webhook trigger node. Copy its URL.

Add an HTTP Request node: POST https://api.lumiclip.ai/api/v1/clips/generate with Header Auth (Authorization: Bearer sk_live_...) and body:

json

{  "url": "https://www.youtube.com/watch?v=...",  "callback_url": "https://your-n8n.com/webhook/abc123"}

{  "url": "https://www.youtube.com/watch?v=...",  "callback_url": "https://your-n8n.com/webhook/abc123"}

When clips are ready, the Webhook node receives the payload.
Best clip: {{ $json.clips[0].download_url }}

Option B — Polling loop:

POST to generate clips (same as above, without callback_url).
Wait 15 seconds → GET https://api.lumiclip.ai/api/v1/projects/{{ $json.project_id }} → IF status is not completed, loop back to Wait.

REST API

For direct HTTP calls without MCP:

Method	Endpoint	Description
`POST`	`/api/v1/clips/generate`	Start clip generation
`GET`	`/api/v1/projects/:id`	Get project status and clips
`GET`	`/api/v1/projects`	List projects
`GET`	`/api/v1/clips/:id`	Get single clip details
`GET`	`/api/v1/account/usage`	Check credits and plan

Base URL: https://api.lumiclip.ai — All endpoints require Authorization: Bearer sk_live_...

Environment Variables

License

MIT

Source: README.md at commit 8da27d8

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v3.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Field	Type	Required	Description
`limit`	number	No	Max projects to return. Default 20, max 100.
`status`	string	No	Filter: `pending`, `processing`, `completed`, `completed_no_clips`, `failed`

Variable	Required	Default
`LUMICLIP_API_KEY`	Yes	—
`LUMICLIP_API_URL`	No	`https://api.lumiclip.ai`

Lumiclip

Overview

Installation

In SourceWeft

Other MCP clients

README

@lumiclip/mcp-server

Quick Start

Setup

Claude Desktop / Cursor

Cursor Directory

Smithery

Remote (Streamable HTTP)

Tools

How It Works

Statuses

API Reference

generate_clips

get_project_status

list_projects

get_clip

check_usage

Errors

Webhooks

Using with n8n

REST API

Environment Variables

Links

License

Tools

Version history

Score

More servers like Lumiclip

Koji · AI video ads

`generate_clips`

`get_project_status`

`list_projects`

`get_clip`

`check_usage`