Skip to main content
Prerequisites Before you begin, create an account and get your API Key.

Getting started

Connect to HeyGen to generate AI-powered videos with avatars, manage video content, and create personalized video experiences through AI agents.
  • API
  • UI
  • Open Source
1

Install the SDKs (optional)

pip install klavis
2

Create a Strata MCP Server with HeyGen

from klavis import Klavis
from klavis.types import McpServerName

klavis_client = Klavis(api_key="YOUR_API_KEY")

# Create a Strata MCP server with HeyGen
response = klavis_client.mcp_server.create_strata_server(
    servers=[McpServerName.HEYGEN],
    user_id="user123"
)

API Reference

Full Strata API endpoints
3

Authenticate with API Key

klavis_client.mcp_server.set_strata_auth(
    strata_id=response.strata_id,
    server_name=McpServerName.HEYGEN,
    auth_data={
        "token": "YOUR_HEYGEN_API_KEY"
    }
)
🎉 Your HeyGen MCP Server is ready! Once authentication is complete, you can use your MCP server URL with any MCP-compatible client.

Available Tools

Tool NameDescription
heygen_get_remaining_creditsRetrieve the remaining credits in your HeyGen account
heygen_get_voicesRetrieve a list of available voices from the HeyGen API
heygen_get_voice_localesRetrieve a list of available voice locales (languages) from the HeyGen API
heygen_get_avatar_groupsRetrieve a list of HeyGen avatar groups
heygen_get_avatars_in_avatar_groupRetrieve a list of avatars in a specific HeyGen avatar group
heygen_list_avatarsRetrieve a list of all available avatars from the HeyGen API
heygen_generate_avatar_videoGenerate a new avatar video with the specified avatar, text, and voice
heygen_get_avatar_video_statusRetrieve the status of a video generated via the HeyGen API
heygen_list_videosRetrieve a list of videos from your HeyGen account
heygen_delete_videoDelete a video from your HeyGen account
For more details about tool input schema, use the get_tools API.

Next Steps

I