Skip to main content
Synthesys MCPLive

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.

Add this URL to your assistant
https://mcp.synthesys.io/mcp

Then 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
Your AI assistantSynthesys connected
Make a 20 second cinematic ad for our sneaker drop. Slow motion hero shots, 16:9. Quote me first.
  • list_templates
  • create_video · planning
The plan is ready: 5 scenes, 20 seconds, 16:9, with voiceover and music. The quote is 820 credits ($8.20). Nothing has been spent yet. Shall I build it?
Yes, go.
get_video_statusRendering scene 3 of 5
Example conversation. Your quote depends on your brief, length and format.
Works with
  • Claude
  • ChatGPT
  • Cursor
  • Claude Code
  • Codex
  • VS Code
  • Any MCP client
What it is

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.

How it works

Connect once. Then ask for videos in plain words.

  1. 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.

  2. 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.

  3. 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.

Set it up

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
    1. 1
      Copy the Synthesys MCP URL.
      MCP URL
      https://mcp.synthesys.io/mcp
    2. 2
      On claude.ai or in Claude Desktop, open Customize → Connectors, click +, then Add custom connector. Name it Synthesys, paste the URL and click Continue.
    3. 3
      Sign 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 Organization settings → Connectors, then each member clicks Connect.

    Claude help page
  • ChatGPT

    Web, developer mode
    1. 1
      On chatgpt.com, open Settings → Apps → Advanced and turn on Developer mode. Some accounts show Plugins instead of Apps.
    2. 2
      Create 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
    3. 3
      Sign 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
  • Cursor

    1. 1
      Add Synthesys to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:
      mcp.json
      {
        "mcpServers": {
          "synthesys": {
            "url": "https://mcp.synthesys.io/mcp"
          }
        }
      }
    2. 2
      When Cursor prompts you, sign in with your Synthesys account.
    3. 3
      Ask for a video in Agent mode.
  • Claude Code

    1. 1
      Add the server from your terminal. Add --scope user to use it in every project.
      Terminal
      claude mcp add --transport http synthesys https://mcp.synthesys.io/mcp
    2. 2
      In a Claude Code session, run /mcp, choose synthesys and sign in with your Synthesys account in the browser.
    3. 3
      Ask for a video.
  • Codex

    1. 1
      Add the server from your terminal:
      Terminal
      codex mcp add synthesys --url https://mcp.synthesys.io/mcp
    2. 2
      Sign in. This opens the Synthesys sign-in page in your browser.
      Terminal
      codex mcp login synthesys
    3. 3
      Ask for a video. The Codex IDE extension reads the same settings, so you only add Synthesys once.
  • VS Code

    GitHub Copilot
    1. 1
      Open the Command Palette and run MCP: Add Server.
    2. 2
      Choose HTTP and paste the URL.
      MCP URL
      https://mcp.synthesys.io/mcp
    3. 3
      Sign 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
  • Other MCP clients

    1. 1
      Add https://mcp.synthesys.io/mcp as a remote MCP server (Streamable HTTP) named synthesys in your app's MCP settings.
    2. 2
      Sign in with your Synthesys account when the sign-in page opens.
    3. 3
      Agents 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.

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.

What you can ask for

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.”

The tools

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_videoPaid

    Make 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 min
  • recreate_from_urlPaid

    Recreate 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 credits
  • get_video_statusFree

    Check progress

    Progress, the quote, any open question, and the finished video link once it's done.

    instant · checked every 30 to 60 s
  • answer_questionFree

    Answer 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_clipPaid

    Make 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 min
  • generate_imagePaid

    Make 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 min
  • list_modelsFree

    Compare 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_referenceFree

    Use 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 seconds
  • create_upload_linkFree

    Upload 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 s
  • list_filesFree

    Browse your library

    The images and videos already in your Synthesys library, newest first, ready to use in a build.

    about 2 s
  • list_actorsFree

    Pick 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 seconds
  • list_voicesFree

    Pick a voice

    Your own voices first, then the voice library, each with an audio sample. Or let Synthesys choose.

    about 2 s
  • list_brand_kitsFree

    Use 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_creditsFree

    Check credits

    Your balance, what's left of today's limit, the price list and recent usage. The same wallet as the app.

    about 2 s
  • list_templatesFree

    Browse 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.

Spending safely

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.

Privacy

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.

Automations

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.

Read the MCP Reference
Connection settings
# 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_…
Troubleshooting

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 /mcp to 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