English Français العربية

io.github.hanshs474/movoa-mcp

Official registry Media and design

Movoa (movoa.ai), the AI video generator with sound: text and photo to video from any MCP client.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http movoa-mcp 'https://movoa.ai/api/mcp' --header 'Authorization: <Bearer sk-... from https://movoa.ai/settings/apikeys>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "movoa-mcp": {
            "type": "http",
            "url": "https://movoa.ai/api/mcp",
            "headers": {
                "Authorization": "<Bearer sk-... from https://movoa.ai/settings/apikeys>"
            }
        }
    }
}
NPM package movoa-mcp
Claude Code 
claude mcp add movoa-mcp -e 'MOVOA_API_KEY=<your movoa_api_key>' -- npx -y movoa-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "movoa-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "movoa-mcp@0.1.0"
            ],
            "env": {
                "MOVOA_API_KEY": "<your movoa_api_key>"
            }
        }
    }
}

Environment variables

  • MOVOA_API_KEY required secret API key from https://movoa.ai/settings/apikeys

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Movoa MCP server
  2. Tools
  3. API key
  4. Install
  5. Models
  6. Notes
  7. License

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.

Tools

ToolWhat it does
generate_videoText to video, or photo to video with image_url. Returns a run id (or waits with wait: true)
check_statusStatus of a run, and the video URL when it is ready
creditsCredits 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

modelLength (duration)resolutionaspect_ratio
minimax-h3 (default)4, 5, 6, 8, 10, 15 s480p, 768p16:9, 9:16, 1:1
seedance-2-55–30 s, steps of 5480p, 720p16:9, 9:16, 1:1
veo-3-1-fast8 s720p16:9, 9:16
seedance-2 · seedance-2-fast · seedance-2-mini4, 6, 8, 10 s480p, 720p16:9, 9:16, 1:1

Notes

  • Video takes minutes. generate_video returns a run id by default; poll it with check_status, or pass wait: true to block (up to 30 minutes).
  • Your plan's concurrency limit applies; a submit past it is refused until a run finishes.
  • MOVOA_BASE_URL overrides the endpoint; only useful against a local build of the site.

License

MIT

Frequently asked questions

What is io.github.hanshs474/movoa-mcp?

Movoa (movoa.ai), the AI video generator with sound: text and photo to video from any MCP client.

How do I install io.github.hanshs474/movoa-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http movoa-mcp 'https://movoa.ai/api/mcp' --header 'Authorization: <Bearer sk-... from https://movoa.ai/settings/apikeys>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.hanshs474/movoa-mcp need an API key?

Yes. It expects MOVOA_API_KEY, Authorization, which you set in its configuration.

Is io.github.hanshs474/movoa-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.hanshs474/movoa-mcp?

It is published by hanshs474. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.