About movoa-mcp
movoa-mcp is Movoa’s MCP server for generating sound-enabled videos from text or a photo through an MCP client. It provides tools to start runs, check their status, and view account credits.
Key features
- 01Text-to-video with sound
- 02Photo-to-video using the image as first frame
- 03Multiple video generation models
- 04Run status and video URL lookup
- 05Account credit lookup
Use cases
- 01Generate a narrated or sound-enabled clip from a prompt
- 02Animate a photo into a video
- 03Check a video run while it renders
MCP support
The server exposes video generation, run-status, and credit tools to MCP clients. It supports local installation and a Streamable HTTP endpoint.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://movoa.ai/api/mcpclaude mcp add --transport http hanshs474-movoa https://movoa.ai/api/mcp{"mcpServers":{"hanshs474-movoa":{"type":"http","url":"https://movoa.ai/api/mcp"}}}Open in Cursor{"servers":{"hanshs474-movoa":{"type":"http","url":"https://movoa.ai/api/mcp"}}}Open in VS Code{"mcpServers":{"hanshs474-movoa":{"type":"http","url":"https://movoa.ai/api/mcp"}}}{"mcpServers":{"hanshs474-movoa":{"serverUrl":"https://movoa.ai/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://movoa.ai/api/mcpAuth requiredTools
Details
From the project READMEMovoa MCP server
Unlimited AI video generator with sound: on paid plans the tenth take of a shot costs what the first did, and your first clip is free to make right now. This is the official MCP server for Movoa: it lets Claude, Cursor, Cline, Gemini CLI or any MCP client make video clips with sound on your own Movoa account. Ask for a clip in chat, get the file URL back.
- Text to video: describe the shot, and the sound comes back in the same file.
- Photo to video: pass a photo as
image_urland it becomes the first frame. - MiniMax H3 is the default model; Seedance 2.5, Seedance 2.0 (Fast, Mini) and Veo 3 Fast are there too. Every one of them returns AI video with audio.
Tools
| Tool | What it does |
|---|---|
generate_video | Text to video, or photo to video with image_url. Returns a run id (or waits with wait: true) |
check_status | Status of a run, and the video URL when it is ready |
credits | Credits left on your account (free to call) |
API key
Create one at movoa.ai/settings/apikeys and set it as MOVOA_API_KEY. Runs cost credits on your Movoa account, at the prices on movoa.ai/pricing.
Install
npx -y movoa-mcp
Claude Desktop / Claude Code / Cursor / Cline
{
"mcpServers": {
"movoa": {
"command": "npx",
"args": ["-y", "movoa-mcp"],
"env": { "MOVOA_API_KEY": "sk-..." }
}
}
}
Claude Code in one line: claude mcp add movoa -e MOVOA_API_KEY=sk-... -- npx -y movoa-mcp
Remote (Streamable HTTP, no install)
https://movoa.ai/api/mcp
Send your key with each request as Authorization: Bearer sk-.... Listing the tools needs no key; running one does. Claude Code: claude mcp add --transport http movoa https://movoa.ai/api/mcp --header "Authorization: Bearer sk-..."
Gemini CLI
gemini extensions install https://github.com/hanshs474/movoa-mcp
Claude Code plugin
claude plugin marketplace add hanshs474/movoa-mcp
claude plugin install movoa@movoa
The plugin also ships the movoa-video skill, which works without MCP (plain curl).
Models
model | Length (duration) | resolution | aspect_ratio |
|---|---|---|---|
minimax-h3 (default) | 4, 5, 6, 8, 10, 15 s | 480p, 768p | 16:9, 9:16, 1:1 |
seedance-2-5 | 5–30 s, steps of 5 | 480p, 720p | 16:9, 9:16, 1:1 |
veo-3-1-fast | 8 s | 720p | 16:9, 9:16 |
seedance-2 · seedance-2-fast · seedance-2-mini | 4, 6, 8, 10 s | 480p, 720p | 16:9, 9:16, 1:1 |
Notes
- Video takes minutes.
generate_videoreturns a run id by default; poll it withcheck_status, or passwait: trueto block (up to 30 minutes). - Your plan's concurrency limit applies; a submit past it is refused until a run finishes.
MOVOA_BASE_URLoverrides the endpoint; only useful against a local build of the site.
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.