Summary
Connects Claude to Ssemble's AI clipping engine for generating viral short-form videos from YouTube URLs or uploaded files. Exposes eight tools including create_short for submitting jobs, get_status for polling progress, get_shorts for retrieving completed clips with viral scores, and list_requests for tracking history. Supports webhook callbacks to n8n, Zapier, or Make instead of polling, sending event payloads when processing completes. Also lets you browse caption templates, background music, gameplay overlays, and meme hooks before submitting. Processing takes 5-30 minutes. Reach for this when you want Claude to handle the full workflow of analyzing a long video, generating clips, and managing the async job lifecycle without leaving the conversation.
Install to Claude Code
verifiedclaude mcp add --transport http mcp-server https://mcp.ssemble.com/mcpRun in your terminal. Add --scope user to make it available in every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Verified live against the running server on Jun 10, 2026.
verified live9 tools
create_shortCreate AI-generated short-form video clips from a YouTube video or uploaded file. Returns a request ID instantly. Processing takes 5-30 minutes. Costs 1 credit.21 params
Create AI-generated short-form video clips from a YouTube video or uploaded file. Returns a request ID instantly. Processing takes 5-30 minutes. Costs 1 credit.
Parameters* required
end*numberEnd time in seconds (> start, max 1200s window)
urlstringYouTube video URL
musicbooleanAdd background musicdefault: false
start*numberStart time in seconds (>= 0)
layoutstringVideo framing layoutone of
auto · fill · fit · squaredefault: autoctaTextstringCTA text (max 200 chars, required when ctaEnabled=true)
fileUrlstringPublic video file URL (alternative to url)
languagestringSpoken language (ISO 639-1)one of
en · es · fr · de · it · ptdefault: enmemeHookbooleanPrepend a meme hook clip (2-5s attention grabber)default: false
gameVideobooleanAdd split-screen gameplay overlaydefault: false
hookTitlebooleanAdd animated hook title at startdefault: false
musicNamestringExact track name from list_music (case-sensitive)
ctaEnabledbooleanShow call-to-action text overlaydefault: false
noClippingbooleanSkip AI clipping, process entire range as one clipdefault: false
templateIdstringCaption template ID from list_templates (24-char hex)
webhookUrlstringOptional webhook URL for completion/failure notifications. Receives a POST with results when processing finishes.
musicVolumenumberMusic volume 0-100default: 10
memeHookNamestringExact meme hook name from list_meme_hooks (case-sensitive)
gameVideoNamestringExact game video name from list_game_videos (case-sensitive)
captionLanguagestringCaption language if different from spokenone of
en · es · fr · de · it · ptpreferredLengthstringTarget clip durationone of
under30sec · under60sec · under90sec · under3min · under5min · under10mindefault: under60secget_statusCheck processing status of a short creation request. Provide a request ID, or omit it to see your recent requests and pick one.1 params
Check processing status of a short creation request. Provide a request ID, or omit it to see your recent requests and pick one.
Parameters* required
requestIdstringThe request ID from create_short (24-char hex). Omit to see your recent requests.
get_shortsRetrieve all generated short clips for a completed request. Provide a request ID, or omit it to see your recent requests and pick one.1 params
Retrieve all generated short clips for a completed request. Provide a request ID, or omit it to see your recent requests and pick one.
Parameters* required
requestIdstringThe request ID from create_short (24-char hex). Omit to see your recent requests.
list_requestsList all short creation requests with optional status filtering, pagination, and sorting.5 params
List all short creation requests with optional status filtering, pagination, and sorting.
Parameters* required
pagenumberPage numberdefault: 1
limitnumberItems per page (1-100)default: 20
sortBystringSort fieldone of
createdAt · updatedAtdefault: createdAtstatusstringFilter by statusone of
queued · processing · completed · failed · cancelledsortOrderstringSort directionone of
asc · descdefault: descdelete_requestPermanently delete a short creation request and all generated videos. Credits are NOT refunded. This action is irreversible.1 params
Permanently delete a short creation request and all generated videos. Credits are NOT refunded. This action is irreversible.
Parameters* required
requestId*stringThe request ID to delete (24-char hex). This action is irreversible and credits are NOT refunded.
list_templatesList all available caption style templates with preview thumbnails, names, and IDs. Use the templateId when creating shorts.
List all available caption style templates with preview thumbnails, names, and IDs. Use the templateId when creating shorts.
No parameters — call it with no arguments.
list_musicList available background music tracks with names and durations. Use the exact musicName when creating shorts.2 params
List available background music tracks with names and durations. Use the exact musicName when creating shorts.
Parameters* required
pagenumberPage numberdefault: 1
limitnumberItems per page (1-100)default: 20
list_game_videosList available gameplay videos for split-screen overlays (content top, game bottom). Use the exact gameVideoName when creating shorts.2 params
List available gameplay videos for split-screen overlays (content top, game bottom). Use the exact gameVideoName when creating shorts.
Parameters* required
pagenumberPage numberdefault: 1
limitnumberItems per page (1-100)default: 20
list_meme_hooksList available meme hook clips (2-5 second attention grabbers prepended to shorts). Use the exact memeHookName when creating shorts.2 params
List available meme hook clips (2-5 second attention grabbers prepended to shorts). Use the exact memeHookName when creating shorts.
Parameters* required
pagenumberPage numberdefault: 1
limitnumberItems per page (1-100)default: 20
Ssemble MCP Server
MCP server for Ssemble AI Clipping — create viral short-form videos from any AI assistant.
Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client.
What it does
This MCP server lets AI assistants create short-form video clips from YouTube videos using Ssemble's AI clipping engine. The AI can:
- Create shorts from YouTube URLs or uploaded files
- Webhook callbacks — get notified when processing completes (works with n8n, Zapier, Make)
- Browse assets — caption templates, background music, gameplay overlays, meme hooks
- Track processing — check progress and retrieve completed clips
- Manage requests — list history, get results, delete old requests
Prerequisites
- Ssemble account with an active subscription
- API key (get it from Settings → API Keys in the Ssemble dashboard)
- Node.js >= 18
Quick Start
Claude Desktop
Edit your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"ssemble": {
"command": "npx",
"args": ["@ssemble/mcp-server"],
"env": {
"SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
}
}
}
}
Restart Claude Desktop after saving.
Claude Code
claude mcp add ssemble -- npx @ssemble/mcp-server
Then set the environment variable:
export SSEMBLE_API_KEY="sk_ssemble_your_key_here"
Cursor / VS Code / Windsurf
Add to your MCP settings:
{
"mcpServers": {
"ssemble": {
"command": "npx",
"args": ["@ssemble/mcp-server"],
"env": {
"SSEMBLE_API_KEY": "sk_ssemble_your_key_here"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
create_short | Create AI-generated short clips from a video. Returns request ID instantly. |
get_status | Check processing progress (0-100%) and current step |
get_shorts | Retrieve completed clips with video URLs, titles, viral scores |
list_requests | List all your requests with pagination and status filtering |
delete_request | Permanently delete a request and its videos |
list_templates | Browse caption style templates |
list_music | Browse background music tracks |
list_game_videos | Browse gameplay overlay videos |
list_meme_hooks | Browse meme hook attention-grabber clips |
How Processing Works
Video processing takes 5-30 minutes. Two workflows available:
Option A: Polling (manual check)
create_short— submits the job and returns instantly with a request IDget_status— check progress anytime (queued → processing → completed)get_shorts— retrieve the generated clips when done
Option B: Webhook (automated)
create_shortwithwebhookUrl— submits the job with a callback URL- When processing completes or fails, the API sends an HTTP POST to your URL with the results
- No polling needed — ideal for n8n, Zapier, Make, and custom backend integrations
Webhook payload example:
{
"event": "shorts.completed",
"requestId": "507f1f77bcf86cd799439011",
"status": "completed",
"timestamp": "2026-03-30T12:00:00.000Z",
"data": {
"shorts": [
{
"id": "...",
"title": "AI-Generated Title",
"video_url": "https://...",
"duration": 45,
"viral_score": 8.5
}
]
}
}
Usage Examples
Create shorts from a YouTube video:
"Create shorts from https://youtube.com/watch?v=abc123, use the first 10 minutes with chill background music"
Browse available assets:
"Show me all caption templates" / "What background music is available?"
Check progress:
"What's the status of my video request?"
Get results:
"Show me the clips for request 507f1f77bcf86cd799439011, sorted by viral score"
Environment Variables
| Variable | Required | Description |
|---|---|---|
SSEMBLE_API_KEY | Yes | Your Ssemble API key (starts with sk_ssemble_) |
SSEMBLE_API_BASE_URL | No | Override API base URL (default: https://aiclipping.ssemble.com/api/v1) |
Development
git clone https://gitlab.com/vlogr/ssemble-mcp-server.git
cd ssemble-mcp-server
npm install
SSEMBLE_API_KEY=sk_ssemble_your_key npm start
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
SSEMBLE_API_KEY*secretYour Ssemble API key (starts with sk_ssemble_)
Categories
Registryactive
Package@ssemble/mcp-server
TransportSTDIO, HTTP
AuthRequired
Resources8
Prompts2
Tools verifiedJun 10, 2026
UpdatedApr 13, 2026
