Skip to content
MCP server

Refs

Search a library of measured launch videos and have your agent plan films from them

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://refs.video/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "refs": {
      "url": "https://refs.video/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media