HeyGen MCP for AI. Create realistic talking-head videos from text prompts.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
How this MCP server connects to your AI agent
HeyGen connects your AI client directly to a powerful video studio backend. Generate high-quality, realistic talking-head videos using digital avatars that speak in any language.
Use pre-set templates for brand consistency or feed simple text prompts for quick, one-shot content creation for marketing and training.
What AI agents can do with HeyGen Automation
Remove video record
Deletes a specific video record from your managed library.
Create from template
Generates a video by automatically filling in variables within a predefined design template.
Generate ai video
Creates a full-featured talking head video using an AI avatar and provided text.
Creates a complete video using an AI avatar and text input.
Generates personalized videos by automatically replacing variables in established design templates.
Uploads images, audio files, and other media to use as inputs for video creation.
Retrieves lists of available digital avatars and professional voices for selection.
Checks the current status and retrieves final download links for long-running video generation tasks.
Ask an AI about this
Waiting for input…
What AI agents can do with HeyGen: 12 Video Generation Tools
These tools let you programmatically list available assets, upload media, generate content using prompts or templates, and track the final video status.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using HeyGen on VinkiusRemove Video Record
Deletes a specific video record from your managed library.
Create From Template
Generates a video by automatically filling in variables within a predefined design...
Generate Ai Video
Creates a full-featured talking head video using an AI avatar and provided text.
Get Api Status
Checks the overall operational status of the connected account and API key.
Get Video Progress
Monitors a video generation job using its task ID, returning progress percentage and...
List Available Avatars
Provides a list of all digital avatars available for use in videos.
List Video Templates
Retrieves available video templates, allowing you to see pre-designed structures for different content types.
List Generated Videos
Shows a list of all videos that have been previously created through the system.
List Available Voices
Retrieves a catalogue of professional voices, including language and style details.
Test Heygen Auth
Verifies that the API credentials provided are correct and active.
Upload Media Asset
Adds external media, like an image or audio file, to your content library for use in...
Generate From Prompt
Produces a complete, single-shot video based only on a simple text description.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The HeyGen integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with HeyGen, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by HeyGen. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 12 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Creating video content used to be a massive logistical headache., Solved with Vinkius AI Gateway
Today, making a batch of videos means coordinating multiple people: the writer writes the script, the designer builds the visual template, and then someone has to manually render 50 separate files. If you need to change one word in the script, you repeat that entire cycle—the whole thing gets delayed by revisions and file exports.
With this MCP, your agent handles the whole pipeline. You write the text, define the variable fields for customization, and send it off. It manages the avatar speaking, the template filling, and the final rendering. What you get is a finished video asset, ready to post.
Generating high-quality videos using the HeyGen MCP
The biggest time sinks that disappear are the manual template tweaks and the constant file management. You no longer have to copy a script into 50 different project files; you just pass the data through the system.
Your agent acts like your dedicated video production team, handling everything from selecting the right digital actor to delivering the final download link. It's an end-to-end content factory.
What your AI can actually do with this
Need professional video content but hate spending hours recording and editing? This MCP lets you skip the studio entirely. You run full AI production workflows right through your agent interface. Just tell your client what you need—a product announcement or a compliance tutorial—and it manages everything from selecting avatars to rendering the final file.
It’s about scale. Instead of manually adjusting timelines, you define parameters and let the system handle the video generation. You can create videos tailored to specific brand templates for massive campaigns or use simple text inputs to generate completely new assets on demand. If your agent client is compatible with Vinkius, this MCP gives it instant access to advanced media tools that usually require complex API calls.
019dd101-9bb9-701c-8c9c-1b45a943c2f1 
Here's how it actually works
The bottom line is, you tell your agent client what video to make, and it manages all the steps needed to generate and deliver the finished file.
Subscribe to this MCP and provide your API key.
Instruct your agent client to list available avatars or voices first. This confirms the connection is working and shows you what assets are ready.
Use a specific tool, like generate_from_prompt, giving it the text and avatar details. The system then kicks off the job and provides a task ID for later tracking.
Who is this actually for?
This connector serves content marketers who need rapid ad volume, sales teams needing personalized outreach at scale, and corporate trainers who must convert long-form documentation into engaging, repeatable video modules.
Needs to run continuous campaigns generating dozens of slight variations in messaging or avatars for A/B testing across social platforms.
Must create personalized video follow-ups for prospects, making it look like a 1:1 conversation without recording every single person.
Needs to convert complex policy manuals or training guides into engaging modules using professional digital avatars, eliminating the need for human presenters.
What Changes When You Connect
Scale production without hiring more editors. Use create_from_template to generate hundreds of personalized ads by simply updating variable fields like product names or client logos.
Skip the setup time. If you just need a quick demo video, use generate_from_prompt. It lets your agent turn any text idea into a visible asset immediately.
Manage all inputs in one place. Before generating anything, use upload_media_asset to add custom images or audio clips so the avatar can interact with your brand's specific visual identity.
Never wonder if the job finished. Use get_video_progress whenever you need a status check on a long-running render, getting instant download links when it’s done.
Ensure consistency across campaigns. By listing assets using list_available_avatars and checking voices with list_available_voices, you keep your brand's digital presence uniform.
See it in action
Updating Product Documentation
A technical writer needs to update a compliance guide across 50 different regional manuals. Instead of recording 50 videos, they connect the MCP, use list_video_templates to find the right structure, and then run create_from_template, updating only the local regulation text for each region automatically.
Running a Sales Campaign
A sales team member has 100 prospects. They want to send a personalized video message mentioning the prospect's company name and product of choice. The agent uses upload_media_asset for the logo, then calls generate_ai_video, passing in unique variables for each client.
Rapid Ad Testing
A marketer needs 20 versions of an ad to test different headlines. They use list_available_avatars to pick a consistent face, and then cycle through various short prompts using generate_from_prompt, quickly feeding the resulting assets into their platform.
Monitoring Large Batches
A training department sends out 50 videos for review. They use list_generated_videos to see all job IDs, and then periodically call get_video_progress until every single asset is marked as complete.
The honest tradeoffs
Treating it like a simple text generator
Telling the agent client to 'make me a video about X.' without specifying if it needs a template, custom assets, or just a prompt.
Always start by checking available resources. Use list_video_templates first to see if your content fits an existing structure, then use that structure with create_from_template. Don't rely on the generic generate_ai_video until you know what specific inputs are required.
Skipping asset preparation
Trying to generate a video featuring a specific company logo or unique audio clip without uploading it first.
Before any generation, always call upload_media_asset and get the reference ID. The video tools require this prepared media link to include your custom brand assets.
Calling multiple jobs sequentially
Running 50 different videos one after another without checking status, causing the agent to fail or time out on a complex render.
For high volume work, break it up. Run small batches and check progress using get_video_progress between batches. This manages API load and prevents cascading failures.
When It Fits, When It Doesn't
Use this MCP if your primary bottleneck is video production speed or scaling content across many similar pieces. If you have a consistent brand style, templates are key; start with list_video_templates and then use create_from_template. Don't use it if your goal is purely to write scripts; that’s a language model task. You need this MCP when the script is done, but you still lack the visual output. If you only want to check credentials, run test_heygen_auth first. If you just want to browse options, start with list_available_avatars. Never try to generate anything without confirming your API access via get_api_status; it's a simple check that saves time later.
Questions you might have
How do I check if this MCP is connected correctly using get_api_status? +
Run get_api_status. This tool immediately verifies your credentials and tells you if the account connection is active, saving you from wasting time on failed generation attempts.
What's the difference between generate_ai_video and generate_from_prompt? +
Use generate_from_prompt for quick, ad-hoc videos based only on text. Use generate_ai_video when you need more control over variables or are using a structured template.
Can I add my own images to the video with upload_media_asset? +
Yes, upload_media_asset lets you add any image or audio file. You then reference this asset ID when calling your main generation tools.
How do I find out what kind of videos I can make? (list_video_templates) +
Calling list_video_templates shows you all the pre-built structures available. This helps you pick a proven format that already works for your industry.
How do I use `get_video_progress` to track a long video generation job? +
You pass the unique task ID into get_video_progress. This tells you exactly where the video is in the queue, whether it’s 25% done or still processing. It's essential for monitoring large batches so you know when to expect the final download link.
What does `list_available_voices` show me when I need a specific language or accent? +
This tool fetches a comprehensive list of every voice available in HeyGen. You can filter this data by gender, language, and tone (e.g., professional vs. casual). This lets you pick the perfect voice for your content without guesswork.
If I make a mistake or need to clean up old files, how do I use `remove_video_record`? +
remove_video_record deletes specific video creations from your library. You just need the record's ID to run it. This keeps your asset management clean and ensures you only work with current content.
Should I always run `test_heygen_auth` before starting any video generation? +
Yes, running test_heygen_auth verifies that your API key is active and correctly configured. It quickly confirms the connection between this MCP and HeyGen, preventing frustrating errors later.
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.
We've already built the connector for HeyGen. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 12 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.