Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@heygen-mcp generate a video with avatar Ava saying hello"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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
Related MCP server: ShiLiu MCP Server
npm install
Open .env.local and paste your HeyGen API key after HEYGEN_API_KEY=
npm run dev — server runs at http://localhost:3000/api/mcp
npm run inspector — opens the MCP Inspector to test tools interactively
Push this repo to GitHub
In the Vercel dashboard: New Project → import the GitHub repo
Add HEYGEN_API_KEY under Settings → Environment Variables (Production + Preview)
Deploy. Your MCP URL is https://<your-project>.vercel.app/api/mcp
Settings → Connectors → Add custom connector → paste the deployed URL.
Next.js 15 (App Router)
mcp-handler for Streamable HTTP MCP transport
TypeScript, Zod for input validation
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Generate AI images and videos from any compatible MCP client.
AI voice generation: text-to-speech and voice cloning from any MCP client.
MCP server for Hailuo (MiniMax) AI video generation
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
