VEDEO · Help
Connect an AI assistant
Last updated: November 2026
Give an AI assistant VEDEO's address and it can make videos for you from a conversation: it tells you what a video will cost, starts it when you agree, and hands you the finished file.
Connect it
Every assistant is given the same address:
https://vedeo.org/mcpAdding it opens VEDEO in your browser. You log in or create an account, see what the assistant is asking to do, untick anything you don't want, and press Allow. You never paste a password or a key into the assistant.
| Assistant | Where to add the address |
|---|---|
| Claude | Settings, then Connectors, then Add custom connector. |
| Claude Code | Run: claude mcp add --transport http vedeo https://vedeo.org/mcp |
| ChatGPT | Settings, then Apps & Connectors. Add a connector with the address and choose OAuth. |
| Codex | Add an mcp_servers.vedeo entry with url = "https://vedeo.org/mcp" to its config file, then run: codex mcp login vedeo |
| VS Code | Add a server of type "http" with this url to .vscode/mcp.json. |
These menus change from time to time. The address stays the same.
What it can do
| Action | What it does | Kind |
|---|---|---|
| Get the account | The VEDEO account you are connected to: its plan, the credits it can spend now, which visual tiers and voice options the plan includes, and how many videos it may start in an hour. | Reads |
| List recipes | The kinds of video VEDEO makes (educational explainer, product, real estate and so on). | Reads |
| List voices | Narration voices for one language (English unless you name another), and the languages available. | Reads |
| Estimate a video's cost | What a video would cost in credits. | Reads |
| Create a video | Starts rendering a video and reserves its cost from the account's credits. | Spends or returns credits |
| Get a video | A video's status (pending, queued, rendering, completed, failed or cancelled), progress and finished outputs. | Reads |
| List videos | The account's videos, newest first, 20 at a time, with each one's status. | Reads |
| Get a download link | A link to download a completed video as an MP4. | Reads |
| Cancel a video | Cancels a video that has not started rendering, and returns its credits. | Spends or returns credits |
It cannot change your plan, buy credits, see your payment details, or manage a team, API keys or webhooks.
What you allow
On the Allow page you choose which of these the assistant gets. Anything you leave unticked, it cannot do.
| Permission | What it means |
|---|---|
| See your plan and credit balance | Your plan's name, how many credits you can spend, and what your plan includes. |
| See and download your videos | The videos in your library, their progress, and links to download finished ones. |
| Start and cancel videos | Starting a video spends credits. The assistant is told to ask you before each one. |
What it costs
A video started by an assistant costs the same credits as one you start in the studio, and comes out of the same balance (your team's, if you are on a team).
- The assistant is told to check the cost and ask you before it starts a video.
- Each request states the most it may spend. A video that would cost more is refused, and nothing is charged.
- If the assistant repeats a request because of a network problem, the video is made and charged once.
- A finished video is charged whether or not you like the result. One that fails, or is cancelled before rendering begins, is not.
- An account can start 30 videos an hour in all, across the studio and its assistants.
How long a video takes
A few minutes. The assistant gets an answer straight away saying the video has started, then checks back until it is done.
| Status | Meaning |
|---|---|
| Pending or queued | Accepted, and waiting its turn |
| Rendering | Being made. This is when it can no longer be cancelled. |
| Completed | Finished and charged. The assistant can fetch a download link. |
| Failed | Not made, and not charged. The assistant is told why. |
| Cancelled | Stopped before rendering began. Its credits were returned. |
A download link works for about an hour and needs no sign-in, so share it as carefully as you would the video itself.
When it says no
The assistant is told why in a sentence it can pass on to you. The usual reasons:
- Your plan does not include what was asked for, such as AI visuals or a premium voice.
- You don't have enough credits. Credits are added in VEDEO itself, never through the assistant.
- The video would cost more than the maximum the assistant was given.
- The video has already started rendering, so it can't be cancelled.
- Too many requests in a short time. An assistant can make 120 a minute.
- Its sign-in has expired or you disconnected it. Connecting again fixes that.
Disconnect it
Open Settings in VEDEO, find the assistant under Assistants, and press Disconnect. It loses access immediately. Videos it already made stay in your library.
Privacy and help
An assistant sees only what you allowed, and never your password, email address or payment details. Our Privacy Policy has a section on connected assistants, and our Acceptable Use policy applies to videos an assistant makes just as it does to yours.
If something isn't working, write to support@vedeo.org.