# crabcut-mcp-server

Generate TikTok, Shorts, and Reels-ready clips from any YouTube video, powered by AI. Crabcut automatically detects the most engaging moments, adds subtitles, reframes to 9:16 vertical, and returns d…

## Quick Start

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

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

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

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

## Direct MCP Connection

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

**Required config:**
- `apiKey` (header) — Your Crabcut API key (starts with sk_live_). Get one at https://app.crabcut.ai/developers

## Tools (5)

- `generate_clips` — Start AI clip generation from a YouTube video. Returns {project_id, status, poll_url, estimated_minutes}. Poll with get…
- `get_project_status` — Returns {id, name, status, step, error, expected_clips, duration, clips[]}. Clips sorted by score, each with clip_statu…
- `list_projects` — Returns {projects[], total, limit, offset}. Each project has id, name, status, step, expected_clips, clips_count, durat…
- `get_clip` — Returns full clip details: id, project_id, title, duration, score, reason, export_status, export_quality, is_exported, …
- `check_usage` — Returns {plan, credits_remaining, credits_total, period_start, period_end}. Check before generate_clips to confirm enou…

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