{
  "markdown": "# Ssemble MCP Server\n\nMCP server for [Ssemble AI Clipping](https://aiclipping.ssemble.com) — create viral short-form videos from any AI assistant.\n\nWorks with **Claude Desktop**, **Claude Code**, **Cursor**, **VS Code**, **Windsurf**, and any MCP-compatible client.\n\n## What it does\n\nThis MCP server lets AI assistants create short-form video clips from YouTube videos using Ssemble's AI clipping engine. The AI can:\n\n- **Create shorts** from YouTube URLs or uploaded files\n- **Webhook callbacks** — get notified when processing completes (works with n8n, Zapier, Make)\n- **Browse assets** — caption templates, background music, gameplay overlays, meme hooks\n- **Track processing** — check progress and retrieve completed clips\n- **Manage requests** — list history, get results, delete old requests\n\n## Prerequisites\n\n- [Ssemble account](https://app.ssemble.com) with an active subscription\n- API key (get it from Settings → API Keys in the Ssemble dashboard)\n- Node.js >= 18\n\n## Quick Start\n\n### Claude Desktop\n\nEdit your config file:\n\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"ssemble\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ssemble/mcp-server\"],\n      \"env\": {\n        \"SSEMBLE_API_KEY\": \"sk_ssemble_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n### Claude Code\n\n```bash\nclaude mcp add ssemble -- npx @ssemble/mcp-server\n```\n\nThen set the environment variable:\n\n```bash\nexport SSEMBLE_API_KEY=\"sk_ssemble_your_key_here\"\n```\n\n### Cursor / VS Code / Windsurf\n\nAdd to your MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"ssemble\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ssemble/mcp-server\"],\n      \"env\": {\n        \"SSEMBLE_API_KEY\": \"sk_ssemble_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `create_short` | Create AI-generated short clips from a video. Returns request ID instantly. |\n| `get_status` | Check processing progress (0-100%) and current step |\n| `get_shorts` | Retrieve completed clips with video URLs, titles, viral scores |\n| `list_requests` | List all your requests with pagination and status filtering |\n| `delete_request` | Permanently delete a request and its videos |\n| `list_templates` | Browse caption style templates |\n| `list_music` | Browse background music tracks |\n| `list_game_videos` | Browse gameplay overlay videos |\n| `list_meme_hooks` | Browse meme hook attention-grabber clips |\n\n## How Processing Works\n\nVideo processing takes 5-30 minutes. Two workflows available:\n\n### Option A: Polling (manual check)\n1. `create_short` — submits the job and returns instantly with a request ID\n2. `get_status` — check progress anytime (queued → processing → completed)\n3. `get_shorts` — retrieve the generated clips when done\n\n### Option B: Webhook (automated)\n1. `create_short` with `webhookUrl` — submits the job with a callback URL\n2. When processing completes or fails, the API sends an HTTP POST to your URL with the results\n3. No polling needed — ideal for n8n, Zapier, Make, and custom backend integrations\n\nWebhook payload example:\n```json\n{\n  \"event\": \"shorts.completed\",\n  \"requestId\": \"507f1f77bcf86cd799439011\",\n  \"status\": \"completed\",\n  \"timestamp\": \"2026-03-30T12:00:00.000Z\",\n  \"data\": {\n    \"shorts\": [\n      {\n        \"id\": \"...\",\n        \"title\": \"AI-Generated Title\",\n        \"video_url\": \"https://...\",\n        \"duration\": 45,\n        \"viral_score\": 8.5\n      }\n    ]\n  }\n}\n```\n\n## Usage Examples\n\n**Create shorts from a YouTube video:**\n> \"Create shorts from https://youtube.com/watch?v=abc123, use the first 10 minutes with chill background music\"\n\n**Browse available assets:**\n> \"Show me all caption templates\" / \"What background music is available?\"\n\n**Check progress:**\n> \"What's the status of my video request?\"\n\n**Get results:**\n> \"Show me the clips for request 507f1f77bcf86cd799439011, sorted by viral score\"\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `SSEMBLE_API_KEY` | Yes | Your Ssemble API key (starts with `sk_ssemble_`) |\n| `SSEMBLE_API_BASE_URL` | No | Override API base URL (default: `https://aiclipping.ssemble.com/api/v1`) |\n\n## Development\n\n```bash\ngit clone https://gitlab.com/vlogr/ssemble-mcp-server.git\ncd ssemble-mcp-server\nnpm install\nSSEMBLE_API_KEY=sk_ssemble_your_key npm start\n```\n\n## License\n\nMIT\n",
  "bytes": 4528,
  "sha": "86059f47da42ce67c6edfc343b9ebd3044e727aaa04f475ea7d1362ecb113c3b",
  "repo_slug": "ssembleinc/ssemble-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_ssemble_mcp_server_d0da10b8/readme"
}