Skip to content
Back to search

clipmivo-tools

ClipmivoAI video generation tools: REST API, CLI, local MCP server and Agent Skill.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/barneyd66--clipmivo-tools/badge.svg)](/listings/barneyd66--clipmivo-tools)

HTML

<a href="/listings/barneyd66--clipmivo-tools"><img src="/api/listings/barneyd66--clipmivo-tools/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requires Node.js 22+ and npm. Published downloads are hosted in GitHub Releases; these commands do not depend on an npm registry listing:

npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-cli-0.2.7.tgz
npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-mcp-0.1.8.tgz
clipmivo --version
clipmivo-mcp --version

Set `CLIPMIVO_API_KEY` using your shell or secret manager. Never put a real key into this repository. For development:

git clone https://github.com/BarneyD66/clipmivo-tools.git
cd clipmivo-tools
npm ci
npm test
node cli/bin/clipmivo.mjs models --json

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 95 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # ClipmivoAI developer tools
  2. Create AI videos through the ClipmivoAI API, CLI, local MCP server or agent Skill. All clients use **https://clipmivoai.com/api/v1**, your scoped API key and your ClipmivoAI account balance.
  3. English · [简体中文](docs/README.zh-CN.md) · [Website](https://clipmivoai.com) · [API guide](docs/API.md) · [OpenAPI](docs/openapi.json)
  4. ## Choose your interface
  5. | Interface | Start here |
  6. | --- | --- |
  7. | REST API | [Authentication, quotes and task submission](docs/API.md) |
  8. | CLI | [Install and use the CLI](cli/README.md) |
  9. | MCP | [Connect a local stdio server](mcp/README.md) |
  10. | Agent Skill | [clipmivo-video](skills/clipmivo-video/SKILL.md) |
  11. Sign in at [ClipmivoAI](https://clipmivoai.com/?section=api), create a scoped key in the API / CLI (Developer) workspace and add credits through the website. Read operations require `video:read`, quotes and generation require `video:write`, and media uploads require `files:write`. API requests create video tasks; they do not purchase credit top-ups.
  12. ## Install
  13. Requires Node.js 22+ and npm. Published downloads are hosted in GitHub Releases; these commands do not depend on an npm registry listing:
  14. ```sh
  15. npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-cli-0.2.7.tgz
  16. npm install -g https://github.com/BarneyD66/clipmivo-tools/releases/download/v0.1.1/clipmivo-mcp-0.1.8.tgz
  17. clipmivo --version
  18. clipmivo-mcp --version
  19. ```
  20. Set `CLIPMIVO_API_KEY` using your shell or secret manager. Never put a real key into this repository. For development:
  21. ```sh
  22. git clone https://github.com/BarneyD66/clipmivo-tools.git
  23. cd clipmivo-tools
  24. npm ci
  25. npm test
  26. node cli/bin/clipmivo.mjs models --json
  27. ```
  28. ## First video
  29. ```sh
  30. clipmivo models --json
  31. clipmivo balance --json
  32. clipmivo quote --file examples/request.json --json
  33. ```
  34. Review the current quote and confirm your spending limit. Follow the [CLI quote confirmation example](cli/README.md#confirm-a-quote-before-submission) to add `quoted_credits` to a separate request file, then submit:
  35. ```sh
  36. clipmivo generate --file quoted-request.json --idempotency-key my-first-shot-001 --wait --timeout 600 --json
  37. clipmivo get TASK_ID --json
  38. clipmivo download TASK_ID --output result.mp4 --json
  39. ```
  40. Keep the same confirmed request and idempotency key after an uncertain submission. A wait timeout is not a failed video; resume status queries instead of creating another task. Model options and prices can change: use live model discovery and quotes.
  41. ## Credit billing and your application
  42. Show `credits_to_hold` directly as Credits; do not multiply an API credit quote by 100. Credits are reserved before generation, then settled using actual usage where applicable. Unused reserved credits return to the balance. The reference conversion is 100 Credits = US$1; top-ups are purchased separately on the website.
  43. For a customer-facing app, keep the ClipmivoAI key on your server. Keys on one account share its balance and account-level resources; they are not isolated reseller subaccounts. See [application integration](docs/APPLICATIONS.md).
  44. ## MCP
  45. Configure a client that supports local stdio MCP:
  46. ```json
  47. {
  48. "mcpServers": {
  49. "clipmivo": {
  50. "command": "clipmivo-mcp",
  51. "env": {
  52. "CLIPMIVO_API_KEY": "YOUR_SCOPED_API_KEY",
  53. "CLIPMIVO_FILES_DIR": "/absolute/path/to/video-files"
  54. }
  55. }
  56. }
  57. }
  58. ```
  59. Store the real key in your client's secret settings. On Windows use an existing directory such as `C:/Users/you/Videos/Clipmivo`; see the [MCP guide](mcp/README.md) if your client cannot resolve command shims. This is a local server, not a hosted MCP OAuth endpoint.
  60. ## Skill
  61. Copy `skills/clipmivo-video` into the skill directory supported by your agent. For Codex, use `~/.codex/skills/clipmivo-video`. Restart or reload skills, then ask:
  62. > Use $clipmivo-video to create a video of a paper boat on a pond. Maximum generation spend: 25 Credits.
  63. The Skill can use the installed MCP or CLI. It preserves existing budget authorization and requires a valid quote before paid submission. Installing the Skill does not create an API key or grant credits.
  64. ## Support
  65. Use GitHub issues for reproducible client bugs without credentials or private media. Account, payment and billing questions: **contact@clipmivoai.com**. Service use remains subject to the website's terms and privacy policy.
  66. This repository contains public client tools and documentation, not the website backend.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.