@makeaivideo/mcp

MakeAIVideo MCP server: let Claude, ChatGPT, Cursor and any MCP client create finished AI videos (script, voiceover, scenes, captions, music) for TikTok, Instagram Reels and YouTube Shorts. 39 tools.

latest

Source

npm

Version: 1.0.0

Version published: yesterday

Maintainers: 1

Created: yesterday

Source

MakeAIVideo MCP Server

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)

Area	Tools
Create videos	`create_explainer_video`, `create_listicle_video`, `create_story_video`, `create_ugc_video`, `create_demo_video`, `create_article_video`, `create_spokesperson_video`, `create_video_from_script`
Plan	`estimate_video_cost`, `write_script`, `structure_text`, `fetch_article`, `generate_ideas`, `enhance_prompt`
Track and deliver	`get_video_status`, `list_my_videos`, `get_download_url`, `get_captions`, `create_share_link`, `export_video`
Edit	`update_video`, `generate_video`, `regenerate_scene`, `regenerate_voice`, `cancel_video`, `delete_video`
Characters, voices, music	`list_characters`, `create_character`, `generate_character_portraits`, `generate_voice_previews`, `list_voices`, `preview_voice`, `generate_music`, `list_music`, `list_templates`
Account and automation	`whoami`, `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

Variable	Default	Purpose
`MAKEAIVIDEO_API_KEY`	(required)	Your `mav_` API key
`MAKEAIVIDEO_MCP_URL`	`https://mcp.makeaivideo.ai`	Override 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.

Make videos in the app: prompt to video, script to video, image to video, talking avatar, AI ad maker, blog to video
By format: TikTok video generator, Instagram Reels generator, AI Shorts generator, faceless YouTube channel, AI UGC video, AI explainer video, AI spokesperson video
For developers: developer hub, API reference, quickstart, authentication, webhooks, MCP server, AI agents, CLI
Compare: MakeAIVideo vs HeyGen, MakeAIVideo vs Synthesia
Pricing · Free creator tools · Blog · Help · Contact

Package	What it is
`@makeaivideo/sdk`	TypeScript / JavaScript SDK for the REST API
`@makeaivideo/mcp`	MCP server for Claude, ChatGPT, Cursor and other AI assistants
`@makeaivideo/cli`	Command line tool: brief in, MP4 out