Clypmint B-Roll

Clypmint B-Roll (b-roll of anything, for any agent)

A b-roll library your agent searches in plain words. Give it one API key and it gets the real shot: the person, company, product, place or event your script names. One search covers Wikimedia Commons, NASA, the Internet Archive, the Library of Congress, Openverse, and the subject's own site and YouTube channel. Web mode adds the open web, down to the exact moment inside a YouTube video. A vision model checks every shot, and every shot comes with its rights. Priced per search, from 2 cents, with no stock subscription.

Ask for the shot, not the source. You don't need to know which archive has the Apollo 11 launch, or which minute of the keynote shows the first iPhone. Send the line from your script and get the shot.

Built by Clypmint for its AI video editor, and open to every agent and every video app. Live at clypmint.com/broll.

Start with $2 of signup credit after verifying your email. Then $0.02 per licensed search or $0.06 per web search. Check current prices with the usage endpoint.

Get a key · Try it in the browser (no key) ·

Docs · Benchmark

Why it exists

Video agents are good at scripts and voices and bad at pictures. Stock shows _a_ CEO; your script names _the_ CEO. Image search gives you links with no license. And an agent can't watch a video to find the four seconds it needs.

This does the part an editor does:

1. Plan. Your agent sends the subject, the line it plays over, and its own search words. The line decides which "Apple" you mean.
2. Find. We look up what the name means on Wikidata, then search every source at once.
3. Check. A vision model scores every shot against what it must show. Wrong person, watermark, collage: dropped. In web mode a model watches the top videos and returns the 2-6 second moment.
4. Drop it in. Each image has a download_url. Each video has one command that cuts just the seconds you need, on your machine.

Two kinds of search, one key

• Licensed (the default, $0.02). Only sources whose terms allow reuse. Every shot has its license and credit line.
• Web ("rights": "any", $0.06). Also the open web: the scene from the film, the photo from yesterday's news, the moment inside a YouTube video. These shots come back marked _Not cleared_, because the owner holds the rights.

A search is only charged when it finds checked shots.

Part 1 · Using it

Quickstart

# 1. sign up and make a key ($2 signup credit after email verification): https://clypmint.com/broll/dashboard

export CLYPMINT_API_KEY=cm_live_...

2. give it to your agent (Claude Code)

claude mcp add --transport http clypmint-broll https://clypmint.com/mcp/broll \ --header "Authorization: Bearer $CLYPMINT_API_KEY"

3. try it

npx -y github:Clypmint/clypmint-broll#v1.2.1 search "Saturn V launch" --type video

Then ask your agent: _"find b-roll for every name in this script."_ Every CLI command is in USAGE.md.

Or install it as a Claude Code plugin

/plugin marketplace add Clypmint/clypmint-broll

/plugin install clypmint-broll@clypmint-broll

The plugin asks for your key once and keeps it in your system's secure store. It brings the MCP tools and the skill below.

Codex

codex plugin marketplace add Clypmint/clypmint-broll

codex plugin add clypmint-broll@clypmint-broll

The Codex plugin reads your key from CLYPMINT_API_KEY.

Cursor and other agents

Cursor ( ~/.cursor/mcp.json )

{

"mcpServers": { "clypmint-broll": { "url": "https://clypmint.com/mcp/broll", "headers": { "Authorization": "Bearer cm_live_YOUR_KEY" } } } }

Codex without the plugin ( ~/.codex/config.toml )

[mcp_servers.clypmint-broll]

url = "https://clypmint.com/mcp/broll" bearer_token_env_var = "CLYPMINT_API_KEY"

Any agent that reads skills

npx skills add Clypmint/clypmint-broll

Or copy skills/broll/SKILL.md into your agent's skills folder (Claude Code: ~/.claude/skills/broll/SKILL.md).

The MCP server is https://clypmint.com/mcp/broll, listed on the official MCP registry as com.clypmint/broll. Any MCP client can list its tools before you add a key; a search needs one.

What your agent gets

Using Claude to edit videos?

Already pointing Claude at the Internet Archive for b-roll? This searches it too, together with Wikimedia Commons, NASA, the Library of Congress, Openverse and official channels, in one call. It checks every shot and tells you what you may do with it.

Install the plugin (above), then add this to your project's CLAUDE.md once:

Whenever a line names a person, company, product, place or event, get b-roll for it with find_broll

(or plan_broll for the whole script). Send the line as context and 1-3 short keywords. Use the top shot, cut only the seconds you need with its cut_command, and put its credit line in the credits.

It works with any setup that renders files: Remotion, HyperFrames, ffmpeg or an editor's timeline. The full version, with where the files go, is examples/claude-video.

Building an AI video app?

Use it as your app's b-roll source. Two calls cover it:

• POST /api/v1/broll/search: send a subject and its line, get checked shots, best first.
• POST /api/v1/broll/plan: send a whole script, get the moments worth a cutaway, each with its shots and the words it starts on (and times, if you send word timings).

Every shot carries its source, license and credit line, so your users can publish it. You pay per search from one prepaid balance: no seats and no monthly fee. Send an Idempotency-Key and a retry returns the first answer, never billed twice. The OpenAPI spec makes a client in any language. Need more volume? Write to support@clypmint.com.

What you get back

curl https://clypmint.com/api/v1/broll/search \

-H "Authorization: Bearer $CLYPMINT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "Sam Altman", "context": "Sam Altman just walked on stage", "type": "image", "limit": 1}'

Example response at regular prices:

{

"request_id": "2b9d7f0e-6c1a-4f53-9d0e-6a1f3c8e2b41", "query": "Sam Altman", "interpreted": { "subject": "Sam Altman", "kind": "person", "entity": { "id": "Q7407093", "label": "Sam Altman", "url": "https://www.wikidata.org/wiki/Q7407093" }, "look_for": "Sam Altman walking onto a stage at a conference or event" }, "verified": true, "results": [ { "type": "image", "title": "Sam Altman speaking at TED", "shows": "Full shot of Sam Altman seated on stage at TED", "score": 9, "url": "https://upload.wikimedia.org/wikipedia/commons/0/06/Sam_Altman_speaking_at_TED.jpg", "download_url": "https://upload.wikimedia.org/wikipedia/commons/thumb/0/06/Sam_Altman_speaking_at_TED.jpg/1920px-Sam_Altman_speaking_at_TED.jpg", "orientation": "portrait", "source": { "name": "Wikimedia Commons", "page_url": "https://commons.wikimedia.org/wiki/File:Sam_Altman_speaking_at_TED.jpg" }, "license": { "name": "CC BY 2.0", "url": "https://creativecommons.org/licenses/by/2.0", "commercial_use": true, "cleared": true, "attribution": "Steve Jurvetson / CC BY 2.0 / https://commons.wikimedia.org/wiki/File:Sam_Altman_speaking_at_TED.jpg" }, "delivery": "direct" } ], "took_ms": 4810, "cached": false, "usage": { "charged_usd": 0.02, "balance_usd": 9.98, "price_usd": { "licensed": 0.02, "web": 0.06 }, "list_price_usd": { "licensed": 0.02, "web": 0.06 }, "offer": null } }

A whole script at once: each moment comes back with the exact words it starts on, and its time if you send word timings.

curl https://clypmint.com/api/v1/broll/plan \

-H "Authorization: Bearer $CLYPMINT_API_KEY" -H "Content-Type: application/json" \ -d '{"transcript": "Last week I flew to Tokyo to meet the Figma team...", "max_beats": 8}'

The full reference is at [clypmint.com/broll/docs](htt