How to Use the HeyGen MCP in Windsurf

Q: How do I configure the HeyGen MCP Server inside Windsurf?

Add the configuration block to your mcpconfig.json file under the mcpServers key. Cascade immediately detects the eleven video tools, letting you generate avatars without restarting the editor.

Q: Can Windsurf run video translations in the background?

Yes, Cascade uses the translatevideo tool to submit translation tasks and then polls getvideostatus autonomously. You can keep writing code while the editor handles the polling loop.

Q: How does Windsurf select templates for HeyGen video generation?

The agent calls listtemplates to fetch your active layouts, then runs gettemplatedetails to read the required inputs. It automatically maps your local workspace data to the template variables before rendering.

Generate and translate videos autonomously using Cascade inside Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect HeyGen MCP to Windsurf

Create your Vinkius account to connect HeyGen to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup HeyGen with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated video production pipelines in Windsurf

Use the `get_template_details` tool inside Windsurf to inspect your video structures before rendering. Cascade reads the required inputs and maps them to `generate_from_template` to start the render. Windsurf tracks the status using `get_video_status` until the MP4 URL is ready. It handles the entire loop in the background while you write code.

Local localization runs using the HeyGen MCP Server

Run the `translate_video` tool directly from your Windsurf workspace to localize content. Cascade reads your local JSON files, pairs them with the translation tool, and spins up multi-lingual versions of your footage. You don't have to jump to a web browser to check your account status. Cascade checks your credits with `get_api_profile` and lists active projects via `list_videos` to keep your workspace in sync.

Dynamic avatar selection inside your codebase

Query the `list_avatars` tool to let Windsurf scan and select the perfect presenter. Cascade runs this alongside `list_avatar_groups` to find the exact ID matching your design requirements. Once it finds the right presenter, Windsurf feeds that configuration right into `generate_video` to build custom scenes. Your editor handles the assets directly, turning raw code files into ready-to-use video configurations.

Setup guide

Set up HeyGen MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the HeyGen MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my HeyGen payment history." If connected, Cascade will call the HeyGen tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "heygen-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect HeyGen now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about HeyGen MCP in Windsurf

Add the configuration block to your `mcp_config.json` file under the `mcpServers` key. Cascade immediately detects the eleven video tools, letting you generate avatars without restarting the editor.

Yes, Cascade uses the `translate_video` tool to submit translation tasks and then polls `get_video_status` autonomously. You can keep writing code while the editor handles the polling loop.

The agent calls `list_templates` to fetch your active layouts, then runs `get_template_details` to read the required inputs. It automatically maps your local workspace data to the template variables before rendering.

Run a quick prompt asking Cascade to check your account status. It will invoke `get_api_profile` and print your remaining video credits directly in the chat panel.

All API keys and template variable payloads run through the Vinkius sandboxed environment. Your raw video links and avatar IDs never touch external third-party logging systems, keeping your media assets strictly private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript