Skip to content
@framethrower-ai

FrameThrower

The reference app for the future creative — one of the largest film still libraries on the internet, with a REST API, an MCP server and an npm SDK.
FrameThrower

FrameThrower

The reference app for the future creative.

framethrower.ai · Docs · MCP · API spec


One of the largest film still libraries on the internet — 5,489 films, indexed frame by frame on lighting key and quality, lens character, shot size, camera angle, colour palette in hex, mood and era.

Search it in plain language, from a reference image, or by colour. Then build moodboards, shot boards and exportable lookbooks — or skip the interface entirely and call it from your own software.

Every capability is reachable by machine: a REST API, an MCP server and an npm SDK, so an agent can pull references into a moodboard, a lookbook, a shot board or a production pipeline without a human in the loop.

Repositories

framethrower-mcp MCP server — four tools, OAuth 2.1, nothing to install. Works in Claude, Cursor, VS Code and any MCP client.
framethrower-sdk npm install framethrower-ai — the official JavaScript/TypeScript client.

Start in one line

npm install framethrower-ai
claude mcp add --transport http framethrower https://framethrower.ai/api/mcp
curl -X POST https://framethrower.ai/api/v1/search \
  -H "Authorization: Bearer ft_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "neon-lit rainy street at night", "limit": 5}'

What you can search on

Lighting key and quality · lens character · shot size and framing · camera angle · colour palette in hex · mood · era · time of day — alone or combined, in the words you'd brief a cinematographer in. Or drop in a reference image and get frames that match its light, colour and composition.

Every result links back to its film, director and cinematographer.

Pricing

$2 of credits free on signup, no card. Then $1 = 1,000 credits and a search costs 2 — so $1 buys 500 searches. Credits never expire, and there are no rate limits.

Out of credits returns HTTP 402 with the cost, your balance and a top-up link, so an agent can explain itself instead of failing silently.

What we return — and what we don't

Metadata, thumbnail URLs, extracted colour palettes and deep links. Never raw image bytes.

FrameThrower is a discovery and reference tool, not an image-delivery pipe. Frames are shown at reduced resolution as references for commentary, education and study; the frames are not ours to license and rights remain with their owners. Intended use →

The measurements we compute from them — colour palettes, counts, rankings — are ours, and those are published under CC BY 4.0 with attribution.

Who builds it

FrameThrower is built by senior filmmakers and ads creatives — people who have shot, cut and pitched for a living — for working film professionals. That is why the index is organised around lighting, lens and framing rather than keywords: it is the vocabulary the work is actually briefed in.

FrameThrower AI, Inc. · Delaware · contact@framethrower.ai

Popular repositories Loading

  1. framethrower-mcp framethrower-mcp Public

    MCP server for film references — connect any MCP client to a cinematography library of 5,489 films. Four tools, OAuth 2.1, $2 of credits free.

    1

  2. comfyui-framethrower comfyui-framethrower Public

    Search the FrameThrower film-still library from inside ComfyUI — cinematography reference from 5,489 films, as an IMAGE node.

    JavaScript 1

  3. framethrower-sdk framethrower-sdk Public

    Official JavaScript/TypeScript client for the FrameThrower API — a film stills database of 5,489 films, indexed frame by frame on lighting, lens, shot size, colour and mood.

    HTML

  4. .github .github Public

    Org profile

Repositories

Showing 4 of 4 repositories

Top languages

Loading…

Most used topics

Loading…