Clipwright
# Clipwright clients
Open-source clients for [Clipwright](https://clipwright.io): an API that turns a
script into a short video of an actor speaking it. 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, and an
account opened by signing up starts with none: buy a pack at
[clipwright.io/pricing](https://clipwright.io/pricing) before the first render.
## 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).
Privacy: [clipwright.io/privacy](https://clipwright.io/privacy).
MIT License — see [LICENSE](LICENSE).
TDQS
Scored across 12 tools
Each tool targets a distinct resource/action: actor discovery vs actor creation vs actor deletion, UGC quoting/generation/polling, voice selection, uploads, and account credits. Although create_actor and make_ugc both return run_ids, their names and descriptions make the different generation targets clear, so an agent should not misselect.
All tools use snake_case verb_noun names such as list_actors, create_actor, delete_actor, quote_ugc, make_ugc, get_run, upload_image, and get_account. The get/set defaults pair and quote pair follow predictable patterns, making the naming highly consistent.
Twelve tools is well-scoped for a UGC-video and actor-management server. The surface splits naturally into actor management, video generation, voice/upload helpers, and account status without redundant or filler tools.
The core lifecycle is covered: actors can be listed, created, deleted, and configured; UGC runs can be quoted, started, and polled; images, voices, and account credits have supporting tools. Minor gaps such as no explicit cancel-run or update-actor operation are not blocking for the main workflow, so this is slightly short of a perfect 5.