FrameThrower

FrameThrower is the world's largest library of film stills for inspiration, learning, and making movies faster.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Search Frames: Search the FrameThrower cinematography reference library by concept, mood, color, composition, or scene. Returns reference frames with film/credits metadata, a preview thumbnail, the fu
  • Find By Craft: Find frames by specific cinematography craft attributes — lens character, shot size, visual style, setting, time of day, director, or year range. All optional; combine to narrow. Use th
  • Find Similar: Find frames visually/semantically similar to a given frame id (from a prior result). Use this to pull more references like one the user shortlisted.

What data it sees

Do you need an account

No: the server works without sign-in

FrameThrower is the world's largest library of film stills for inspiration, learning, and making movies faster. Find movie screenshots and cinematography references with AI-powered visual search. Explore lighting, composition, colour and shot size, then organise your references into lookbooks and export PDF boards for pitches and production.

The FrameThrower MCP server connects Claude, ChatGPT, Cursor and other MCP clients to film references through four tools: search_frames, find_by_craft, find_similar and get_frame_details. Search by mood, composition and cinematographic craft, discover similar frames, and retrieve frame metadata and links.

Connect using OAuth 2.1 at https://framethrower.ai/api/mcp . Setup and documentation: https://framethrower.ai/mcp . Included in the free plan, with usage metered against your credit balance.

How to connect

How to connect FrameThrower to Claude

The server address to paste into Claude settings:

https://framethrower--leo-5n21.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect FrameThrower to ChatGPT

The server address to paste into ChatGPT settings:

https://framethrower--leo-5n21.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect FrameThrower to Cursor

The server address to paste into Cursor settings:

https://framethrower--leo-5n21.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (4)

Raw names from tools/list. Only developers need these.

search_framesSearch the FrameThrower cinematography reference library by concept, mood, color, composition, or scene. Returns reference frames with film/credits metadata, a preview thumbnail, the full-resolution image URL (use this one for slide decks and documents), a precomputed DEPTH MAP url (greyscale, same dimensions as the frame — pass it straight to a depth ControlNet or any image-to-image pipeline that wants geometry), and a link to view on FrameThrower.
find_by_craftFind frames by specific cinematography craft attributes — lens character, shot size, visual style, setting, time of day, director, or year range. All optional; combine to narrow. Use this to refine a search precisely.
find_similarFind frames visually/semantically similar to a given frame id (from a prior result). Use this to pull more references like one the user shortlisted.
get_frame_detailsGet the full metadata + preview thumbnail + full-resolution image URL + depth map URL + link for a single frame id. The depth map is precomputed and free — use it when the user is generating images and needs the composition or camera geometry of this frame.