# MakeAIVideo MCP Server: AI video generation for ChatGPT, Claude, Cursor and any AI agent

[![npm](https://img.shields.io/npm/v/@makeaivideo/mcp.svg)](https://www.npmjs.com/package/@makeaivideo/mcp) [![license](https://img.shields.io/npm/l/@makeaivideo/mcp.svg)](LICENSE) [![MCP Registry](https://img.shields.io/badge/MCP_Registry-ai.makeaivideo%2Fvideo--generator-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=ai.makeaivideo)

[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=makeaivideo&config=eyJ1cmwiOiJodHRwczovL21jcC5tYWtlYWl2aWRlby5haSJ9) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MakeAIVideo-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=makeaivideo&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.makeaivideo.ai%22%7D)

**The MakeAIVideo MCP server lets ChatGPT, Claude, Cursor and any AI agent create short-form AI videos (script, AI voiceover, AI or stock scenes, captions and music) from a prompt or a script, return the finished MP4, and post or schedule it to TikTok, Instagram Reels, YouTube Shorts and other connected social accounts.**

It is the official [Model Context Protocol](https://modelcontextprotocol.io) server for [MakeAIVideo](https://makeaivideo.ai), an AI video generator for short-form video.

| | |
| --- | --- |
| Hosted server | `https://mcp.makeaivideo.ai` (Streamable HTTP, OAuth sign-in, no key to copy) |
| Local server | `npx -y @makeaivideo/mcp` (stdio, needs `MAKEAIVIDEO_API_KEY`) |
| Tools | 44: create, plan, edit, deliver and post videos |
| Works with | ChatGPT, Claude, Claude Code, Cursor, VS Code, Codex, Gemini CLI, Windsurf, Grok, Perplexity, Le Chat, Zed, Cline and any MCP client |
| Output | MP4 in 9:16, 1:1 or 16:9, with captions, in 24 languages |
| Account | A MakeAIVideo account with credits ([pricing](https://makeaivideo.ai/pricing)) |
| Registry name | `ai.makeaivideo/video-generator` |

## What you can make

Ask your assistant for a video in plain words and it picks the right tool:

- **TikTok, Instagram Reels and YouTube Shorts videos** from one prompt: the script, voiceover, scenes, captions and music are made for you ([TikTok video generator](https://makeaivideo.ai/tiktok-video-generator), [Instagram Reels generator](https://makeaivideo.ai/instagram-reels-generator), [AI YouTube Shorts generator](https://makeaivideo.ai/ai-shorts-generator)).
- **Videos from your own script**, narrated as written ([script to video](https://makeaivideo.ai/script-to-video)), or from a blog post or article URL ([blog to video](https://makeaivideo.ai/blog-to-video)).
- **Explainers, list videos and story videos** for faceless channels ([AI explainer video](https://makeaivideo.ai/ai-explainer-video), [faceless YouTube channel](https://makeaivideo.ai/faceless-youtube-channel)).
- **Talking avatar and presenter videos**: a lip-synced presenter reads your message straight to camera ([talking avatar](https://makeaivideo.ai/talking-avatar), [AI spokesperson video](https://makeaivideo.ai/ai-spokesperson-video)).
- **Product demos, UGC-style ads and video ads** for Meta and TikTok ([AI UGC video](https://makeaivideo.ai/ai-ugc-video), [AI ad maker](https://makeaivideo.ai/ai-ad-maker)).
- **Captions and music**: captions on every video, captions as SRT or VTT files, AI background music made from a prompt, and your own choice of voice.
- **Posting and scheduling** to TikTok, Instagram, YouTube, Facebook Pages, LinkedIn, X, Threads, Pinterest, Bluesky, Telegram and Discord ([auto-post](https://makeaivideo.ai/auto-post)).

[Image to video](https://makeaivideo.ai/image-to-video) and [character swap](https://makeaivideo.ai/character-swap) need a file upload, so they run in the [web app](https://app.makeaivideo.ai) and the [REST API](https://makeaivideo.ai/docs/api/videos/create-image-to-video), not through MCP tools. See more on the [examples page](https://makeaivideo.ai/examples).

## Example prompts

- "Make a 30-second vertical explainer video about why octopuses have three hearts and give me the MP4."
- "Give me 10 video ideas for a personal finance TikTok channel, then make the best one."
- "Write a script for a UGC-style ad for my skincare serum. Show me the script before you make the video."
- "Turn the blog post at this link into a 60-second YouTube Short." (then paste the URL)
- "Make a 20-second spokesperson video announcing our new opening hours, with a calm British voice."
- "How many credits would a 45-second list video cost?"
- "When the video is ready, post it to my TikTok and YouTube tomorrow at 9am with a short caption."

## Quick start

The hosted server is the easiest way in. Add `https://mcp.makeaivideo.ai`, sign in to MakeAIVideo in the browser window that opens, and press **Approve**. You do not paste a key. The steps for every app, with copy buttons, are on the [AI Assistants page](https://app.makeaivideo.ai/ai-assistants) in the app.

After you connect, try: *"How many MakeAIVideo credits do I have? Then give me three video ideas for my channel."*

### Claude (claude.ai and Claude Desktop)

1. In Claude, open **Customize → Connectors**, press **+**, then **Add custom connector**.
2. Name it MakeAIVideo and paste `https://mcp.makeaivideo.ai`.
3. Press **Add**, then **Connect**. Sign in to MakeAIVideo and press **Approve**.

It then works in the Claude phone apps too. On Team and Enterprise plans an Owner adds connectors first, in Organization settings.

### ChatGPT

1. On the web, switch on **Developer mode**: **Settings → Apps → Advanced settings**. Custom connectors stay hidden until it is on.
2. In **Settings → Apps**, choose **Create**. Name it MakeAIVideo and paste `https://mcp.makeaivideo.ai`.
3. Set authentication to **OAuth**, press **Create**, then sign in to MakeAIVideo and approve.

Developer mode needs a Plus, Pro, Business, Enterprise or Education plan.

### Claude Code

```bash
claude mcp add --scope user --transport http makeaivideo https://mcp.makeaivideo.ai
```

Then type `/mcp` in Claude Code, choose **Authenticate**, and sign in. Keep `--scope user` so the server works in every folder.

### Cursor

Click **Add to Cursor** above and confirm **Install**, or add this to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "makeaivideo": { "url": "https://mcp.makeaivideo.ai" }
  }
}
```

Approve the sign-in window Cursor opens.

### VS Code (GitHub Copilot agent mode)

Click **Install in VS Code** above, or run **MCP: Add Server** from the Command Palette, choose **HTTP** and paste the address. Or add this to `.vscode/mcp.json`:

```json
{
  "servers": {
    "makeaivideo": { "type": "http", "url": "https://mcp.makeaivideo.ai" }
  }
}
```

Sign in when VS Code asks, then open **Chat** in **Agent** mode.

### Codex

```bash
codex mcp add makeaivideo --url https://mcp.makeaivideo.ai
codex mcp login makeaivideo
```

Editing `~/.codex/config.toml` by hand? The header is `[mcp_servers.makeaivideo]`, with an underscore.

### Gemini CLI

```bash
gemini mcp add --scope user --transport http makeaivideo https://mcp.makeaivideo.ai
```

Start Gemini CLI, run `/mcp auth makeaivideo`, then sign in. Or install the MakeAIVideo extension from this repo:

```bash
gemini extensions install https://github.com/makeaivideo-ai/mcp
```

### Windsurf

Add this to `~/.codeium/windsurf/mcp_config.json`, then fully quit and reopen Windsurf and approve the sign-in:

```json
{
  "mcpServers": {
    "makeaivideo": { "serverUrl": "https://mcp.makeaivideo.ai" }
  }
}
```

### Other apps

| App | How to connect |
| --- | --- |
| Grok | grok.com → Connectors → **New Connector** → **Custom**, paste the address |
| Perplexity | **Settings → Connectors** → custom connector, **OAuth** and **Streamable HTTP** (Pro, Max or Enterprise) |
| Le Chat | **Connectors** → **+ Add Connector** → **Custom MCP Connector** |
| GitHub Copilot CLI | `copilot mcp add --transport http makeaivideo https://mcp.makeaivideo.ai` |
| Zed | `"context_servers": { "makeaivideo": { "url": "https://mcp.makeaivideo.ai" } }` in `~/.config/zed/settings.json` |
| Cline | Uses an API key: `"type": "streamableHttp"`, the address, and the header `Authorization: Bearer mav_...` |
| n8n, Zapier, Make | Add an MCP Client with the address (n8n works best with a Bearer API key) |
| All coding agents at once | `npx add-mcp https://mcp.makeaivideo.ai` |

Agents that sign themselves in can follow [auth.md](https://makeaivideo.ai/auth.md) (OAuth with PKCE, or the device code flow). Prefer an API key? Send `Authorization: Bearer mav_...` and create the key in the app under [Developers](https://app.makeaivideo.ai/developers).

## Local server (npx)

For apps that only run local commands. The package is a small stdio bridge to the hosted server, so the tools are always the same as the hosted ones. Node 18 or later.

```json
{
  "mcpServers": {
    "makeaivideo": {
      "command": "npx",
      "args": ["-y", "@makeaivideo/mcp"],
      "env": { "MAKEAIVIDEO_API_KEY": "mav_YOUR_KEY" }
    }
  }
}
```

Works with Claude Desktop, Cursor, Windsurf, Cline, Zed, Continue and any stdio MCP client.

With Docker (the `Dockerfile` in this repo):

```bash
docker build -t makeaivideo-mcp .
docker run -i --rm -e MAKEAIVIDEO_API_KEY=mav_YOUR_KEY makeaivideo-mcp
```

Without a key the local server still starts and lists its tools from the bundled `tools.json`, so clients can inspect it. Every tool call then asks for a key.

| Variable | Default | Purpose |
| --- | --- | --- |
| `MAKEAIVIDEO_API_KEY` | (required for tool calls) | Your `mav_` API key |
| `MAKEAIVIDEO_MCP_URL` | `https://mcp.makeaivideo.ai` | Override the remote endpoint |

## Tools (44)

### Create videos

| Tool | What it does |
| --- | --- |
| `create_explainer_video` | Explainer video: one idea, explained clearly from question to payoff |
| `create_listicle_video` | List video: numbered tips or ranked picks, one scene per item |
| `create_story_video` | Story video for history, mysteries and true events |
| `create_ugc_video` | UGC-style ad that reads like a real recommendation |
| `create_demo_video` | Product demo that shows the job getting done, step by step |
| `create_article_video` | Turns a blog post, newsletter or other writing into a short |
| `create_spokesperson_video` | One lip-synced presenter, straight to camera, from a character you pick |
| `create_video_from_script` | Renders a video from a script you already have |

Each create tool takes the length, aspect ratio (9:16, 1:1 or 16:9), and an optional character and voice. It returns a video id at once; the render takes minutes.

### Plan and write

| Tool | What it does |
| --- | --- |
| `estimate_video_cost` | Quotes the credit cost before anything is spent (no credits used) |
| `write_script` | Writes the script only: title, hook and scenes with narration and visuals |
| `structure_text` | Turns prose or a hand-written script into a scene script |
| `fetch_article` | Reads a public article's text so it can become a video |
| `generate_ideas` | Scored video ideas for a niche and audience |
| `enhance_prompt` | Rewrites a rough topic into a stronger brief |

### Track and deliver

| Tool | What it does |
| --- | --- |
| `get_video_status` | Progress of one video, and its download link when ready |
| `list_my_videos` | Your videos with id, title and status |
| `get_download_url` | A signed MP4 link for a finished video |
| `get_captions` | The video's captions as SRT or VTT |
| `create_share_link` | A public link to the MP4 that expires (24 hours by default, up to 7 days) |
| `export_video` | Renders the video again after edits |

### Edit and redo

| Tool | What it does |
| --- | --- |
| `update_video` | Edits the title, topic, script or caption settings |
| `generate_video` | Starts or re-runs generation for a draft |
| `regenerate_scene` | Redoes one scene, optionally with new narration |
| `regenerate_voice` | Re-records the voiceover with another voice |
| `cancel_video` | Stops a render and releases its reserved credits |
| `delete_video` | Deletes a video and its files |

### Characters, voices and music

| Tool | What it does |
| --- | --- |
| `list_characters` | Preset and saved characters (presenters) |
| `generate_character_portraits` | Portrait options for a new character from a description |
| `generate_voice_previews` | Voice options for a new character |
| `create_character` | Saves a character from a chosen portrait and voice |
| `list_voices` | Voices, filtered by gender, accent, age and use case |
| `preview_voice` | Hear a voice read your text |
| `generate_music` | A background track (15, 30 or 60 seconds) from a prompt and mood |
| `list_music` | Your generated tracks |
| `list_templates` | The template library |

### Post to social media

| Tool | What it does |
| --- | --- |
| `list_social_accounts` | Your connected social accounts and their ids |
| `get_connect_link` | A link a person opens in the browser to connect an account |
| `publish_video` | Posts a finished video now or at a scheduled time, with one caption or one per platform |
| `get_publish_status` | Result of a post, with the live post URLs |
| `list_posts` | Past and scheduled posts |

### Account and automation

| Tool | What it does |
| --- | --- |
| `whoami` | Who is signed in, the plan and the credit balance |
| `get_credits` | The credit balance in detail |
| `create_webhook` | Calls your URL when a video is ready, fails, or is posted |
| `list_webhooks` | Your webhooks and their delivery health |

## How a video gets made

1. The assistant quotes the cost with `estimate_video_cost` (optional, but good practice).
2. It calls a `create_*_video` tool with your brief, or `write_script` first so you can edit the script.
3. It polls `get_video_status` (it respects `poll_after_seconds`) until the video is ready, usually a few minutes.
4. It returns the MP4 link from `get_download_url`, or posts the video with `publish_video`.

## Posting to TikTok, Instagram, YouTube and more

`publish_video` posts a finished video to one or more connected accounts, now or at a scheduled time. Supported: TikTok, Instagram (as a Reel), YouTube (a 9:16 video posts as a Short, 16:9 as a regular video), Facebook (Pages only), LinkedIn, X (videos up to 140 seconds), Threads, Pinterest, Bluesky, Telegram and Discord.

A person connects each account once. `get_connect_link` returns a short-lived link that you open in a browser to approve access; the assistant cannot do this step for you. Bluesky, Telegram and Discord connect in the web app. Posts are public, so a well-behaved assistant confirms the accounts and caption with you first.

## Credits and pricing

The MCP server has no separate charge. It needs a MakeAIVideo account, and videos are paid from that account's credits, the same balance the web app uses.

- New accounts start with a 7-day trial on a monthly plan. A card is required, and the trial includes trial credits.
- `estimate_video_cost` quotes the exact cost before anything is spent. Checking status, listing and quoting use no credits.
- An agent cannot create an account for you. Sign up at [app.makeaivideo.ai/signup](https://app.makeaivideo.ai/signup), then connect.

Plans and credit costs: [makeaivideo.ai/pricing](https://makeaivideo.ai/pricing).

## FAQ

### Is there an MCP server for AI video generation?

Yes. The MakeAIVideo MCP server at `https://mcp.makeaivideo.ai` gives any MCP client 44 tools to write scripts, create finished short-form AI videos with voiceover, scenes, captions and music, and post them to social media. It is listed in the official MCP Registry as `ai.makeaivideo/video-generator`.

### How do I make AI videos with ChatGPT?

Add `https://mcp.makeaivideo.ai` as a custom connector in ChatGPT (Developer mode, **Settings → Apps → Create**, authentication **OAuth**), sign in to MakeAIVideo, then ask ChatGPT for the video you want, for example "make a 30-second explainer about black holes". ChatGPT creates it and gives you the MP4 link. More on the [ChatGPT video generator page](https://makeaivideo.ai/chatgpt-video-generator).

### Can Claude create TikTok videos?

Yes. Connect MakeAIVideo in Claude (**Customize → Connectors → Add custom connector**) and ask for a vertical TikTok video. Claude writes the script, makes the video with voiceover, captions and music, and can post it to your TikTok account now or on a schedule once you have connected it.

### Can Cursor, Claude Code or other coding agents make videos?

Yes. Use the one-click Cursor or VS Code buttons above, or the one-line commands for Claude Code, Codex and Gemini CLI. For shell-only agents there is also the [MakeAIVideo CLI](https://github.com/makeaivideo-ai/cli).

### Can an AI agent post videos to TikTok, Instagram Reels and YouTube Shorts?

Yes. After you connect each account once in the browser, the assistant can post or schedule a finished video to TikTok, Instagram, YouTube, Facebook Pages, LinkedIn, X, Threads, Pinterest, Bluesky, Telegram and Discord.

### Can it make talking avatar videos?

Yes. `create_spokesperson_video` makes a lip-synced presenter video from a character you pick with `list_characters` or create with `create_character`. See [talking avatar](https://makeaivideo.ai/talking-avatar).

### Can it turn an image into a video, or swap the person in my video?

Not through MCP tools, because both need a file upload. Use the web app or the REST API for [image to video](https://makeaivideo.ai/image-to-video) and [character swap](https://makeaivideo.ai/character-swap).

### Do I need an API key?

Not for the hosted server: most apps sign you in with OAuth. You need a `mav_` API key only for the local `npx` server, Cline, unattended automations, or apps without OAuth.

### How much does it cost?

MakeAIVideo is a paid product. New accounts start with a 7-day trial (card required), and videos use credits from your plan. The MCP server itself has no extra charge. `estimate_video_cost` quotes each video first. See [pricing](https://makeaivideo.ai/pricing).

### How long does a video take, and what formats do I get?

A few minutes. You get an MP4 in 9:16 (vertical), 1:1 or 16:9, with captions burned in, and SRT or VTT caption files on request. Scripts, voiceover and captions can be in 24 languages.

### Is it open source?

This package, the local stdio bridge, is MIT-licensed. The video generation runs on the hosted MakeAIVideo service.

## Links

- MakeAIVideo home: [makeaivideo.ai](https://makeaivideo.ai)
- MCP setup guide: [makeaivideo.ai/docs/mcp](https://makeaivideo.ai/docs/mcp)
- Connect your AI app (in the app): [app.makeaivideo.ai/ai-assistants](https://app.makeaivideo.ai/ai-assistants)
- Agent sign-in guide: [makeaivideo.ai/auth.md](https://makeaivideo.ai/auth.md)
- AI agents overview: [makeaivideo.ai/agents](https://makeaivideo.ai/agents) · [agent guide](https://makeaivideo.ai/docs/agents)
- Pricing: [makeaivideo.ai/pricing](https://makeaivideo.ai/pricing)
- Docs: [makeaivideo.ai/docs](https://makeaivideo.ai/docs) · [API reference](https://makeaivideo.ai/docs/api) · [quickstart](https://makeaivideo.ai/docs/quickstart) · [authentication](https://makeaivideo.ai/docs/authentication) · [webhooks](https://makeaivideo.ai/docs/webhooks)
- Developer hub: [makeaivideo.ai/developers](https://makeaivideo.ai/developers)
- Video types: [prompt to video](https://makeaivideo.ai/prompt-to-video) · [script to video](https://makeaivideo.ai/script-to-video) · [talking avatar](https://makeaivideo.ai/talking-avatar) · [image to video](https://makeaivideo.ai/image-to-video) · [character swap](https://makeaivideo.ai/character-swap) · [AI UGC video](https://makeaivideo.ai/ai-ugc-video) · [AI ad maker](https://makeaivideo.ai/ai-ad-maker) · [AI spokesperson video](https://makeaivideo.ai/ai-spokesperson-video) · [AI explainer video](https://makeaivideo.ai/ai-explainer-video) · [blog to video](https://makeaivideo.ai/blog-to-video) · [AI influencer generator](https://makeaivideo.ai/ai-influencer-generator)
- Channels: [TikTok](https://makeaivideo.ai/tiktok-video-generator) · [Instagram Reels](https://makeaivideo.ai/instagram-reels-generator) · [YouTube Shorts](https://makeaivideo.ai/ai-shorts-generator) · [faceless YouTube channel](https://makeaivideo.ai/faceless-youtube-channel) · [auto-post](https://makeaivideo.ai/auto-post)
- Compare: [MakeAIVideo vs HeyGen](https://makeaivideo.ai/compare/heygen) · [MakeAIVideo vs Synthesia](https://makeaivideo.ai/compare/synthesia)
- npm: [@makeaivideo/mcp](https://www.npmjs.com/package/@makeaivideo/mcp) · [@makeaivideo/sdk](https://www.npmjs.com/package/@makeaivideo/sdk) · [@makeaivideo/cli](https://www.npmjs.com/package/@makeaivideo/cli)
- Support: support@makeaivideo.ai or an [issue](https://github.com/makeaivideo-ai/mcp/issues)

## Related packages

| Package | What it is |
| --- | --- |
| [`@makeaivideo/mcp`](https://github.com/makeaivideo-ai/mcp) | This MCP server, for ChatGPT, Claude, Cursor and other AI assistants |
| [`@makeaivideo/cli`](https://github.com/makeaivideo-ai/cli) | Command line tool for terminals and shell agents: brief in, MP4 out |
| [`@makeaivideo/sdk`](https://github.com/makeaivideo-ai/sdk) | TypeScript and JavaScript SDK for the REST API |

## License

MIT © [MakeAIVideo](https://makeaivideo.ai)