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