io.github.hanshs474/movoa-mcp
Movoa (movoa.ai), the AI video generator with sound: text and photo to video from any MCP client.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http movoa-mcp 'https://movoa.ai/api/mcp' --header 'Authorization: <Bearer sk-... from https://movoa.ai/settings/apikeys>'
{
"mcpServers": {
"movoa-mcp": {
"type": "http",
"url": "https://movoa.ai/api/mcp",
"headers": {
"Authorization": "<Bearer sk-... from https://movoa.ai/settings/apikeys>"
}
}
}
}
movoa-mcpclaude mcp add movoa-mcp -e 'MOVOA_API_KEY=<your movoa_api_key>' -- npx -y movoa-mcp@0.1.0
{
"mcpServers": {
"movoa-mcp": {
"command": "npx",
"args": [
"-y",
"movoa-mcp@0.1.0"
],
"env": {
"MOVOA_API_KEY": "<your movoa_api_key>"
}
}
}
}
Variables d'environnement
MOVOA_API_KEYobligatoire secret API key from https://movoa.ai/settings/apikeys
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Movoa 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
Questions fréquentes
Qu'est-ce que io.github.hanshs474/movoa-mcp ?
Movoa (movoa.ai), the AI video generator with sound: text and photo to video from any MCP client.
Comment installer io.github.hanshs474/movoa-mcp ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http movoa-mcp 'https://movoa.ai/api/mcp' --header 'Authorization: <Bearer sk-... from https://movoa.ai/settings/apikeys>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.hanshs474/movoa-mcp ?
Oui. Il attend MOVOA_API_KEY, Authorization, à renseigner dans sa configuration.
io.github.hanshs474/movoa-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.hanshs474/movoa-mcp ?
Il est publié par hanshs474. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.