# Synthesia MCP for AI Agents AI Agent Connect > Synthesia MCP connects your AI client to the Synthesia platform. Use it to generate corporate avatar videos from text prompts, manage video templates, and automate dubbing for existing media. It turns your agent into a virtual studio director that can handle production tasks directly from your terminal or chat interface. ## Overview - **Category:** ai-frontier - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_BTjzwpZhHlU767EmgXX8KCFCpPfKeKC241oWiNw7/ai-agent-connect - **Tags:** ai-video, synthetic-media, avatar-generation, video-dubbing, content-creation ## Description The Synthesia MCP lets you turn your AI client into a virtual studio director for synthetic video production. Instead of jumping between tabs to pick avatars, write scripts in a web editor, and manually manage templates, you can handle the entire lifecycle from your terminal. This connector lets you treat video creation like a data task. You can ask your agent to find a professional avatar, grab a specific layout, and spin up a new video track without ever leaving your current workspace. Whether you're spinning up a series of training modules or localizing a global announcement, this connector makes the process repeatable. You can query your existing library, check on rendering progress, or trigger dubbing for dozens of files at once. By hosting this on Vinkius, you get a managed way to bring enterprise-grade video generation into your daily workflow. It's about moving from manual clicks to programmatic creation. ## Tools ### get_video_details Check the current status of a video. This helps you see if a render is finished or still processing. ### delete_video Remove a video from your account permanently. This action is irreversible, so use it carefully. ### list_avatars See all available AI avatars. This helps you pick the right persona for your next video project. ### get_template_details Get specific information about a single template. Use this to understand the inputs needed for a creation pass. ### list_voices See the range of available AI voices. This is useful for choosing the right tone and language for your content. ### dub_video Translate an existing video into another language. This tool handles the AI dubbing process for you automatically. ### create_avatar_video Generate a new video using a script and an avatar. This is the core tool for creating synthetic media from scratch. ### create_video_from_template Create a video based on a specific template. It returns a unique ID for you to track the progress. ### list_videos View every video currently in your account. Use this to audit your library or find specific past projects. ### list_templates Browse the available video templates. You can use these to maintain a consistent look across different videos. ## Prompt Examples **Prompt:** ``` Give me a list of internal AI video templates, select one related to 'customer support', and execute a creation pass using proper test inputs. ``` **Response:** ``` Accessing Synthesia directories... Found template 'Support Starter' (ID: tmpl-1234). Fetching target blueprint variables natively... Dispatching creation with payload values successfully... Video task submitted. The ID is 'vid-5678'. Let me know when you want to check the status. ``` **Prompt:** ``` List the available AI avatars, focusing on professional corporate styles. ``` **Response:** ``` Querying Synthesia avatar registry... Here are some of the active top corporate avatars available for rendering: 1. **Anna_Business** (ID: 101) - Blazer, formal. 2. **Marcus_Exec** (ID: 105) - Suit, authoritative. 3. **Elena_Office** (ID: 112) - Smart casual, friendly. ``` **Prompt:** ``` Check the status of my recent video task 'vid-9920'. ``` **Response:** ``` Evaluating task bounds... The render for **vid-9920** is **COMPLETE**. Total duration: 45 seconds. You can download and stream the final file here: `https://synthesia.io/stream/vid-9920_xyz`. ``` ## Capabilities ### Generate avatar videos from scripts Create new synthetic media tracks using specific avatars and custom text. ### Create videos from templates Spin up finished content using pre-defined brand layouts and JSON inputs. ### Check render status Get real-time updates on whether your video is still processing or ready. ### List available avatars Browse your full library of synthetic human personas for your next project. ### Browse video templates See all available layouts to maintain visual consistency across your content. ### Retrieve video library Get a complete list of all videos currently in your account. ### Automate video dubbing Translate existing video tracks into different languages using AI voices. ### List AI voices View all available voice models to find the right tone for your audience. ### Remove videos from account Permanently delete specific video records from your Synthesia library. ### Get template details Look up specific requirements and variables for any given video template. ## Use Cases ### Mass-producing training modules A training lead asks their agent to create 10 different onboarding videos using the 'New Hire' template with unique scripts for each. ### Global internal announcements An engineer tells their agent to pick a professional avatar and generate a 'Happy Birthday' video for the team in five different languages. ### Rapid content localization A localization manager asks the agent to find all videos in a specific folder and dub them into Spanish using a native voice. ### Social media content creation A content creator uses create_avatar_video to turn a text blog post into a 60-second social media clip with a realistic human face. ## Benefits - Automate video production by using create_video_from_template to turn JSON data into finished content. - Scale global reach instantly with dub_video to translate your existing library into new languages. - Maintain brand consistency by pulling specific layouts using list_templates and get_template_details. - Save time on casting by using list_avatars and list_voices to find the perfect persona in seconds. - Manage your entire library from one place using list_videos and get_video_details to track every task. ## How It Works The bottom line is you can move from manual video production to automated, script-driven content generation. 1. Add the Synthesia MCP to your Vinkius configuration. 2. Provide your SYNTHESIA_KEY in the host settings. 3. Tell your agent to generate a video, list avatars, or dub a file. ## Frequently Asked Questions **How can I use the Synthesia MCP to create training videos?** You can use it to generate synthetic videos from scripts or templates. Your agent can pick an avatar, apply a layout, and create a finished video for you without you needing to use the web editor. **Can the Synthesia MCP help with multi-language content?** Yes, it includes a dubbing tool. You can ask your agent to take an existing video and translate it into another language using AI voices. **Do I need to be a video editor to use the Synthesia MCP?** No. This Connector is designed for programmatic creation. It's built for people who want to turn text and data into videos quickly through a chat or terminal interface. **How do I manage my videos using the Synthesia MCP?** You can ask your agent to list all your current videos, check the status of a specific render, or permanently delete old files from your account. **Can I use specific brand templates with the Synthesia MCP?** Yes. You can browse your available templates and get specific details on them. Your agent can then use those exact blueprints to create new content. **What kind of avatars are available in the Synthesia MCP?** You can list all available avatars to see the range of personas. This helps you find the right professional look for your corporate projects. **How long does video rendering take?** The `create_avatar_video` command submits the job instantly. Rendering typically takes 2–10 minutes depending on length. Use `get_video_details` to check progress and retrieve the final URL. **Can I use my custom avatars?** Yes. The `list_avatars` tool returns both stock and custom avatars tied to your account. You can use any avatar ID when creating videos. **Which Synthesia plan is required?** API access requires a Creator or Enterprise plan. Free and Starter plans do not include API keys. Check the Integrations tab in your Synthesia dashboard to verify eligibility.