Ssemble AI Clipping

ssembleinc/ssemble-mcp-server

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.

GitHub stars: 7
tools: 10
auth: Secret needed
transport: STDIO, HTTP
env var: 1
last updated: Nov 12, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.ssemble.com/mcp --name ssemble

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http ssemble https://mcp.ssemble.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 10 tools

Verified live against the running server on Nov 6, 2026.

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

backgroundColorstring

Solid background color as hex, e.g. "#000000". Only with blurBackground=false. Omit to use the account's saved background color, else the template color.

blurBackgroundboolean

Background behind the clip when the source does not fill the 9:16 canvas (mainly layout=fit): true = blurred copy of the video, false = solid color (backgroundColor, else the account's saved color,...

captionLanguagestring

Caption language if different from spokenone of en · es · fr · de · it · pt

captionsEnabledboolean

Burn captions into the clips (default true). Set false for sources that already have captions.default: true

ctaEnabledboolean

Show call-to-action text overlaydefault: false

ctaTextstring

CTA text (max 200 chars, required when ctaEnabled=true)

customSourceLinkstring

Own link for the Source line, e.g. "mysite.com/videos" (https:// added if missing, max 300 chars). Requires includeSourceLink=true.

end*number

End time in seconds (> start, max 1200s window)

fileUrlstring

Public video file URL (alternative to url)

gameVideoboolean

Add split-screen gameplay overlaydefault: false

gameVideoNamestring

Exact game video name from list_game_videos (case-sensitive)

hookTitleboolean

Add animated hook title at startdefault: false

hookTitlePresetIdstring

Hook title style (requires hookTitle=true). classic-pill (default) = black text on white pills; dark-pill = white on dark pills; bold-outline = white text with black outline; classic = one white bo...one of classic-pill · dark-pill · bold-outline · editorial · statement · classic

hookTitleStyleobject

Your own hook title design. Required when hookTitlePresetId is 'custom', not allowed otherwise. Titles in Korean, Japanese, Chinese, Arabic, Hebrew, Hindi or Thai use a font made for that script.

includeSourceLinkboolean

When these clips are later scheduled from the Ssemble web app (Share / Calendar), end each caption with "Source: <link>": customSourceLink if set, else the original YouTube video. Omit to use the a...

languagestring

Spoken language (ISO 639-1)one of en · es · fr · de · it · ptdefault: en

layoutstring

Video framing layoutone of auto · fill · fit · squaredefault: auto

maxShortsinteger

Maximum number of shorts to create (1-12). Keeps the highest-scoring clips and never pads, so short videos may return fewer. Omit to get up to 12.

memeHookboolean

Prepend a meme hook clip (2-5s attention grabber)default: false

memeHookNamestring

Exact meme hook name from list_meme_hooks (case-sensitive)

+16 more parameters. See the server's own documentation for the full schema.

get_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

requestIdstring

The 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

requestIdstring

The 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

limitnumber

Items per page (1-100)default: 20

pagenumber

Page numberdefault: 1

sortBystring

Sort fieldone of createdAt · updatedAtdefault: createdAt

sortOrderstring

Sort directionone of asc · descdefault: desc

statusstring

Filter by statusone of queued · processing · completed · failed · cancelled

delete_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*string

The 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

limitnumber

Items per page (1-100)default: 20

pagenumber

Page numberdefault: 1

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

limitnumber

Items per page (1-100)default: 20

pagenumber

Page numberdefault: 1

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

limitnumber

Items per page (1-100)default: 20

pagenumber

Page numberdefault: 1

list_postsList your scheduled and published social posts (YouTube, Instagram, TikTok) with status, public URL and publish time. Filter by status, platform, request, clip or time window; use date=published with since to find posts that went live after a given moment.10 params

List your scheduled and published social posts (YouTube, Instagram, TikTok) with status, public URL and publish time. Filter by status, platform, request, clip or time window; use date=published with since to find posts that went live after a given moment.

Parameters* required

datestring

Which timestamp since/until filter and sort by. Use "published" with since to poll for newly live posts.one of scheduled · published

limitinteger

Items per page (1-100)default: 50

pageinteger

Page numberdefault: 1

platformstring

Filter by platformone of youtube · instagram · tiktok

requestIdstring

Only posts made from this request (24-char hex request ID)

shortIdstring

Only posts made from this clip (short ID)

sincestring

ISO 8601 lower bound. Applies to scheduledAt, or to publishedAt when date=published

sourcestring

manual = scheduled by hand from the shorts list; automation = posted by channel automationone of manual · automation

statusstring

Filter by post status: scheduled (queued), processing (uploading or waiting for the platform), published (live, has url), failed (has error), canceledone of scheduled · processing · published · failed · canceled

untilstring

ISO 8601 upper bound (same field as since)

Configuration

SSEMBLE_API_KEY*secret

Your Ssemble API key (starts with sk_ssemble_)

Readme

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:

View the full README on GitHub

Details

Repository: github.com/ssembleinc/ssemble-mcp-server
Website: www.ssemble.com/mcp
Categories: Automation & Workflows, Media & Entertainment
Package: @ssemble/mcp-server
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Resources: 10
Prompts: 2
Tools verified: Nov 6, 2026

Related Automation & Workflows MCP servers

View all

Vugolavcoder25/vugola-mcpClip videos into captioned shorts, add captions, and schedule posts from AI agents.7stars

SideButton MCP Serversidebutton/sidebuttonOpen-source MCP server with browser automation and knowledge packs for AI agents6stars

SilbercueSwiftsilbercue/silbercueswiftFastest iOS MCP server. 40 tools: xcresult parsing, WDA automation, 0.3s screenshots.5stars

Bridge MCPbarhamagha1/bridge-mcpVisual Desktop Bridge - Give any AI full control over Windows to automate apps and inputs.4stars

Expo Android MCPfrndchagas/expo-androidMCP server for Android emulator automation via ADB.4stars

BulkPublishazeemkafridi/bulkpublish-apiSchedule, cross-post, and analyze social media posts across 15 platforms from AI agents.0stars