Documentation Index
Fetch the complete documentation index at: https://developers.heygen.com/llms.txt
Use this file to discover all available pages before exploring further.
HeyGen Remote MCP lets AI agents like Manus, Claude, Gemini CLI, and Cursor create HeyGen videos on your behalf using your existing HeyGen account. It uses the Model Context Protocol (MCP) over a hosted endpoint, so there’s nothing to install or run locally.
You authenticate once with OAuth, and your agent gets access to HeyGen’s video tools — using the credits from your current plan.
Endpoint:
https://mcp.heygen.com/mcp/v1/
What You Can Do
Once connected, your AI agent has access to the following tools:
Video Agent
| Tool Name | Description |
|---|
create_video_agent | One-shot video generation from a prompt — the agent handles scripting, avatar selection, scene composition, and rendering. Supports generate (fire-and-forget) and chat (multi-turn) modes. |
get_video_agent_session | Get the current status, progress, video_id, and recent chat messages for a session. |
send_video_agent_message | Send a follow-up message to an existing chat-mode session. Use to answer agent questions, add context, or request edits to a generated video. |
get_video_agent_resource | Get a single session resource (image, video, draft, avatar, voice, etc.) by its resource_id. |
list_video_agent_session_videos | List all videos produced within a Video Agent session. |
stop_video_agent_session | Stop an active agent run at its next checkpoint. Partial results are preserved. |
Videos
| Tool Name | Description |
|---|
create_video_from_avatar | Create a video from a HeyGen avatar (video or photo avatar) with a text script or audio file. |
create_video_from_image | Create a video by animating an arbitrary image with lip-sync to provided audio or generated speech. |
list_videos | List videos in the account with pagination and optional filtering. |
get_video | Get detailed information about a video including status, URLs, and metadata. |
delete_video | Permanently delete a video. This action cannot be undone. |
Avatars
| Tool Name | Description |
|---|
list_avatar_groups | List avatar groups (characters). Each group contains one or more looks. Filterable by ownership (public/private). |
get_avatar_group | Get details for a specific avatar group including name, preview URLs, looks count, and training status. |
list_avatar_looks | List avatar looks (outfits, poses, styles). The look id is the avatar_id to pass when creating a video. |
get_avatar_look | Get details for a specific avatar look including supported engines, preferred orientation, and training status. |
update_avatar_look | Update the display name of an avatar look. Photo avatar and digital twin looks only. |
create_digital_twin | Create a new avatar from video footage. Avatar training is asynchronous. |
create_photo_avatar | Create a new avatar from a photo. Avatar training is asynchronous. |
create_prompt_avatar | Create a new avatar from a text prompt. Avatar training is asynchronous. |
create_avatar_consent | Initiate the consent flow for an avatar group. Returns a URL for the user to complete approval in their browser. |
Voices
| Tool Name | Description |
|---|
create_speech | Synthesize speech from text using a specified voice. Supports plain text and SSML. Returns a URL to the generated audio file. |
list_voices | List voices with pagination. Filterable by type (public/private), engine, language, and gender. |
design_voice | Find voices matching a natural-language description (e.g. “warm, confident female narrator”). Returns up to 3 matches. |
Lip Sync
| Tool Name | Description |
|---|
create_lipsync | Replace the audio on an existing video and re-animate lip movements to match the new audio. |
list_lipsyncs | List all lipsync jobs in the account with pagination. |
get_lipsync | Get details for a lipsync job including status, video_url, and caption_url. |
update_lipsync | Update the display title of a lipsync job. |
delete_lipsync | Permanently delete a lipsync job and its associated files. |
Video Translation
| Tool Name | Description |
|---|
create_video_translation | Translate a video into one or more target languages with voice cloning and lip-sync. |
list_video_translations | List all video translation jobs in the account with pagination. |
get_video_translation | Get details for a translation job including status, output language, and video_url. |
update_video_translation | Update the display title of a video translation job. |
delete_video_translation | Permanently delete a video translation and its associated files. |
list_video_translation_languages | List all supported target languages for video translation. |
Account
| Tool Name | Description |
|---|
get_current_user | Get the authenticated user’s profile, remaining credits, and billing details. |
Supported Products
HeyGen Remote MCP works with any MCP-compatible agent, including:
- Claude (Web, Desktop, and Code)
- Gemini CLI
- Cursor
- Manus
- Superhuman
- OpenAI
- and more
See the dedicated setup guide for each product for detailed instructions.
Connect Your Own Agent
You can integrate HeyGen Remote MCP into any custom agent or application that supports the Model Context Protocol. Just point it to the endpoint:
https://mcp.heygen.com/mcp/v1/
How It Works
- Connect — Add the HeyGen remote MCP endpoint to your agent
- Authenticate — Sign in with your HeyGen account via OAuth (one-time)
- Use — Your agent calls HeyGen tools directly in conversation or code
All video generation uses your existing HeyGen plan and credits. There are no separate API charges or additional billing.
Remote MCP
| Remote MCP |
|---|
| Setup | Add endpoint URL, authenticate via OAuth |
| Runs on | HeyGen’s hosted infrastructure |
| Authentication | OAuth (no API key needed) |
| Billing | Web plan + premium credits |
| Best for | Most users — quick setup, works everywhere |
FAQ
Do I need an API key? No. Remote MCP uses OAuth authentication tied to your HeyGen account. No API key required.
Does this cost extra? No. Video generation uses the credits included in your existing HeyGen plan.
Which HeyGen plans support this? Remote MCP is available on all HeyGen plans.
Can I use my custom avatars and voices? Yes. Any avatars and voices available in your HeyGen account are accessible through Remote MCP.
What’s the difference between this and the HeyGen API? The HeyGen API gives you direct REST endpoints for programmatic control. Remote MCP wraps those capabilities so AI agents can use them conversationally — without you writing integration code.
