# Ssemble AI Clipping

Create AI-powered short-form video clips from YouTube videos using any AI assistant.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add ssemble/mcp-server

# Browse available tools
npx -y @smithery/cli@latest tool list ssemble/mcp-server

# Get full schema for a tool
npx -y @smithery/cli@latest tool get ssemble/mcp-server create_short

# Call a tool
npx -y @smithery/cli@latest tool call ssemble/mcp-server create_short '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-server--ssemble.run.tools`

**Required config:**
- `SSEMBLE_API_KEY` (header) — Your Ssemble API key (starts with sk_ssemble_)

## Tools (9)

- `create_short` — Create AI-generated short-form video clips from a YouTube video or uploaded file. Returns a request ID instantly. Proce…
- `get_status` — Check processing status and progress of a short creation request. Returns status (queued/processing/completed/failed), …
- `get_shorts` — Retrieve all generated short clips for a completed request. Returns video URLs, AI-generated titles, descriptions, vira…
- `list_requests` — List all short creation requests with optional status filtering, pagination, and sorting.
- `delete_request` — Permanently delete a short creation request and all generated videos. Credits are NOT refunded. This action is irrevers…
- `list_templates` — List all available caption style templates with IDs and names. Use the templateId when creating shorts.
- `list_music` — List available background music tracks with names and durations. Use the exact musicName when creating shorts.
- `list_game_videos` — List available gameplay videos for split-screen overlays (content top, game bottom). Use the exact gameVideoName when c…
- `list_meme_hooks` — List available meme hook clips (2-5 second attention grabbers prepended to shorts). Use the exact memeHookName when cre…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get ssemble/mcp-server <tool-name>
```

## Resources

- `ssemble://supported-languages`
- `ssemble://preferred-lengths`
- `ssemble://layouts`

## Prompts (2)

- `create-viral-short` (0, 1) — Guided workflow for creating an optimized viral short from a YouTube video
- `batch-process-videos` (0) — Template for processing multiple YouTube videos into shorts