Refs
Search a library of measured launch videos and have your agent plan films from them
- Pricing
- Freemium
- Platforms
- Web, API
- Runs
- Remotely
- Version
- 0.17.0
- Listing updated
- 2 days ago
About Refs
Refs is a freemium MCP server for design and media. It runs as a hosted remote server, so there is nothing to install locally.
Refs is a hosted reference library of launch films, each broken down shot by shot with length, camera move, shot type, palette and sound. The MCP server connects it to Claude, Claude Code, Cursor, VS Code or Codex so an agent can find examples and reuse the method rather than the footage. The videos themselves are not rehosted; each plays from its original post.
Searching is free with an account and capped at 200 searches a day. The other tools spend credits from a Pro plan's monthly allowance of 3,000: blueprints and frame sheets cost 5 each, a film plan 10, a render check 2, while storyboards and brand kits cost nothing. The site's own worked example, one film planned from three references, comes to 41 credits.
Brand tools import a brand's house style from its X handle, and a UGC scan looks for competitors' winning ads from a product link. A starter kit with Remotion and HTML templates is offered for turning a blueprint into a render.
Install
Run in a terminal
claude mcp add --transport http refs https://refs.video/mcpAdd to Settings → Connectors → Add custom connector
https://refs.video/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"refs": {
"url": "https://refs.video/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"refs": {
"type": "http",
"url": "https://refs.video/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"refs": {
"serverUrl": "https://refs.video/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"refs": {
"type": "http",
"url": "https://refs.video/mcp"
}
}
}Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- Search films
- Find films by keyword, category, tool, or AI-made.
- Formulas
- Formats distilled across many films.
- A formula
- One formula with its template prompt.
- Your collections
- Your collections and favourites.
- A collection
- Every film in a collection, ready to use as references.
- Blueprint
- Every plate, the cut list and the recipe for one film.
- Frame sheet
- One film frame by frame: the hook at 0.25 s steps and every shot.
- Plan a film
- Brief plus 1-5 references becomes a beat sheet, shot list and build prompt.
- Storyboard
- 1-4 directions with style frames and numbered panels.
- Check a render
- Scores a render against the reference with frame-exact fixes.
- Your brands
- Your Brandprint imports, with their progress.
- Brand kit
- Your brand kit and every film's blueprint.
- UGC scan
- Paste a product link to find competitors' winning UGC ads.
- Scan board
- A scan's progress and the board of winning ads.
What it does
- Film search
- Find launch films by keyword, category, tool or AI-made, each with views, cuts and pace.
- Blueprints
- Get every plate, the cut list and an edit recipe for one film.
- Frame sheets
- See a film's hook at quarter-second steps and every shot as images.
- Film planning
- Turn a brief plus one to five references into a beat sheet, shot list and build prompt.
- Render checks
- Score a render against the reference on cut timing, brightness, motion and loudness.
- Brand kit
- Store your house style as rules for planning in your own look.
- UGC scan
- Find competitors' winning UGC ads from a product link, three scans a month.
Good for
- Study what the best launch videos have in common
- Rebuild a video opening from a frame-by-frame reference
- Plan a product launch film from reference examples
- Check a finished render against a target film
- Research competitors' UGC ad styles
Pricing
Freemium, from $4 a month
Free account; Library $4/mo; Pro $10/mo (billed $120 yearly) with 3,000 credits for the MCP build tools
Prices change. Check refs.video before you buy.
Refs FAQ
Is search free?
Yes with a free Refs account, limited to 200 searches a day. Pro has no search limit.
What does Pro add?
The build tools, including blueprints, frame sheets, formulas, film plans and render checks, with 3,000 credits a month.
Which clients work?
Claude on web, desktop and mobile, Claude Code, Cursor, VS Code, Codex and other MCP-capable agents.
Does it host the videos?
No. Films play from their original posts; the agent receives measurements and blueprints.
Is Refs free?
Refs has a free plan, with paid plans for more usage or features. Paid plans start at $4 a month.
How do I add Refs to Claude Code?
Run this command in your terminal: claude mcp add --transport http refs https://refs.video/mcp
What are the best alternatives to Refs?
The closest alternatives to Refs are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to Refs

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media