Synthesys MCP Server. Make Videos From Claude, ChatGPT and Cursor.
Connect Synthesys to the AI assistant you already work in and ask for a video in chat. The same agent that runs in our app writes the script, plans the scenes, adds voiceover, captions and music, and hands back the finished file. Every full production comes with a price before anything is built.
https://mcp.synthesys.io/mcpThen sign in with your Synthesys account when your assistant asks. Nothing to download, no API key to paste.
Already a customer? Sign in with the account you have. MCP uses the same login and credits.
- Nothing to install
- Sign in with your Synthesys account
- Same credits as the app
- A quote before every full video
list_templatescreate_video · planning
get_video_statusRendering scene 3 of 5- Claude
- ChatGPT
- Cursor
- Claude Code
- Codex
- VS Code
- Any MCP client
What is the Synthesys MCP server?
MCP, short for Model Context Protocol, is the open standard AI assistants use to call outside tools. The Synthesys MCP server plugs the Synthesys Video Agent into that standard. Once it's connected, Claude, ChatGPT, Cursor or your own agent can plan a video, get a price and build it, all from a normal chat. It can also pick an actor or a voice, use your Brand Kit and your own files, and make single clips and images.
It runs on your Synthesys account. There is no second subscription, and nothing lives outside the app: every video your assistant makes shows up as a regular project you can open, edit and download.
Connect once. Then ask for videos in plain words.
- 01
Connect once
Add the Synthesys URL to Claude, ChatGPT, Cursor or any MCP client and sign in with your Synthesys account. No download, no API key to paste. The steps for each app are below.
- 02
Ask in plain words
Describe the video the way you'd brief a producer: product, audience, length, format. Add product shots or your own footage from a link, from your device or from your Synthesys library.
- 03
Approve the quote
Synthesys writes the script, plans every scene and tells you the price. Say yes and it renders. Your assistant hands you the finished video.
Connect your assistant in three steps.
Every app uses the same URL and the same Synthesys sign-in. Find yours below.
Claude
Web and desktop- 1Copy the Synthesys MCP URL.MCP URL
https://mcp.synthesys.io/mcp
- 2On claude.ai or in Claude Desktop, open
Customize → Connectors, click+, thenAdd custom connector. Name it Synthesys, paste the URL and click Continue. - 3Sign in with your Synthesys account. In a chat, turn Synthesys on from
+ → Connectors.
Every plan can add it. Free allows one custom connector. On Team and Enterprise, an Owner adds Synthesys first in
Claude help pageOrganization settings → Connectors, then each member clicks Connect.- 1
ChatGPT
Web, developer mode- 1On chatgpt.com, open
Settings → Apps → Advancedand turn on Developer mode. Some accounts show Plugins instead of Apps. - 2Create a custom MCP app named Synthesys with the URL below. If it asks how to sign in, choose OAuth.MCP URL
https://mcp.synthesys.io/mcp
- 3Sign in with your Synthesys account, then add Synthesys to a new chat. ChatGPT asks you to confirm actions before they run.
Needs a ChatGPT plan that supports custom MCP apps in developer mode. Full use, which making videos needs, is in beta for Business, Enterprise and Edu, where a workspace admin or owner turns it on and publishes the app. Not available in the ChatGPT mobile apps.
ChatGPT help page- 1
Cursor
- 1Add Synthesys to
~/.cursor/mcp.jsonfor every project, or to.cursor/mcp.jsonin one project:mcp.json{ "mcpServers": { "synthesys": { "url": "https://mcp.synthesys.io/mcp" } } } - 2When Cursor prompts you, sign in with your Synthesys account.
- 3Ask for a video in Agent mode.
- 1
Claude Code
- 1Add the server from your terminal. Add
--scope userto use it in every project.Terminalclaude mcp add --transport http synthesys https://mcp.synthesys.io/mcp
- 2In a Claude Code session, run
/mcp, choosesynthesysand sign in with your Synthesys account in the browser. - 3Ask for a video.
- 1
Codex
- 1Add the server from your terminal:Terminal
codex mcp add synthesys --url https://mcp.synthesys.io/mcp
- 2Sign in. This opens the Synthesys sign-in page in your browser.Terminal
codex mcp login synthesys
- 3Ask for a video. The Codex IDE extension reads the same settings, so you only add Synthesys once.
- 1
VS Code
GitHub Copilot- 1Open the Command Palette and run
MCP: Add Server. - 2Choose HTTP and paste the URL.MCP URL
https://mcp.synthesys.io/mcp
- 3Sign in with your Synthesys account when VS Code asks.
On Copilot Business or Enterprise, your organization has to turn on the “MCP servers in Copilot” policy first.
VS Code help page- 1
Other MCP clients
- 1Add
https://mcp.synthesys.io/mcpas a remote MCP server (Streamable HTTP) namedsynthesysin your app's MCP settings. - 2Sign in with your Synthesys account when the sign-in page opens.
- 3Agents that can install servers themselves can do it for you. Give them this prompt:Prompt
Help me install this MCP server and give me the sign-in link to authorize it with my Synthesys account: https://mcp.synthesys.io/mcp
Apps that only run local MCP servers can't connect.
- 1
Synthesys works with any app that supports remote MCP servers with sign-in. Each app sets its own plan rules and menus, and they change often. If your screens look different, check that app's help page, or follow the setup guide in the Synthesys app.
Anything you'd make in the app.
Ads, UGC, commercials, explainers and faceless stories, plus recreating an ad that already works. Here are a few messages to try first.
- UGC ad
“Make a 20 second UGC style ad for my skincare serum. A creator talks to camera like a friend, hook in the first two seconds, 9:16. Show me a few actors to pick from, and the quote before building anything.”
- Commercial
“Make a 20 second cinematic commercial for my sneaker drop with slow motion hero shots, 16:9. Use my Brand Kit for the end card. Quote me first.”
- Recreate an ad
“Recreate this winning ad for my sparkling water brand: <ad link>. Walk me through its hook and beats, then show me the quote before rendering.”
- Product image
“Make a square product photo of my soy candle on a marble bathroom shelf in soft morning light. Tell me the exact price before you generate it.”
- Short clip
“Generate a 10 second macro clip of my fountain pen writing in glowing ink, 9:16. Tell me the rough cost before you start.”
- App promo
“Make a 30 second promo for my fitness app. Someone using it on a morning walk, calm voiceover, 16:9. Show me the plan and the quote first.”
Fifteen tools, with honest timings.
Video isn't instant, so every tool tells your assistant how long to expect and when to check back. The free tools answer in seconds.
Make videos
Full productions from a brief, or from an ad that already works.
create_videoPaidMake a full video
Script, scenes, voiceover, presenters, captions, music and the edit, from one brief. The first call only plans the video and returns a quote. Nothing is spent until you say yes.
quote 30 to 90 s · build usually 10 to 25 minrecreate_from_urlPaidRecreate an ad
Give it a link to an ad that works, or to your product page. It maps the hook, pacing and call to action, then plans your version and quotes it before anything renders.
analysis 1 to 3 min · 10 creditsget_video_statusFreeCheck progress
Progress, the quote, any open question, and the finished video link once it's done.
instant · checked every 30 to 60 sanswer_questionFreeAnswer a question
When a build needs your decision, your assistant asks you and passes the answer back. The build carries on from where it paused.
instant
Clips and images
Single shots and stills. Pick a model, or use the default.
generate_clipPaidMake a short clip
One clip of 4 to 15 seconds from a prompt: a product shot, b-roll or a one scene ad. On the default cinematic setting it starts right away and costs roughly 40 to 50 credits a second. Pick a model and you get its exact price before it starts.
8 to 13 mingenerate_imagePaidMake an image
Create an image from a prompt, or edit one of yours, with the model you pick. You see the exact price first, and the image lands in your library ready to use in a video.
seconds to 2 minlist_modelsFreeCompare models
The image and video models you can choose from, what each one does and its exact price.
about 2 s
Your material
Your product shots, your people, your voice and your brand.
upload_referenceFreeUse a file from a link
Bring in a product shot, logo or your own footage from a public link, so the video shows the real thing.
a few secondscreate_upload_linkFreeUpload from your device
Files attached in a chat don't reach connected tools, so your assistant gives you a short-lived upload page instead. It takes up to 10 images or videos within 30 minutes.
about 2 slist_filesFreeBrowse your library
The images and videos already in your Synthesys library, newest first, ready to use in a build.
about 2 slist_actorsFreePick who's on camera
Your own digital twins first, then the stock actors, each with a preview. Or leave it out and Synthesys casts the presenter.
a few secondslist_voicesFreePick a voice
Your own voices first, then the voice library, each with an audio sample. Or let Synthesys choose.
about 2 slist_brand_kitsFreeUse your Brand Kit
Pass a Brand Kit to a new video and it uses your logo end card, colours, fonts, tagline and call to action. Brand Kit comes with Pro and up.
about 2 s
Account
What you can make and what it costs.
get_creditsFreeCheck credits
Your balance, what's left of today's limit, the price list and recent usage. The same wallet as the app.
about 2 slist_templatesFreeBrowse templates
Every video format and visual style, with lengths and aspect ratios. Your assistant reads this first.
about 2 s
Inputs, outputs and errors for every tool are in the Synthesys MCP reference.
Full videos are quoted first. Nothing is charged until you say yes.
Letting an agent spend your credits should feel safe. So it works like a good producer would: plan, price, then build.
Quoted first
A full video can't be bought in one step. Planning is free, and nothing is charged until you say yes to the quote. Images, and clips from a model you pick, show their exact price first too.
A daily limit
Connected apps and API keys have a daily limit of 5,000 credits ($50). Once it's reached, they can't start anything else that costs credits until 00:00 UTC.
One wallet
Same credits and prices as the web app, where 100 credits equal $1. There is no separate plan for MCP.
Everything in your account
Every video and clip made from chat is saved to your Synthesys account, and every image goes to your library. Open, edit, download or reuse any of it in the app.
What your assistant sees.
Here is what a connected assistant can see, and what stays with Synthesys.
Only what you ask for
Your assistant gets what you ask it to fetch or create: your credit balance and usage, project details and scripts, the names of your actors, voices and Brand Kits, and links to your files and finished videos.
Their privacy policy applies
Whatever your assistant receives goes to the company that runs it, and their privacy policy covers it from there.
Never your face
Your digital twins are listed by name only. No picture or clip of your face is ever sent to the assistant.
Links open for anyone who has them
Links to your files and videos currently work for anyone who has the link. If your files are confidential, avoid sharing those conversations.
No passwords, keys stored as a hash
You sign in through our sign-in provider, so Synthesys gets an access token and never your password. API keys are stored only as a hash and shown to you once.
Every action is logged
We record each action taken through an assistant or an API key: which tool, when, the result and the account.
Disconnect at any time.
Remove the connector in the app you added it to, and revoke any API keys you made.
Remove Synthesys from an app
- Claude
Customize → Connectors, open the…menu next to Synthesys, then Remove.- ChatGPT
Settings → Apps(or Plugins), open Synthesys, then Disconnect.- Cursor
- Remove Synthesys or turn it off in Cursor's MCP settings.
- Claude Code
claude mcp remove synthesys- Codex
codex mcp remove synthesys- Other apps
- Remove Synthesys in that app's MCP or connector settings.
Revoke an API key
In Synthesys, open Manage Account → API keys and click Revoke next to the key. It stops working within a minute, and you can create a new one whenever you need it.
For n8n, scripts and CI.
Tools that can't open a sign-in window connect to the same URL with an API key instead.
The MCP reference covers what you need to build on it: API keys, the quote and confirm flow, every tool's inputs and outputs, the limits, the errors and a curl example to start from.
# any MCP client that can't open a sign-in window
Server URL: https://mcp.synthesys.io/mcp
Transport: Streamable HTTP
Header: Authorization: Bearer cue_sk_…If something isn't working.
Sign-in fails, or no Synthesys tools appear
Check that your app allows custom MCP servers on your plan. Claude Free allows one custom connector, and on Claude Team and Enterprise an Owner adds Synthesys first. ChatGPT needs developer mode on a supported plan, on the web. Then turn the connector on in your chat. In Claude Code, run
/mcpto sign in.Daily limit for connected apps reached
Connected apps and API keys can spend up to 5,000 credits a day, and the limit resets at 00:00 UTC. The Synthesys web app is never blocked, so you can finish there or wait for the reset.
Out of credits
Your assistant tells you when your balance won't cover the next step, before anything is charged. Add credits in the Synthesys app with a plan or a credit pack, then ask it to confirm again.
A video is taking a while
Clips usually take 8 to 13 minutes and full productions usually 10 to 25. Ask your assistant to check the status. Every video also shows up in Projects in the Synthesys app.
The upload link expired
Upload links work for 30 minutes and take up to 10 files. Ask your assistant for a new one. The upload page shows which Synthesys account the files go to.
Still stuck?
Search the Synthesys help center or email support@synthesys.io. Tell us which app you use and what your assistant said.
Have questions? We have answers.
Last updated:
Find everything you need to know about getting started, managing your account, and creating professional AI videos.
What is the Synthesys MCP server?
It's the connector that lets Claude, ChatGPT, Cursor, Claude Code, Codex, VS Code or your own agent make videos with Synthesys from a chat. MCP (Model Context Protocol) is the open standard AI assistants use to call outside tools. The server gives them fifteen tools: plan, price and build full videos, recreate an ad from a link, make short clips and images, bring in your own files, pick actors, voices and a Brand Kit, and check your credits. It runs on your Synthesys account, with the same projects and credits as the web app.
How do I connect it?
Add https://mcp.synthesys.io/mcp to your assistant as a custom connector or remote MCP server, then sign in with your Synthesys account. In Claude, open Customize, then Connectors, click +, and choose Add custom connector. In Claude Code, run claude mcp add --transport http synthesys https://mcp.synthesys.io/mcp. This page has the steps for each app, including ChatGPT, Cursor, Codex and VS Code.
Which Claude and ChatGPT plans work?
Every Claude plan can add Synthesys as a custom connector, on claude.ai or in Claude Desktop. The Free plan allows one custom connector. On Team and Enterprise, an Owner adds Synthesys first in Organization settings, Connectors, and then each member clicks Connect. In ChatGPT you need developer mode on a plan that supports custom MCP apps, on the web only. Full use, which making videos needs, is in beta for Business, Enterprise and Edu workspaces, where an admin or owner turns developer mode on. Plans and menus change often, so if yours looks different, check that app's help page.
Do I need to install anything?
No. There is nothing to download or run on your computer. You add one Synthesys MCP URL to your assistant, sign in with your Synthesys account, and the tools show up in your chats.
Do I need an API key?
No, not for Claude, ChatGPT, Cursor, Claude Code, Codex or VS Code. You sign in with your Synthesys account and the tools act as you. API keys are only for automations that can't open a sign-in window, like n8n, scripts or CI. Create one in Synthesys under Manage Account, API keys, and send it to the same URL in an Authorization: Bearer header. Each key is shown once, and you can revoke it at any time. The MCP reference has a full example.
How much does it cost?
The same as making the video in the app, from the same credit balance, where 100 credits equal $1. There is no separate MCP plan. Planning a video and getting the quote are free, and so are voiceover and music. A short clip on the default cinematic setting costs roughly 40 to 50 credits a second, and recreating an ad costs 10 credits for the analysis before the video is quoted. Your assistant can check your balance and the price list at any time, for free.
Is it safe to let an AI assistant spend my credits?
Yes. Full videos are always quoted first, and there is a daily limit on top. A full video can't be paid for in one step: your assistant gets a quote, and nothing is charged until you confirm it. Images, and clips from a model you pick, show their exact price first too. A short clip on the default setting starts straight away and states its approximate cost, and recreating an ad costs 10 credits for the analysis. Connected apps and API keys have a daily limit of 5,000 credits ($50). Everything your account spends that day counts toward it, including spending in the web app, which is never blocked. The limit resets at 00:00 UTC.
Can it recreate an ad from a link?
Yes. Give your assistant a public link to an ad: a video file, an ad page, or a TikTok, Meta or YouTube link. Synthesys analyses its hook, beats, pacing and call to action for 10 credits, charged only if the analysis succeeds. It then plans your version and quotes the production, and nothing renders until you approve that quote. It can also turn a product or landing page into an ad the same way. Recreated ads follow the original's length, up to 60 seconds.
What happens if I run out of credits?
The build pauses before the next paid step, and your assistant tells you the balance won't cover it. Add credits in Synthesys with a plan or a credit pack, then confirm again to carry on.
How long does a video take?
A single clip usually takes 8 to 13 minutes. A full production usually takes 10 to 25 minutes, because every scene is planned, rendered and edited, and longer videos take the most time. Checking templates or credits takes about 2 seconds, a quote 30 to 90 seconds, and an image from a few seconds to about 2 minutes. Your assistant checks on progress by itself, and checking is free, so you can carry on with other work.
Can I use my own footage, product shots or logo?
Yes, in three free ways. Files you attach in a chat don't reach connected tools, so your assistant can bring in a file from a public link, give you a short-lived page to upload from your device, or use what's already in your Synthesys library. Say what each file is in your brief, for example that a photo shows the product and its label must stay exact.
Where do the videos go?
Into your Synthesys account. Every video and clip made from chat shows up in the app next to everything you made there directly, and images go to your library. Open, edit, download or reuse any of it.
What does my AI assistant see from my Synthesys account?
Only what you ask it to fetch or create: your credit balance, project details and scripts, the names of your actors, voices and Brand Kits, and links to your files and finished videos. That goes to the company that runs your assistant, under their privacy policy. Digital twins are listed by name only, so no image of your face is sent. Links to files and videos currently work for anyone who has the link, so avoid sharing those conversations if your files are confidential. You sign in through our sign-in provider, so Synthesys never sees your password, and API keys are stored only as a hash. We log each action taken through an assistant or an API key: the tool, the time, the result and the account.
How do I disconnect?
Remove Synthesys in the app you added it to. In Claude, open Customize, then Connectors, open the menu next to Synthesys and choose Remove. In ChatGPT, open Settings, then Apps or Plugins, choose Synthesys and click Disconnect. In Cursor, remove it or turn it off in the MCP settings. In Claude Code, run claude mcp remove synthesys, and in Codex, codex mcp remove synthesys. To stop an API key, open Manage Account, API keys in Synthesys and click Revoke. The key stops working within a minute.
Which apps does it work with?
Claude on the web and desktop, ChatGPT in developer mode on the web, Cursor, Claude Code, Codex and VS Code with GitHub Copilot. Any other app that supports remote MCP servers (Streamable HTTP) with sign-in can use it too. Apps that only run local MCP servers can't connect.
Make Your First Video From Chat.
MCP runs on the Synthesys account and credits you already have. Create an account, add the URL to Claude, ChatGPT or Cursor, and send your first brief.
Create Your AccountRead the setup guide in the app