Synthesia MCP for AI. Run full video production from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
How this MCP server connects to your AI agent
Synthesia connects your AI video account to any agent, letting you programmatically generate high-quality avatar videos. You can create content by giving a script or filling pre-defined templates.
It also lets you manage production status, list avatars, and set up webhooks for real-time updates. No cameras, no studios needed.
What AI agents can do with Synthesia Automation
Create video from template
Builds and generates a video by filling in variables from an existing Synthesia template.
Create video
Generates a brand new AI avatar video based on a provided script.
Create webhook
Sets up a new notification endpoint to alert you when videos are completed or fail.
The server takes a script and avatar choice, then creates a new AI-driven video.
You can generate videos quickly by feeding custom data into pre-existing template structures.
List available avatars or existing video templates so your agent knows what resources it has access to.
Check the processing status of a video job, or list all videos you've previously generated.
Create webhooks that notify your system when a video finishes rendering or fails.
Ask an AI about this
Waiting for input…
What AI agents can do with Synthesia MCP Server: 10 Tools for Video Ops
Use these tools to manage the entire video asset lifecycle—from listing available avatars and templates to generating new content and monitoring final status.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Synthesia on VinkiusCreate Video From Template
Builds and generates a video by filling in variables from an existing Synthesia template.
Create Video
Generates a brand new AI avatar video based on a provided script.
Create Webhook
Sets up a new notification endpoint to alert you when videos are completed or fail.
Delete Video
Permanently removes a specific video asset from your account history.
Delete Webhook
Removes an existing notification webhook endpoint.
Get Video Details
Retrieves the current status and specific metadata for a video by its ID.
List Avatars
Returns a list of all available stock avatars, including their descriptive metadata.
List Templates
Retrieves the names and details of your pre-designed video templates.
List Videos
Lists all previously generated videos in your production library, providing a...
List Webhooks
Displays the list of currently configured notification webhooks.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Synthesia integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Synthesia, then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Synthesia. 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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Built on the Model Context Protocol (MCP) for Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Video production shouldn't require 15 clicks and three different logins., Solved with Vinkius AI Gateway
Right now, generating a batch of videos means logging into Synthesia. You have to manually select templates, copy the variables for each client into separate fields, hit 'generate,' wait on the status page, then switch tabs to check if they're done. It’s tedious, and errors are guaranteed.
With this MCP Server, you give your agent a command: 'Create 50 videos using template XYZ.' The server handles the looping, the variable injection via `create_video_from_template`, and tracks everything for you. You get confirmation, not clicks.
Synthesia MCP Server: Full control over video operations.
Manual cleanup means remembering which IDs to delete after a test run or failing to remove old webhooks, leading to clutter and wasted billing cycles. You have to jump back into the dashboard just to manage endpoints.
Now you use `delete_video` or `delete_webhook` directly in chat. The entire asset lifecycle—creation, status check, cleanup—is managed conversationally. It's all one flow.
What your AI can actually do with this
This server connects your AI video account to your agent, letting you generate professional avatar videos without ever touching a user interface. You tell your agent exactly what you want, and it handles the heavy lifting.
Generating Video Content
When you need a brand-new video, use create_video. Just give the script and choose an avatar, and your agent generates the full AI-driven video for you. If you've got pre-designed materials, you can build videos using create_video_from_template, feeding custom data into existing Synthesia templates to spit out content fast. You'll never start from a blank page again.
Managing Assets and Resources
Your agent needs to know what it’s working with. To see every available face, call list_avatars; this returns a comprehensive list of stock avatars along with all their descriptive metadata. Need to build something new? Run list_templates to pull up the names and details of your pre-made video templates, so your agent knows what structures it can fill.
You can check out your entire production history by running list_videos, which gives you a clean rundown of every single video asset you've ever made.
Tracking and Maintenance
Monitoring is key. To see the current processing status or specific metadata for any job, use get_video_details with a video ID. You can also keep track of your library by calling list_videos. If you need to wipe an old asset from your account history, just run delete_video and provide the specific video ID; that permanently removes it.
For notification management, start by seeing what's running with list_webhooks, which displays all currently configured notification endpoints. When you set up a new alert system, use create_webhook; this sets up an endpoint to notify your system immediately when videos finish rendering or if something goes wrong. If that webhook is stale, run delete_webhook and specify the existing endpoint for removal.
Workflow Example Flow
You can structure complex workflows like this: First, tell your agent which avatars it has access to using list_avatars. Next, check what templates are available via list_templates. Then, you instruct it to create a video by calling create_video with the script and avatar. While that's rendering, you set up fail-safes by calling create_webhook, telling your system where to look for status updates.
Once the process is complete, you can call get_video_details to confirm the final link or use list_videos to log it into your main archive.
019dd16d-17fa-73bb-b24a-7a12c9e892a8 
Here's how it actually works
The bottom line is, your AI client becomes an operational layer between you and Synthesia's backend, letting you manage complex video jobs with natural language.
First, subscribe to this server and pass your Synthesia API Key. This links the agent to your account.
Next, tell your agent exactly what you want—like 'Generate a video using template XYZ with script ABC' or 'List all available avatars.'
The agent calls the appropriate tool (e.g., create_video_from_template), and then it gives you the status or the resulting video link.
Who is this actually for?
Content creators who spend too much time manually uploading assets or refreshing status dashboards. Marketing teams that need to rapidly generate personalized training videos for different regions. L&D specialists tired of recreating instructional content from scratch.
Needs to run A/B tests on video scripts and avatars, listing available avatars via list_avatars and quickly generating test videos with create_video.
Uses existing instructional guides as templates, passing variables into a pre-defined template using create_video_from_template to localize training material.
Monitors large batches of video assets. They use get_video_details and list_videos to track status without logging into the main dashboard.
What Changes When You Connect
Stop manually checking status. Use get_video_details or list_videos to query the real-time status of any job, getting links and metadata right back in your chat window.
Generate personalized content at scale. Instead of rebuilding a video, feed dynamic data into an existing structure using create_video_from_template, saving massive amounts of setup time.
Build automated workflows with webhooks. Use create_webhook to ensure that the moment a video finishes rendering, your system gets notified and can trigger the next step.
Select avatars without leaving chat. list_avatars gives you access to dozens of personas and their full metadata so your agent picks the perfect fit every time.
Manage templates programmatically. Use list_templates to see exactly what kind of videos you're capable of making, allowing your agent to guide you on best practices.
See it in action
Client Onboarding Video Audit
A marketer needs 50 versions of a welcome video for new clients. Instead of manually setting up each one, they use list_templates to confirm the base template ID, then loop through client data and call create_video_from_template repeatedly. Finally, they query all resulting IDs using list_videos to ensure everything rendered correctly.
Real-Time Production Monitoring
An ops engineer triggers a large batch of 100 videos via the agent. Instead of waiting hours, they continuously call get_video_details on specific IDs to monitor progress and confirm when all assets are ready for download.
Automating L&D Updates
The L&D team updates a compliance module. They use the agent to check available avatars via list_avatars to ensure they have the right corporate persona, then trigger an update using create_video with the new script.
System Integration Cleanup
After a campaign runs, the engineer needs to clear old assets. They use list_videos to get IDs of outdated content and then call delete_video for each one, keeping their library clean.
The honest tradeoffs
Trying to generate a video without knowing the template ID.
The user just writes 'Make me a training video about Q3.' The agent fails because it doesn't know which specific, structured format (template) they want. It gives generic results or errors.
First, call list_templates to see the available IDs and structures. Then, use those details in create_video_from_template. Always start with the template list.
Assuming all avatars can be used for every niche.
The user asks the agent to pick an avatar without specifying a mood or industry. The resulting video looks generic, and the tone is wrong for the target audience.
Run list_avatars first. Check the metadata (e.g., 'Business Professional,' 'Casual') and specify that constraint in your prompt so the agent picks the right persona.
Ignoring webhook failures for critical workflows.
The user relies on a video finishing, but doesn't set up a notification endpoint. The system just hangs, and they don't know if it failed or is still processing after hours.
Always use create_webhook when building automated pipelines. This ensures your agent gets an instant alert for success (completed) or failure (video.failed).
When It Fits, When It Doesn't
Use this server if your core problem is moving video production from a manual, GUI-based workflow into a conversational, API-driven chat session. You need to programmatically list assets (list_avatars, list_videos), or run repetitive jobs based on known structures (create_video_from_template). Don't use it if you just want to watch one video and download it—you still need the Synthesia UI for that. If your workflow requires advanced data validation before creation, check if a schema-specific server (like Pydantic AI) is better suited. Otherwise, this MCP Server handles the asset management lifecycle.
Questions you might have
How do I list my past videos using the list_videos tool? +
Call list_videos and your agent returns a full history of your generated content, including names and IDs. You can then ask for status updates on specific assets.
Can I create a video with the create_video tool if I don't have an avatar selected? +
No. The create_video tool requires both a script and a valid, selected avatar ID to function correctly. You should run list_avatars first to get options.
What is the purpose of create_webhook? +
The create_webhook tool sets up automated notifications. This means when a video finishes, your external system gets an alert—you don't have to constantly check the status manually.
Should I use create_video or create_video_from_template? +
Use create_video_from_template if you are reusing a known structure (e.g., 'annual report'). Use create_video when starting totally fresh with just a script and avatar.
What should I do if `get_video_details` returns an error about my API key? +
First, check your Synthesia account settings to confirm the API Key. If the credentials are correct, try refreshing the server connection on Vinkius. The agent can't fetch details without a valid access token.
How does `get_video_details` help me troubleshoot a failed video job? +
The response from get_video_details includes more than just the status. It provides specific failure reason codes and detailed error messages, letting you know if the script or template was the problem.
Is using `delete_video` permanent? Should I be careful? +
Yes, it is. The delete_video tool permanently removes the video asset from your account. This action cannot be undone by the agent or through any subsequent command.
After running `list_templates`, how do I know what variables are available? +
list_templates gives you the template ID and a description of its required inputs. This output shows exactly which dynamic variables (like names or dates) you need to include in your script.
Can I see all available AI avatars via AI? +
Yes! Use the list_avatars tool. Your agent will retrieve the complete directory of stock avatars available in Synthesia for your videos.
How do I check the status of a video being processed? +
Run the get_video_details query with your Video ID. The agent will retrieve the real-time status (e.g., in_progress, completed) and the final download link if ready.
Is it possible to generate a video using a custom template? +
Absolutely. Use the create_video_from_template tool. Provide the Template ID and a JSON object with the data for your dynamic variables to trigger the generation.
We've already built the connector for Synthesia. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.