MakeAIVideo

Create finished AI videos (script, voiceover, scenes, captions, music) for TikTok, Reels and Shorts.

AI & MLTypeScriptv1.3.0

MakeAIVideo MCP Server

npm license

Let Claude, ChatGPT, Cursor and any MCP client make finished AI videos. The MakeAIVideo MCP server gives your AI assistant 39 tools to write a script, generate a video with AI voiceover, scenes, captions and music, and hand back the MP4, ready for TikTok, Instagram Reels and YouTube Shorts.

Ask your assistant things like:

  • "Make a 30-second explainer video about why octopuses have three hearts, vertical, and give me the MP4."
  • "Write a script for a UGC ad for my skincare product, then turn it into a video."
  • "Give me 10 video ideas for a personal finance channel and make the best one."

Two ways to connect

1. Hosted server (recommended): https://mcp.makeaivideo.ai

Streamable HTTP with OAuth: add it as a custom connector and sign in, no key to copy.

  • Claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → https://mcp.makeaivideo.ai
  • ChatGPT: Settings → Connectors → Create → MCP server URL https://mcp.makeaivideo.ai
  • Claude Code:
    claude mcp add --transport http makeaivideo https://mcp.makeaivideo.ai
    
  • Cursor (~/.cursor/mcp.json) / VS Code (.vscode/mcp.json):
    { "mcpServers": { "makeaivideo": { "url": "https://mcp.makeaivideo.ai" } } }
    

Prefer an API key? Send Authorization: Bearer mav_... (create one in the developer settings).

2. Local stdio server (this package)

For clients that only run local commands. It bridges to the hosted server, so every tool stays in sync.

{
  "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. Node 18+.

Tools (39)

AreaTools
Create videoscreate_explainer_video, create_listicle_video, create_story_video, create_ugc_video, create_demo_video, create_article_video, create_spokesperson_video, create_video_from_script
Planestimate_video_cost, write_script, structure_text, fetch_article, generate_ideas, enhance_prompt
Track and deliverget_video_status, list_my_videos, get_download_url, get_captions, create_share_link, export_video
Editupdate_video, generate_video, regenerate_scene, regenerate_voice, cancel_video, delete_video
Characters, voices, musiclist_characters, create_character, generate_character_portraits, generate_voice_previews, list_voices, preview_voice, generate_music, list_music, list_templates
Account and automationwhoami, get_credits, create_webhook, list_webhooks

Renders take minutes: the assistant creates the video, then polls get_video_status (it respects poll_after_seconds) and returns the download link. Full reference: makeaivideo.ai/docs/mcp.

Environment variables

VariableDefaultPurpose
MAKEAIVIDEO_API_KEY(required)Your mav_ API key
MAKEAIVIDEO_MCP_URLhttps://mcp.makeaivideo.aiOverride the remote endpoint

FAQ

What is the MakeAIVideo MCP server? A Model Context Protocol server that lets AI assistants create finished short-form AI videos with MakeAIVideo.

Does it cost anything? The server is free. Videos use credits from your MakeAIVideo plan, and estimate_video_cost quotes before anything is spent. See pricing.

Which AI assistants work? Anything that speaks MCP: Claude (web, desktop, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline, Zed and more. See AI agents.

Is there a REST API too? Yes: API reference and the TypeScript SDK.

About MakeAIVideo

MakeAIVideo is an AI video generator that turns a brief, a prompt or your own script into a finished, captioned short-form video: script, AI voiceover, AI-generated or stock scenes, captions and music, exported as an MP4 ready for TikTok, Instagram Reels and YouTube Shorts.

Related packages

PackageWhat it is
@makeaivideo/sdkTypeScript / JavaScript SDK for the REST API
@makeaivideo/mcpMCP server for Claude, ChatGPT, Cursor and other AI assistants
@makeaivideo/cliCommand line tool: brief in, MP4 out

License

MIT © MakeAIVideo

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @makeaivideo/mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "ai-makeaivideo-video-generator": {
      "command": "npx",
      "args": [
        "-y",
        "@makeaivideo/mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@makeaivideo/mcpnpm

Compatible MCP Clients

MakeAIVideo works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More