com.ssemble/mcp-server (Model Context Protocol)

This MCP server integrates Ssemble AI Clipping to create AI-powered short-form video clips from YouTube videos. It supports webhook callbacks when processing completes and is designed for use with MCP-compatible clients. The server’s capabilities include generating shorts from YouTube URLs or uploaded files, and providing asset browsing functionality.

🛠️ Key Features

Create short-form clips (“shorts”) from YouTube URLs or uploaded files
Webhook callbacks on processing completion
Browse assets (per the server README excerpt)

🚀 Use Cases

Generate Instagram Reels and TikTok-style shorts from YouTube sources
Automate video clip creation workflows using webhook-based integrations (n8n, Zapier, Make)

⚡ Developer Benefits

Works with Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and any MCP-compatible client
Uses Model Context Protocol (MCP) tooling for standardized integration

⚠️ Limitations

The provided excerpt does not describe the full set of tools (toolCount: 9) beyond the features listed above
Asset browsing and other behavior are only partially shown in the excerpt

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

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

bash

claude mcp add ssemble -- npx @ssemble/mcp-server

Then set the environment variable:

bash

export SSEMBLE_API_KEY="sk_ssemble_your_key_here"

Cursor / VS Code / Windsurf

Add to your MCP settings:

json

{
  "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 ID
get_status — check progress anytime (queued → processing → completed)
get_shorts — retrieve the generated clips when done

Option B: Webhook (automated)

create_short with webhookUrl — 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:

json

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

bash

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

url	string	optional	YouTube video URL
fileUrl	string	optional	Public video file URL (alternative to url)
start	number	required	Start time in seconds (>= 0)
end	number	required	End time in seconds (> start, max 1200s window)
preferredLength	string	optional	Target clip duration
language	string	optional	Spoken language (ISO 639-1)
captionLanguage	string	optional	Caption language if different from spoken
templateId	string	optional	Caption template ID from list_templates (24-char hex)
noClipping	boolean	optional	Skip AI clipping, process entire range as one clip
hookTitle	boolean	optional	Add animated hook title at start
memeHook	boolean	optional	Prepend a meme hook clip (2-5s attention grabber)
memeHookName	string	optional	Exact meme hook name from list_meme_hooks (case-sensitive)
gameVideo	boolean	optional	Add split-screen gameplay overlay
gameVideoName	string	optional	Exact game video name from list_game_videos (case-sensitive)
ctaEnabled	boolean	optional	Show call-to-action text overlay
ctaText	string	optional	CTA text (max 200 chars, required when ctaEnabled=true)
music	boolean	optional	Add background music
musicName	string	optional	Exact track name from list_music (case-sensitive)
musicVolume	number	optional	Music volume 0-100
layout	string	optional	Video framing layout
webhookUrl	string	optional	Optional webhook URL for completion/failure notifications. Receives a POST with results when processing finishes.

page	number	optional	Page number
limit	number	optional	Items per page (1-100)
status	string	optional	Filter by status
sortBy	string	optional	Sort field
sortOrder	string	optional	Sort direction

page	number	optional	Page number
limit	number	optional	Items per page (1-100)

page	number	optional	Page number
limit	number	optional	Items per page (1-100)

page	number	optional	Page number
limit	number	optional	Items per page (1-100)

Ssemble AI Clipping

com.ssemble/mcp-server (Model Context Protocol)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

create_short

get_status

get_shorts

list_requests

delete_request

list_templates

list_music

list_game_videos

list_meme_hooks

Ssemble MCP Server

What it does

Prerequisites

Quick Start

Claude Desktop

Claude Code

Cursor / VS Code / Windsurf

Available Tools

How Processing Works

Option A: Polling (manual check)

Option B: Webhook (automated)

Usage Examples

Environment Variables

Development

License

Install

Configuration

Related servers