{"id":"video.refs/refs","slug":"video-refs-refs","title":"Refs","description":"4,100 launch videos measured shot by shot. Free account to search; Pro for blueprints and plans.","version":"0.17.0","publisher":{"kind":"domain","id":"refs.video","label":"refs.video","url":"https://refs.video"},"website":"https://refs.video/connect","repository":"","remotes":[{"type":"streamable-http","url":"https://refs.video/mcp","headers":[{"description":"Sign in with your Refs account (MCP OAuth: the Claude apps, Claude Code) or send Bearer refs_… from https://refs.video/account. A free account searches; the other tools need Pro.","isSecret":true,"name":"Authorization"}]}],"packages":[],"published":"2026-11-07","updated":"2026-11-07","status":"online","auth":"","latency_ms":3511,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"search_videos","title":"Search the video library","description":"Search 4,000+ dissected top-performing videos (launch films, product demos, explainers, motion design, interactive/3D, film + music, teasers, UGC ads). Needs a Refs account; a free one is enough (the app asks the user to sign in). Cards carry the REF id, title, maker, length, aspect, still, views, measured metrics (shots, cuts per minute, voice, music) and why each works; films the account's plan ","read_only":true},{"name":"get_blueprint","title":"Get a video's blueprint","description":"The full reverse-engineered blueprint of one video: hook frame by frame, beat sheet with timestamps, shot list, style guide, voice and sound, script template, production plan, edit recipe, QA checklist, plus a runnable recipe prompt. Markdown by default; format \"json\" returns the plates, toolkit, recipe and measured timeline as one object. To see the film's frames, call get_frames. Accepts a REF i","read_only":true},{"name":"get_frames","title":"See a video frame by frame","description":"One video's labelled frame sheets as images, so you can see the reference instead of guessing from text: the hook (first 3 s at 0.25 s steps), one frame per shot, and the whole film at fixed steps where measured. sheet \"transitions\" adds every frame around each cut and in-shot change, for timing transitions to the frame. Each image follows a caption saying how its labels read. Accepts the same ids","read_only":true},{"name":"list_formulas","title":"List format formulas","description":"Formulas distilled across many videos of one format (e.g. 'the silent UI workflow', 'the delayed hardware reveal'). Returns ids, titles, summaries and their source films; fetch one with get_formula. Needs a Refs account with Pro; without one, the app asks the user to sign in. search_videos is free.","read_only":true},{"name":"get_formula","title":"Get a format formula","description":"The full cross-video formula for one format, as markdown: structure, timing ranges, what top performers share, mistakes to avoid, and a template prompt. Needs a Refs account with Pro; without one, the app asks the user to sign in. search_videos is free.","read_only":true},{"name":"list_collections","title":"List your collections","description":"Your collections on refs.video (named sets of films you saved) and your favourites, with ids and film counts. Pass an id to get_collection to read the films and use them as references. Needs a Refs account with Pro; without one, the app asks the user to sign in. search_videos is free.","read_only":true},{"name":"get_collection","title":"Get a collection of reference films","description":"Every film in a Refs collection as search cards (REF id, link, length, aspect, measured metrics, why it works). Takes a collection id or refs.video/c/… link: anyone's shared collection, or your own private one; \"favourites\" gives the films you hearted. Then use them as references: plan_video(brief, reference_ids) with up to 5 that fit the brief, get_blueprint for one film in full. Needs a Refs acc","read_only":true},{"name":"list_brands","title":"List your brand imports","description":"Your brand imports on refs.video (refs.video/saved → Brandprint): each X account you imported, with its progress and film count. Private to you. Pass an id or handle to get_brand for the brand kit and every film. Needs a Refs account with Pro; without one, the app asks the user to sign in. search_videos is free.","read_only":true},{"name":"get_brand","title":"Get your brand kit and films","description":"One of your brand imports: the brand kit (the brand's house style across all its films: palette, type, logo and end card, motion and easing, pacing and cut rhythm, camera, transitions, sound and voice, recurring formats, written as rules to follow) plus each film's blueprint summary with its id (brand:<import>:<film>) for get_blueprint and get_frames. Private to you. To make a new film in this sty","read_only":true},{"name":"plan_video","title":"Plan a video from references","description":"Give a brief (product, audience, length, platform) and 1-5 references (REF ids, links or ids, or your brand films' brand:<import>:<film> ids), and optionally one of your imported brands (brand) to plan in its house style. Returns, per reference, the plates that carry its timing and look (format, hook, beat sheet, style, sound, edit recipe) plus its recipe prompt, and the one formula that best matc","read_only":true},{"name":"storyboard","title":"Check a storyboard and lay it out as a Claude Design canvas","description":"Before anything is built, storyboard the film the way an editor does. Send the storyboard you drafted from plan_video: 1 direction for a fixed brief, 2–4 when it's open. Each direction: logline, references (REF id + the one job each does), palette, type, sound, 2–3 style frames at full look, and 3–30 numbered panels in order, each with in/out seconds, shot size, camera move, action, VO, on-screen ","read_only":true},{"name":"check_render","title":"Check a render against its reference","description":"After rendering a video from a reference, check it against that film's measured timeline and get concrete fixes: cut timing to the frame, pace, brightness curve, motion per shot, loudness for the platform, and format. First measure your render: run `node scripts/measure.mjs <file>` from the Refs starter kit (curl -sL https://refs.video/starter.zip -o refs-starter.zip && unzip refs-starter.zip; it ","read_only":true},{"name":"ugc_scan","title":"Scan a product's competitors for their winning UGC ads","description":"Paste a product page and Refs finds the UGC ads (creator-style vertical video ads on Meta and TikTok) that are working for its competitors, then takes them apart. Two steps. (1) ugc_scan(url) reads the page and returns a draft: the product (name, category, price, audience) and 5–8 suggested competitors, each with its site, Facebook Page and TikTok handle. Nothing is queued and no scan is used yet.","read_only":false},{"name":"get_ugc_scan","title":"Get a competitor UGC scan and its board","description":"One of your competitor UGC scans (from ugc_scan): its status and progress while the worker runs (queued → finding competitors → fetching ads → measuring → writing → summary → done), then the board: each competitor's winning UGC ads ranked by signal (days running, variants, reach, CTR percentile, views) with the one-line reason each won, and \"what wins in your category\" (top hooks, formats, lengths","read_only":true},{"name":"list_channels","title":"List channels","description":"Viral channels on Instagram, TikTok and YouTube, each with one video of theirs taken apart. Returns every channel's slug, handle, platform, category, followers and video count, its broken-down video with the number labelled (likes on Instagram, views elsewhere), the format it runs and how to get the full breakdown. Free for any signed-in account, 0 credits. Fetch one with get_channel(slug): Pro, 5","read_only":true},{"name":"list_templates","title":"List channels (alias)","description":"Alias of list_channels. The same answer, for clients that still use the old name. Needs a Refs account with Pro; without one, the app asks the user to sign in. search_videos is free.","read_only":true},{"name":"get_channel","title":"Get a channel","description":"One channel in full: the blueprint of its broken-down video (writing, narrator, music, visual, retention, packaging), the measured numbers, what to use (fonts, voices, assets, tools), the prompts (a series gets Part 1 and Part N), and the sheets as images: cover, hook, shots and the measured table. A format with several example videos has a hero and other references (list_channels names their ids)","read_only":true},{"name":"get_template","title":"Get a channel (alias)","description":"Alias of get_channel. The same answer, access and price, for clients that still use the old name. Needs a Refs account with Pro; without one, the app asks the user to sign in. search_videos is free.","read_only":true}],"server_info":{"name":"refs","version":"0.20.0"},"category":"image-video","tags":["web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-20","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/video-refs-refs/"}