# Cinder Haus — HeyGen MCP

A Model Context Protocol server that exposes HeyGen's video generation API to MCP-compatible clients (Claude desktop, Cursor, etc.). Built as a case study for *Forging Your Own Knight*.

## Tools

- **`list_avatars`** — list available avatars and talking photos
- **`generate_video`** — render a video from `script` + `avatar_id`; sensible defaults (avatar's default voice, solid white background, 1920×1080)
- **`get_video_status`** — check render progress; returns the video URL when complete

## Local dev

1. `npm install`
2. Open `.env.local` and paste your HeyGen API key after `HEYGEN_API_KEY=`
3. `npm run dev` — server runs at `http://localhost:3000/api/mcp`
4. `npm run inspector` — opens the MCP Inspector to test tools interactively

## Deploy to Vercel

1. Push this repo to GitHub
2. In the Vercel dashboard: New Project → import the GitHub repo
3. Add `HEYGEN_API_KEY` under Settings → Environment Variables (Production + Preview)
4. Deploy. Your MCP URL is `https://<your-project>.vercel.app/api/mcp`

## Register in Claude desktop

Settings → Connectors → Add custom connector → paste the deployed URL.

## Stack

- Next.js 15 (App Router)
- `mcp-handler` for Streamable HTTP MCP transport
- TypeScript, Zod for input validation