Clipwright
# Clipwright clients
Open-source clients for [Clipwright](https://clipwright.io/?ref=github): an API that turns a
script into a short video of an actor speaking it, or a script or a short brief
into a faceless video without an on-camera presenter: narration over an opening
animated clip and image scenes, ending with the narration (select 30–90 seconds;
it runs 25 seconds or more and up to a quarter past the selection, never past 90). Your agent quotes the price for free,
starts the render, and gets a video URL back. Clipwright returns the
file; it does not publish anywhere.
| Package | What it is |
|---|---|
| [`@clipwright/mcp-server`](https://www.npmjs.com/package/@clipwright/mcp-server) | MCP server over stdio for Claude Code, Claude Desktop, Cursor, Cline and any other MCP host |
| [`@clipwright/cli`](https://www.npmjs.com/package/@clipwright/cli) | command-line client (`clipwright`, `clipwright-cli`) |
| [`@clipwright/sdk`](https://www.npmjs.com/package/@clipwright/sdk) | TypeScript client |
| [`@clipwright/core`](https://www.npmjs.com/package/@clipwright/core) | shared request and response schemas (zod) |
## MCP server in one line
```bash
claude mcp add clipwright -e CLIPWRIGHT_API_KEY=cw_... -- npx -y -p @clipwright/mcp-server clipwright-mcp
```
Put your own key from [app.clipwright.io/api-keys](https://app.clipwright.io/api-keys)
in place of `cw_...`. It needs Node.js 20 or newer. Other hosts, the tool list and
the environment variables: [`packages/mcp-server/README.md`](packages/mcp-server/README.md).
Quotes, voices, actors and the balance are free. Renders spend credits: an
account opened by signing up starts with 420 trial credits, enough for one
90-second faceless video. Buy more at
[clipwright.io/pricing](https://clipwright.io/pricing?ref=github).
## Build from source
```bash
pnpm install
pnpm -r build
```
This repository mirrors the client packages of the Clipwright monorepo; each
release is synced here from there. Documentation: [clipwright.io/docs](https://clipwright.io/docs?ref=github).
Privacy: [clipwright.io/privacy](https://clipwright.io/privacy).
MIT License — see [LICENSE](LICENSE).
TDQS
Scored across 17 tools
The quote_X / make_X pairing and the run-centric tools (get_run, get_run_shots, revise_run) give each tool a fairly clear role. The main risk is make_ugc vs make_faceless, which both start video runs, but the descriptions clearly separate lip-synced UGC from faceless videos. Distinctions are otherwise solid.
Nearly every tool follows a consistent verb_noun snake_case pattern (get_account, make_ugc, quote_revision, list_voices, create_actor, delete_actor, set_actor_defaults). The quote_* and make_* families are parallel and predictable, making the surface easy to navigate.
17 tools is slightly heavy but justified by the four quote/make pairs plus run status, actor management, upload and defaults. Each tool maps to a real pipeline step, though get/set_actor_defaults for an explicitly inert stored setting is arguably marginal.
Core generation, quoting, polling, revision and actor create/list/delete are covered well, including the uncommon quote-first pattern. Notable gaps remain: no way to list or cancel runs/history, no actor update, and no media lifecycle management beyond storage-expiry fields, which agents cannot act on.