MCP / agent access
Put the archive at your agent's workbench.
Connect once. Search specimens and retrieve blueprints from your editor.
- 01
Get a token
Create a key on your account page. It is shown once; store it as
REFS_KEYin your shell or secrets manager. Blueprint calls need Pro. - 02
Connect
Server URLhttps://refs.video/mcpterminalclaude mcp add --transport http refs https://refs.video/mcp \ --header "Authorization: Bearer $REFS_KEY"
Streamable HTTP. Bearer token in the Authorization header.
- 03
Test
Ask your agent: “Search Refs for founder launch films under 60 seconds and plan one for my product.”
Instruments / tools
| search_videos | Find specimens by keyword, category, tool, or AI-made. | 1 cr |
| get_blueprint | Every plate, the cut list and the recipe for one specimen. | 5 cr |
| list_formulas | Formats distilled across many specimens. | 1 cr |
| get_formula | One formula with its template prompt. | 5 cr |
| plan_video | Your brief + 1–5 references → beat sheet, shot list, build prompt. | 10 cr |
Pro includes 1,500 credits a month, reset on the 1st.