ClipmivoAI — Claude Code MCP server: AI video generation
A local MCP server for ClipmivoAI that lets your agent find video models, price a job in credits, run it and pull down the result.
Open on GitHubWhat ClipmivoAI does
The server sits on top of the ClipmivoAI API and exposes five operations to the agent: model discovery, balance check, cost quote, generation and download. Everything runs over stdio, so the client launches clipmivo-mcp on your machine.
You need a scoped key with video:read, video:write and files:write before anything works — read and generation calls fail without it. Put it in CLIPMIVO_API_KEY and point CLIPMIVO_FILES_DIR at a directory for media files. One key draws on the balance of the account it belongs to; if you build a customer-facing app, keep the key on your server, since keys under the same account are not isolated reseller subaccounts and share the account's funds and resources.
Pricing comes back in credits: show credits_to_hold as is, don't multiply it by 100. Credits are reserved before generation and settled against actual usage afterwards, with the unused part returned to the balance. Model options and prices move, so pull them from a live request instead of hardcoding a list.
What it helps with
- find out which video models are available right now and what they cost
- price a clip in credits before spending anything
- generate a video and save the file to disk
- check the remaining credit balance on the account
- re-query a task status when a wait times out
Example prompts for the agent
- List the available video models and their credit prices
- Quote the request in
examples/request.jsonand confirm the spend limit - Generate from
quoted-request.jsonand download the result toresult.mp4
How to install ClipmivoAI
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about ClipmivoAI
How do I install ClipmivoAI in Claude Code?
Run npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-mcp-0.1.8.tgz, then add a clipmivo server to your client config with the command clipmivo-mcp and the CLIPMIVO_API_KEY and CLIPMIVO_FILES_DIR variables. Node.js 22+ and npm are required.
What does ClipmivoAI do?
It gives your agent access to the ClipmivoAI API: model discovery, balance, cost quotes, video generation and file download.
Does the server need an API key?
Yes. Create a key with video:read, video:write and files:write scopes and set it as CLIPMIVO_API_KEY. Requests create generation tasks but do not buy credits — top-ups happen on the website.
