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
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
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
