
MakeAIVideo MCP server: an AI video generator for Claude, ChatGPT, Cursor and any MCP client. 44
MakeAIVideo MCP server: an AI video generator for Claude, ChatGPT, Cursor and any MCP client. 44 tools to create finished AI videos (voiceover, scenes, captions, music) and post them to TikTok, Instagram, YouTube and more. Hosted at https://mcp.makeaivideo.ai or npx @makeaivideo/mcp
·
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 server for MakeAIVideo, 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) |
| Registry name | ai.makeaivideo/video-generator |
Ask your assistant for a video in plain words and it picks the right tool:
Image to video and character swap need a file upload, so they run in the web app and the REST API, not through MCP tools. See more on the examples page.
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 in the app.
After you connect, try: "How many MakeAIVideo credits do I have? Then give me three video ideas for my channel."
https://mcp.makeaivideo.ai.It then works in the Claude phone apps too. On Team and Enterprise plans an Owner adds connectors first, in Organization settings.
https://mcp.makeaivideo.ai.Developer mode needs a Plus, Pro, Business, Enterprise or Education plan.
claude mcp add --scope user --transport http makeaivideo https://mcp.makeaivideo.aiThen type /mcp in Claude Code, choose Authenticate, and sign in. Keep --scope user so the server works in every folder.
Click Add to Cursor above and confirm Install, or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"makeaivideo": { "url": "https://mcp.makeaivideo.ai" }
}
}Approve the sign-in window Cursor opens.
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:
{
"servers": {
"makeaivideo": { "type": "http", "url": "https://mcp.makeaivideo.ai" }
}
}Sign in when VS Code asks, then open Chat in Agent mode.
codex mcp add makeaivideo --url https://mcp.makeaivideo.ai
codex mcp login makeaivideoEditing ~/.codex/config.toml by hand? The header is [mcp_servers.makeaivideo], with an underscore.
gemini mcp add --scope user --transport http makeaivideo https://mcp.makeaivideo.aiStart Gemini CLI, run /mcp auth makeaivideo, then sign in. Or install the MakeAIVideo extension from this repo:
gemini extensions install https://github.com/makeaivideo-ai/mcpAdd this to ~/.codeium/windsurf/mcp_config.json, then fully quit and reopen Windsurf and approve the sign-in:
{
"mcpServers": {
"makeaivideo": { "serverUrl": "https://mcp.makeaivideo.ai" }
}
}| 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 (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.
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.
{
"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):
docker build -t makeaivideo-mcp .
docker run -i --rm -e MAKEAIVIDEO_API_KEY=mav_YOUR_KEY makeaivideo-mcpWithout 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 |
| 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.
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
estimate_video_cost (optional, but good practice).create_*_video tool with your brief, or write_script first so you can edit the script.get_video_status (it respects poll_after_seconds) until the video is ready, usually a few minutes.get_download_url, or posts the video with publish_video.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.
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.
estimate_video_cost quotes the exact cost before anything is spent. Checking status, listing and quoting use no credits.Plans and credit costs: makeaivideo.ai/pricing.
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.
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.
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.
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.
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.
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.
Not through MCP tools, because both need a file upload. Use the web app or the REST API for image to video and character swap.
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.
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.
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.
This package, the local stdio bridge, is MIT-licensed. The video generation runs on the hosted MakeAIVideo service.
| Package | What it is |
|---|---|
@makeaivideo/mcp | This MCP server, for ChatGPT, Claude, Cursor and other AI assistants |
@makeaivideo/cli | Command line tool for terminals and shell agents: brief in, MP4 out |
@makeaivideo/sdk | TypeScript and JavaScript SDK for the REST API |
MIT © MakeAIVideo
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add makeaivideo --transport http https://mcp.makeaivideo.ai{
"mcpServers": {
"makeaivideo": {
"url": "https://mcp.makeaivideo.ai"
}
}
}code --add-mcp '{"name":"makeaivideo","url":"https://mcp.makeaivideo.ai"}'Runs as a hosted service. Your client connects over the network and nothing is installed locally.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/makeaivideo-mcp-server to learn what the "MakeAIVideo MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add --scope user --transport http makeaivideo https://mcp.makeaivideo.aidocker run -i --rm -e MAKEAIVIDEO_API_KEY=mav_YOUR_KEY makeaivideo-mcpThis server doesn't publish a machine-readable tool manifest, and it doesn't expose a public endpoint we could ask. Connect the server locally to see what it exposes.
We could not run this server: its endpoint did not list its tools to an anonymous client, which usually means it asks for an API key or a sign-in. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/makeaivideo-mcp-server)Nothing comparable is listed yet.
v1.0.4Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "makeaivideo-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.