# HeyGen MCP for AI Agents AI Agent Connect > HeyGen MCP lets you manage AI avatars, generate studio-quality videos, and automate personalized video content directly from your AI agent. It handles everything from template variable replacement to multi-language translation with lip-syncing, moving your entire video production workflow into a single chat interface. ## Overview - **Category:** ai-frontier - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_7MndYBo64pejF5PNsGREWY0wiMu7RCeRkYmZjGz5/ai-agent-connect - **Tags:** ai-avatars, video-generation, text-to-video, synthetic-media, content-creation, digital-human ## Description You can basically turn your AI agent into a full-scale video production house. Instead of jumping into a web studio to manually click around and adjust sliders, you just tell your agent what you need to build. If you have a series of personalized outreach videos, you can give the agent a template and a list of names, and it will crank out the finished files while you focus on other tasks. It handles the heavy lifting of finding the right avatar, setting up the scenes, and even translating your existing content into different languages with perfect lip-syncing. You will spend less time fiddling with configuration and more time thinking about the creative direction. It is a huge jump in efficiency when you use the Vinkius catalog to connect these tools, as it puts the entire HeyGen studio inside your chat interface. You get to monitor the progress of every task and grab the final URLs without ever leaving your workspace. This makes it possible to handle high-volume video production without needing a massive production team or spending hours on manual exports. ## Tools ### remove_video_record Delete video ### create_from_template Use template for video ### generate_ai_video Create avatar video ### get_api_status Check connection ### get_video_progress Check video status ### list_available_avatars List AI actors ### list_video_templates List design templates ### list_generated_videos List past creations ### list_available_voices List AI voices ### test_heygen_auth Verify credentials ### upload_media_asset Add image/audio source ### generate_from_prompt One-shot prompt to video ## Prompt Examples **Prompt:** ``` I need to make a video for a new client named Sarah. Use the 'welcome_v1' template. ``` **Response:** ``` I've started the production for your video using the 'welcome_v1' template with the name **Sarah**. **Status:** - **Task:** Video Generation - **Template:** welcome_v1 - **Estimated Time:** 2-5 minutes I'll keep an eye on the progress and let you know as soon as the final URL is ready. Would you like me to check it for you in a minute? ``` **Prompt:** ``` Find me an avatar that looks like a professional businessman. ``` **Response:** ``` I've searched your HeyGen avatar library. Here are the best matches for a professional look: | Avatar Name | ID | | :--- | :--- | | **Joshua in Suit** | `joshua_v3` | | **Business Professional** | `biz_pro_01` | | **Corporate Executive** | `corp_exec_05` | Which one would you like to use for your next video? ``` **Prompt:** ``` Translate my last generated video into French. ``` **Response:** ``` I'm starting the translation process for your most recent video. **Details:** - **Source Language:** English - **Target Language:** French - **Feature:** Automatic Lip-Syncing This will ensure the avatar's mouth movements match the new French audio perfectly. I'll notify you once the translated file is ready for download. ``` ## Capabilities ### Batch video production Replace variables in templates to create personalized videos at scale. ### Avatar selection Browse and identify specific public or custom avatars for your projects. ### Multi-language translation Convert existing videos into new languages with automated lip-syncing. ### Task monitoring Check the status of active video renders and grab the final URLs. ### Template management List and inspect the structure of your pre-designed video templates. ### History browsing Access your previous video generations and interactive streaming sessions. ## Use Cases ### Scaling personalized sales outreach A sales lead wants to send 500 personalized 'thank you' videos. They ask their agent to use generate_from_template with a CSV of names, and the agent handles the batch production automatically. ### Rapidly localizing training content An L&D manager needs to turn a 5-minute English training video into Spanish and French. They ask their agent to use translate_video to create the dubbed versions with lip-sync. ### Quickly creating social media talking heads A creator wants a quick video about a new product. They ask their agent to find a specific avatar using list_avatars and then trigger a custom generation with a specific script. ### Managing a high-volume video library A marketing team needs to find a specific video from last month. They ask their agent to use list_videos to browse history and find the correct URL for a recap report. ## Benefits - Scale personalized video outreach by using generate_from_template to swap names and details across hundreds of files. - Save hours on localization by using translate_video to turn your existing content into new languages with natural lip-syncing. - Find the perfect visual identity quickly by using list_avatars to browse all available public and custom options. - Stop guessing if your renders are done by using get_video_status to pull final URLs the moment they are ready. - Keep your creative assets organized by using list_templates and list_videos to manage your entire production library. - Remove the need for manual studio clicks by triggering complex scene configurations directly through your AI agent. ## How It Works The bottom line is you get a video production assistant that handles the technical execution of your creative ideas. 1. Subscribe to the HeyGen MCP and grab your API key from your Developer settings. 2. Connect the key to your preferred AI client like Claude or Cursor. 3. Tell your agent to generate a video, translate a file, or list your avatars. ## Frequently Asked Questions **How does the HeyGen MCP help with personalized marketing videos?** It lets your AI agent handle the repetitive work of creating unique videos for different people. By using templates, your agent can swap out names, dates, or specific details for hundreds of customers at once, giving you a personalized video for everyone without the manual effort. **Can I use the HeyGen MCP to translate videos with lip-sync?** Yes, that is one of the core features. You can ask your agent to take an existing video and translate it into another language. The Connector handles the lip-syncing automatically so the avatar's speech looks natural in the new language. **What kind of avatars can I access through the HeyGen MCP?** You can access a wide variety of avatars, including public ones, instant avatars, and your own custom photo avatars. Your agent can list these for you so you can pick the right face for your project. **Is the HeyGen MCP good for corporate training videos?** It's excellent for L&D teams. You can use it to quickly generate high-quality talking head videos for training modules or translate those modules into multiple languages to reach a global audience quickly. **How do I know when my video is finished?** Your AI agent can check the status of any video it starts for you. It will monitor the render progress and then provide you with the final URL as soon as the video is complete, so you don't have to keep checking the website. **Can I manage my video templates using the HeyGen MCP?** Yes, you can list all your available templates and even see the specific variables each one requires. This helps you stay organized and ensures your agent has the right info to build your videos correctly. **How do I find my HeyGen API Key?** Log in to your HeyGen account, navigate to **User Settings**, and select the **Developer** tab. You will be able to generate and copy your unique API key from there. **How can I generate a video using a template?** First, use `list_templates` to find the template you want. Then, use the `generate_from_template` tool by providing the template ID and a JSON string mapping the variables (like text or image URLs) you want to replace. **Can I translate existing videos into other languages?** Yes! Use the `translate_video` tool. You must provide the source video URL and the target language code. HeyGen will generate a new version of the video with the translated audio and lip-syncing. **Is the integration secure for creative data?** Absolutely. The integration uses official HeyGen API keys over HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure. **How do I choose the right avatar for my video?** Use the `list_available_avatars` tool to browse all options. Your agent will provide the names and unique `avatar_id` for each character, which you can then use in your generation requests. **Can I generate a video without specifying an avatar or voice?** Yes! Use the `generate_from_prompt` tool (Video Agent). Simply describe what you want, and HeyGen will automatically select the best-matching avatar and voice for your content. **Is it possible to automate personalized videos for multiple customers?** Absolutely. Use the `create_from_template` tool by providing a `templateId` and a set of variables. Your AI agent can iterate through your customer list and trigger unique videos for each person.