Vivideo MCP server
online · 100% uptimeio.github.egocen-vivideo/vivideo·v1.0.2AI video generation via the Vivideo API: auto or manual mode, avatars, voices, brand kits.
0 stars19 downloads/wk
Reviews
Write oneNobody has reviewed Vivideo yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Vivideo tools (13, 2 write)
write = sends, deletes, buys or postscheck_accountFreeGet the account plan, premium status, and remaining credit balance. Use this to decide whether the user can generate a video (rendering needs a premium plan and enough credits). Returns plan, premium, credits, free_video_available, and links (upgrade / buy_credits). Cheap and safe to call often.
check_configurationFreeCheck whether a Vivideo API key is present on this request. Call this FIRST. Returns { configured: boolean }. If false, ask the user to add an Authorization: Bearer vv_live_... header to the MCP server config (a key from https://app.vivideo.ai/account/api-keys). Never asks for or exposes the key.
create_auto_videowrite actionFreeCreate a video in AUTO mode: Vivideo writes the script and produces a complete AI-avatar video from your prompt. Returns immediately with a video id and status "processing" (paid) or "preview" (free accounts — see the preview field and upgrade link). Then call wait_for_video or get_video. An Idempotency-Key is sent automatically so a retry never creates a duplicate. Rendering requires a premium plan and credits.
create_manual_videowrite actionFreeCreate a video in MANUAL mode: send your prompt straight to a specific model (get ids/options from list_models). The operation is inferred from inputs — add image_url for image-to-video. resolution/duration/aspect_ratio must match the model (an invalid value returns a 400 listing what is allowed). Returns a video id and status; then wait_for_video or get_video. Idempotency handled automatically.
estimate_creditsFreeEstimate the credits a generation will cost, from the published per-model rates — BEFORE creating it. This is an estimate, not a charge; the exact amount is returned as credits_charged when you create the video. Use it with check_account to confirm the user can afford the request.
get_videoFreeGet a video's current status and result. status is one of queued | processing | completed | failed | preview. When completed, video_url is the MP4. When failed, credits are refunded and error explains why. Cheap; prefer wait_for_video for polling instead of calling this in a tight loop.
list_avatarsFreeList available avatars for auto-mode videos (the stock catalogue plus the account's own avatars). Stock avatars are grouped by person, each with a `looks` array — pass a looks[].avatar_id (or an owned avatar's id) as `avatar_id` in create_auto_video. Use `search`/`limit` to keep responses small.
list_brand_kitsFreeList the account's brand kits (logo, colors, fonts, motion style). Returns brand_ref ids to pass as `brand_kit_id` in create_auto_video to produce an on-brand video.
list_modelsFreeList the video models available for MANUAL mode plus the auto-generate pipeline (id "vivideo-auto"). Each model lists its operations, allowed durations, resolutions, aspect ratios, style presets and per-second credit rate — use these to build a valid create request. Filter with `mode` to keep the response small.
list_videosFreeList the account's videos, newest first. Filter by status and limit the count to keep responses small.
list_voicesFreeList available voices for auto-mode videos. Returns voice ids to pass as `voice_id` in create_auto_video. Filter by language/gender/search and cap with `limit`. Voice cloning is not available via the API.
render_previewFreeFor FREE accounts only: after the user upgrades, render a video that was returned as status "preview". Charges run on the same project (the first video after upgrading is free). If the video is already rendering/complete, returns its current state. If the account is still free, returns an upgrade_required error with an upgrade link.
wait_for_videoFreeWait for a video to reach a terminal state (completed / failed / preview), then return it. Polls safely at the API-suggested interval for up to ~20 seconds per call (HTTP requests are time-capped). If it does not finish in time it returns { timed_out: true } with the latest status — simply call it again with the same id to keep waiting. It never blocks indefinitely or over-polls.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- Live reliabilityremote reachable in 1560ms20/20
- Tool poisoning13 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 58 days ago12/15
- Maintainer identityregistry namespace matches repository owner6/10
How Vivideo compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 86/100
- higher than 74% of 1,337 Media servers
- Tools
- 13
- the typical Media server has 7
- Tools that change things
- 15%
- typical: 4%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Media server answers 100%
- Response time
- 151 ms
- faster than 79% of 862 Media servers
- Downloads a week
- 19
- more than 6% of 365 Media servers with a package
What its tools let an agent do: 11 read · 2 create
Install Vivideo in Claude Code, Cursor or VS Code
claude mcp add --transport http vivideo https://api.vivideo.ai/mcp
What the publisher says
From the Vivideo repository's README, as published. We do not edit it. Read it on GitHub
Vivideo Toolchain
The developer + agent integration layer for the Vivideo API — a shared client, an MCP server, a CLI, and Skills. Agents are a primary user, not an afterthought.
Everything sits on top of the public API (the source of truth). No backend business logic is duplicated here — the toolchain only adds client-side ergonomics and guardrails.
vivideo-toolchain/ npm workspaces monorepo (TypeScript)
├── packages/core @vivideo/core one typed API client + guardrails (shared)
├── packages/mcp @vivideo/mcp MCP server (stdio) — 13 agent tools
├── packages/cli @vivideo/cli `vivideo` CLI — humans, scripts, CI, agents
├── skills/ reusable agent Skills (SKILL.md)
└── docs/ installation, configuration, workflowsArchitecture
One client, one set of types, derived from packages/core/openapi.yaml. The MCP server and CLI both call @vivideo/core — there is exactly one representation of each request/response, so the tools, CLI, docs and OpenAPI stay consistent.
@vivideo/core adds only client-side concerns, never business logic:
These complement — and never bypass — the API's own auth, rate limits, idempotency, credit checks, premium gates, ownership and error model.
Quick start
# from the repo (until packages are published to npm)
npm install
npm run build
# authenticate (stored 0600 in ~/.vivideo/config.json), or use VIVIDEO_API_KEY
export VIVIDEO_API_KEY="vv_live_..." # from https://app.vivideo.ai/account/api-keys
# CLI
node packages/cli/dist/index.js account
node packages/cli/dist/index.js create auto --prompt "A 20s product teaser" --wait
# MCP server (stdio) — point an MCP client at this command
node packages/mcp/dist/index.jsOnce published: npm i -g @vivideo/cli (gives vivideo), and npx @vivideo/mcp for the server.
Docs
- MCP server — install, configure, connect to clients, tool reference
- CLI — install, auth, command reference, JSON & non-interactive use, exit codes
- Skills — install & use
- Workflows — human & agent, end to end
- Security, rate limits, idempotency, credits & premium, troubleshooting
Authentication & security
- Keys are read from (in order): explicit option → VIVIDEOAPIKEY env → ~/.vivideo/config.json (written owner-only 0600).
- The key is never printed — all output passes through secret redaction; configure stores it without echoing it.
- Keys are account-scoped secrets. Keep them server-side; one per integration so a leak is revocable in isolation.
Not included (honest scope)
- Cancellation — the public API has no cancel endpoint, so no cancel tool/command is offered. Failed/stuck renders are auto-refunded by the API.
- Agent/chat mode — not exposed by the public API, so not in the toolchain.
- Nothing here publishes to npm, provisions DNS, or deploys — those are external steps (see the final section of docs/mcp.md).
Development
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Vivideo: common questions
- Is Vivideo MCP server safe?
- Yes, by our scan: it is graded A (86/100). Read the Vivideo safety report
- How do I install Vivideo?
- It runs remotely at api.vivideo.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Vivideo need an API key?
- Yes. The registry entry asks for
VIVIDEO_API_KEY,Authorization. - Is Vivideo maintained?
- The last commit was 99 days ago (2026-07-28). The latest release is v1.0.2.
- Is Vivideo up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Vivideo?
- Servers from other publishers that do the same job: SuperCMO MCP server, Sapiens Sintéticos MCP server and Veo MCP server.
- How does Vivideo compare with other Media MCP servers?
- safety score 86/100 (higher than 74% of 1,337 Media servers); tools 13 (the typical Media server has 7); tools that change things 15% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Vivideo
Same job from other publishers: the closest match first, then the best rated.
- SuperCMOMarketing media generation — image, video, voice — for AI agents. BYO keys.not reviewedEstablishedB
Sapiens SintéticosOperate your Sapiens Sintéticos AI studio: generate image, article, voice, music and video.not reviewedGrowingA- not reviewedGrowingA
- AetherwaveMusic, image, video and audio generation across top AI providers - one key, one credit pool.not reviewedGrowingB
PopNowAI image, video, music and speech generation: text-to-video, image-to-video, effects and upscaling.not reviewedGrowingA