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
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. The workflow is:

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

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

Ssemble MCP Server