Your coding agent writes the script; Clipwright renders a short vertical video of an actor speaking it, 1080×1920 by default. It also makes faceless videos of up to 90 seconds from a script or a short brief: narration over an opening animated clip and image scenes, with no on-camera presenter. The agent asks for a free quote before it spends anything, and whatever the API cannot honor comes back in warnings[] instead of being dropped silently.

The agent gets a run_id at once and polls until the video URL is ready. Clipwright returns the file; it does not publish anywhere. Quotes, voices, actors and the account 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.

Install

claude mcp add clipwright -e CLIPWRIGHT_API_KEY=cw_... -- npx -y -p @clipwright/mcp-server clipwright-mcp

Put your own key in place of cw_.... The command is one line and gives the shell nothing to expand, so bash, zsh and PowerShell run it alike. It needs Node.js 20 or newer.

Any MCP host works — the server speaks JSON-RPC over stdio.

Environment

Variable	Required	Meaning
`CLIPWRIGHT_API_KEY`	yes	Your `cw_*` token. The process exits immediately without it.
`CLIPWRIGHT_CLIENT_ID`	recommended	Identifies this installation and enters the idempotency key, so two installations never collapse into one run. Left unset, the server keeps one in `~/.clipwright/client-id`, which suits a single laptop. Set it yourself where a home directory is shared, cloned or read-only — containers, CI, copied images — as `SKILL.md` §2 explains.
`CLIPWRIGHT_API_URL`	no	Defaults to the hosted API.

Tools

list_voices — voices for voice: the presets, the thirty voices of the speech model gemini-3.8-flash-tts and the catalog for make_ugc, with filters by language, gender, age, use case and model, and a short audio sample where the voice has one. The seventeen narration voices of make_faceless are listed with skill: "make_faceless". Free, spends no credits.
list_actors — ready-made faces with stable ids and verified formats. Free.
quote_ugc — estimated duration and price, plus a warning when make_ugc with the same input would be refused for money or access. Free.
get_account — balance, debt and holds of the account. Free.
make_ugc — renders a clip; this is the call that costs money. Returns a run_id immediately instead of blocking, because a render takes minutes.
get_run — status of a run. Free; poll it every few seconds.
get_run_shots — the shots of a finished video: the span, kind, description and preview link of each, with the narration words and their timing. Free and read-only. A run with no shots to show answers with the reason instead.
quote_revision — price of a revision of a faceless video: what it would change and what it costs. Free.
revise_run — starts a revision: a new run that renders the video again with the shots you change; this costs money. Pass changes (a shot and what to generate for it) or the whole edited document. A revision that delivers is charged its quoted total; one that fails is charged nothing, even when its paid work was already done. An identical request returns the same run; attempt starts a second one on purpose. Returns a run_id immediately; poll get_run until succeeded.
upload_image — a local PNG/JPEG → signed https url to pass as image. Free; 20 per day, the url lives 24 hours. Set aspect_ratio explicitly afterwards.
quote_actor — price of a personal actor before creating one. Free.
create_actor — creates a personal actor from a description; this costs money. Each requested format is a separate charged image. Returns a run_id immediately; poll get_run until succeeded, then pass created_actor.actor_id to make_ugc as actor_id.
quote_faceless — price of a faceless video before making one. Free.
make_faceless — makes a faceless video from your script or from a short brief; this costs money. You pick 30 to 90 seconds; the video ends with its narration, from 25 seconds to a quarter past your pick (never past 90), and costs at most the quote. Narration plays over an opening animated clip and image scenes, with captions on by default. voice picks the narration voice by name. Returns a run_id immediately; poll get_run until succeeded.
delete_actor — removes a personal actor of this account. Videos already made with it stay as they are. Free.
get_actor_defaults, set_actor_defaults — read and save an actor's B-roll default. It is stored only: today's talking-actor videos do not use it. Free.

Call quote_ugc before make_ugc: the quote is where the contract tells you what it will and will not honor. Anything the API cannot deliver comes back in warnings[] rather than being dropped silently, and unsupported fields are rejected up front instead of being accepted and ignored.

Bumping the attempt field starts a new paid render. It is the way to retry a failed run on purpose, not a free refresh. For faceless videos attempt belongs to make_faceless: a quote takes none, and quote_faceless refuses it.

SKILL.md ships inside the package with the full operating instructions, and CHANGELOG.md next to it says what changed in each release and what was removed.

Privacy

The server sends your script or brief, chosen options and any uploaded image to the Clipwright API to quote and render the video. How that data is handled: clipwright.io/privacy. Documentation: clipwright.io/docs.