# HeyGen MCP

> HeyGen automates studio-quality video production, letting you manage AI avatars, templates, and complex videos using simple conversation prompts. Connect this MCP to any agent to list avatars, generate talking head content for social media, or translate existing videos into multiple languages with perfect lip-syncing.

## Overview
- **Category:** ai-frontier
- **Price:** Free
- **Tags:** ai-avatars, video-generation, talking-head, content-creation, studio-quality, template-management

## Description

Connect your HeyGen account through this MCP to give your AI client full control over video creation. You can treat your agent like a dedicated Creative Director; it handles the heavy lifting of production management via natural conversation.

Need talking head videos? Your agent lists all available avatars and triggers video generation using specific scenes and avatar configs. Want to scale content for global teams? Use templates by providing variable mappings, generating personalized videos quickly. You can also monitor complex jobs with `get_video_status` to check progress or grab the final URL when it's ready.

If you need to update existing materials, your agent translates a video into multiple languages, retaining natural lip-syncing. Plus, you can list all templates and browse your history of generated videos. By connecting through Vinkius, you get access to this full suite of tools from any compatible AI client.

## Tools

### generate_from_template
Creates a video by replacing variables within an existing template structure.

### generate_video
Manually starts and triggers a studio-quality video generation task using specific scenes and avatar configurations.

### get_api_profile
Retrieves basic operational information about the current API account setup.

### get_template_details
Provides the structure and definitions for a specific video template, letting you know what variables are available.

### get_video_status
Checks if a generated video is finished and, if so, returns the final download URL.

### list_avatar_groups
Lists categories of avatars available in HeyGen for selection.

### list_avatars
Retrieves a full list of all digital avatars, which you need to select an ID for video generation.

### list_streaming_history
Shows the history of any interactive live streaming sessions conducted through the platform.

### list_templates
Retrieves a list of all available video templates you can use for content creation.

### list_videos
Shows a history log of all videos that have been generated via the platform.

### translate_video
Translates an existing video into another language while maintaining accurate lip-syncing.

## Prompt Examples

**Prompt:** 
```
List all available avatars and find one named 'Joshua'.
```

**Response:** 
```
I've retrieved the list of avatars. I found 'Joshua in Suit' (ID: joshua_v3) and 'Joshua Casual'. Would you like to use one of these for a video generation task?
```

**Prompt:** 
```
Show me the status of video ID 'vid_99283'.
```

**Response:** 
```
Checking video status... Your video 'vid_99283' is currently COMPLETED. You can watch it or download it here: [Watch Video](https://heygen.com/video/...) Should I retrieve your full video history?
```

**Prompt:** 
```
Generate a video from template 'welcome_v1' with variable {'name': 'John Doe'}.
```

**Response:** 
```
Template generation triggered! I've started the production of your video using the 'welcome_v1' template. This usually takes 2-5 minutes. I'll monitor the status for you. Should I notify you once the URL is ready?
```

## Capabilities

### Find available avatars
The MCP lists groups or individual avatars so you know which digital spokesperson to use for your project.

### Generate video content manually
You can trigger a studio-quality video generation task by providing specific scenes and avatar settings via the `generate_video` tool.

### Create videos from templates
The MCP allows you to automate mass content creation by replacing variables within pre-designed video templates using `generate_from_template`.

### Check production status and retrieve links
Use the `get_video_status` tool to monitor a job's progress, retrieving the final URL once the video is complete.

### Translate videos into new languages
The MCP translates an existing video into another language, automatically syncing the lip movements for realism using `translate_video`.

## Use Cases

### Rolling out global training content
A learning & development manager needs to update an HR policy video for five different countries. Instead of manually re-recording or coordinating translations, they tell their agent: 'Translate the existing video into German and Portuguese.' The `translate_video` tool handles everything, giving them localized assets immediately.

### Personalized sales follow-ups
A marketing team runs a campaign needing 50 unique videos for prospects. They use the agent to call `generate_from_template`, passing in name and company variables, ensuring each prospect gets a highly customized, professional video message.

### Rapid social media content
A creator needs daily short tips videos but doesn't have time for the studio interface. They use their agent to first `list_avatars` to pick a specific spokesperson and then call `generate_video` with three scenes, getting the finished asset in minutes.

### Tracking campaign assets
A project lead needs to know if last week's high-priority video is ready. Instead of guessing, they ask their agent to check the status using `get_video_status` and get confirmation with a direct download link.

## Benefits

- Scale personalized outreach. Use `generate_from_template` to automatically populate variables across hundreds of videos, making mass communication effortless.
- Never deal with camera setup again. The MCP lets you generate high-quality, talking head content for social media or corporate training using any listed avatar.
- Manage complex jobs easily. Instead of checking a dashboard, ask your agent to check the status using `get_video_status` and get notified when it's done.
- Go global instantly. With one prompt, use `translate_video` to turn an English video into Spanish or French while preserving perfect lip movements for local credibility.
- Understand your options fast. Use `list_avatars` to check every available spokesperson before starting a project, ensuring you pick the right look and tone.

## How It Works

The bottom line is that your agent handles the entire production pipeline without you having to manually interact with the HeyGen studio dashboard.

1. First, subscribe to this MCP and provide your HeyGen API Key in the agent's settings.
2. Next, tell your AI client exactly what you need—for example, 'Generate a video of John Doe using template X.'
3. The agent calls the appropriate tool, manages the process, and reports back when the final asset is ready.

## Frequently Asked Questions

**How do I start using HeyGen with my AI agent?**
You must first subscribe to this MCP on Vinkius and enter your specific HeyGen API Key in the agent's settings. Once that credential is stored, you can begin issuing commands like 'List all available avatars.'

**Can I use HeyGen to translate a video?**
Yes, using `translate_video` allows your agent to take an existing video and output a new version in another language while maintaining perfect lip-syncing for the speaker.

**What is the difference between `generate_video` and `generate_from_template`?**
`generate_video` creates a unique, standalone video from scratch using defined scenes. Conversely, `generate_from_template` uses pre-built templates to replace specific variables, which is better for mass personalization.

**How do I know when my generated video is ready?**
You use the `get_video_status` tool. It checks the job and will return 'completed' along with a direct URL you can immediately download or share.

**Does HeyGen MCP handle avatar selection?**
Yes, you first call `list_avatars` to see all available options. Then, you provide the specific 'avatar_id' when triggering any generation task.