Overview

Connect HeyGen video generation to any MCP-compatible AI agent — no API keys, no local server, no separate credits.

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:

Tool Name	Description
create_video_agent	Create a video from a text prompt using HeyGen’s Video Agent. This is the recommended way to create videos — just describe what you want and the agent handles avatar selection, scripting, and production.
create_avatar_video	Create a video from a specific avatar or image with full control over avatar, voice, and script. Use this only when you need explicit control over avatar selection and scripting. For most video creation, use create_video_agent instead.
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. Supports both generated and translated videos.
delete_video	Permanently delete a video. Supports both generated and translated videos.
text_to_speech	Synthesize speech audio from text using a specified voice. Returns a URL to the generated audio file along with duration and optional word-level timestamps.
list_audio_voices	List voices available for TTS generation with cursor-based pagination. Filter by type (public/private), language, and gender.
get_user_me	Get current user info, remaining balance, and billing.
create_video_translate	Translate a video into one or more target languages.
list_video_translate_languages	List all supported target language codes for video translation.
get_video_translate_caption	Get the caption file (SRT or VTT) for a completed video translation.

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/

For security, HeyGen Remote MCP uses domain whitelisting. If your agent runs on a domain that isn’t already whitelisted, you’ll need to request access before it can connect.

To request domain whitelisting, submit your domain here: [link]

How It Works

1. Connect — Add the HeyGen remote MCP endpoint to your agent
2. Authenticate — Sign in with your HeyGen account via OAuth (one-time)
3. 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.