FrameThrower

ai.framethrowerv1.0.0更新于 Oct 1, 2026

Film stills from 5,489 films, searchable by lighting, lens character, shot size, colour and mood.

已验证Streamable HTTP可网页运行Other

安装

在 SourceWeft 中

  1. 打开 控制台中的 FrameThrower，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "framethrower": {
      "type": "http",
      "url": "https://framethrower.ai/api/mcp"
    }
  }
}

README

FrameThrower MCP Server

Film references, inside your agent. Connect any MCP client to a cinematography reference library of 5,489 films, indexed frame by frame on lighting, lens character, shot size, colour and mood.

Ask for a look in conversation and the agent comes back with real frames, credited to their film, director and cinematographer.

https://framethrower.ai/api/mcp

Remote server, OAuth 2.1, four tools, no rate limits, $2 of credits free on signup (no card).

Quick start

Claude (Desktop / Web)

Settings → Connectors → Add custom connector → paste:

https://framethrower.ai/api/mcp

Sign in when the browser opens. That's it.

Cursor

One-click:

[Add to Cursor]

Or add to ~/.cursor/mcp.json:

json
{  "mcpServers": {    "framethrower": {      "url": "https://framethrower.ai/api/mcp"    }  }}

Clients that only speak stdio

Bridge with mcp-remote, which handles the OAuth flow for you:

json
{  "mcpServers": {    "framethrower": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://framethrower.ai/api/mcp"]    }  }}

Full per-client steps in docs/install.md.

The four tools

ToolCreditsWhat it does
search_frames2Search by concept, mood, colour, composition or scene, in natural language
find_by_craft2Find frames by cinematography attribute — lens, shot size, style, setting, time of day, director, year
find_similar2More frames like one already shortlisted. This is the refinement loop
get_frame_details2Full metadata, thumbnail and link for a single frame

search_frames

ArgumentTypeNotes
querystring, requirede.g. "neon-lit rainy street at night"
limitnumber, 1–40defaults to 12

find_by_craft

All optional — combine them to narrow.

ArgumentTypeNotes
lensstring"anamorphic", "spherical", "vintage_soft"
shot_sizestring"closeup", "wide", "medium"
visual_stylestring
settingstring"interior" or "exterior"
time_of_daystring"night", "day"
directorstring
year_min / year_maxnumberyear range
limitnumber, 1–40defaults to 12

find_similar

ArgumentTypeNotes
frameIdstring, requiredan id from a previous result
limitnumber, 1–40defaults to 12

get_frame_details

ArgumentTypeNotes
frameIdstring, required

How it's meant to be used

The server sends usage instructions on connect, so a client doesn't need to be told how to behave. The loop it asks for:

  1. Search — the agent calls search_frames with what you described.
  2. Show a few — about four, each with film, director and a link. Not a dump.
  3. React — "more like #2", "colder", "tighter". That becomes a find_similar on that frame, or a find_by_craft with attributes adjusted.
  4. Repeat until it's right.

Every result keeps a link back to FrameThrower, because inline image rendering in chat is unreliable and the gallery is where the frames look like themselves.

See examples/prompts.md for conversations that work.

What it costs

$2 of credits free on signup, no card. Then $1 = 1,000 credits, and each tool call costs 2 — so $1 covers 500 calls. Credits never expire. There are no rate limits.

Run out and the tool replies with a message saying so, including your balance and where to top up, so the agent can explain itself rather than failing silently.

What it returns — and what it doesn't

Tools return metadata, a thumbnail URL, colour palettes and a deep link back to FrameThrower. Never raw image bytes.

This is a discovery and reference tool, not an image-delivery pipe. The frames are not ours to license — they are shown at reduced resolution as references for commentary, education and study, and rights remain with their owners. See intended use.

Why there's no server code here

The FrameThrower MCP server is remote and hosted — you connect to it, you don't run it. So this repo is the connector: manifests, per-client setup, tool signatures and worked examples. Nothing to install, nothing to keep running, and no API key to manage — OAuth means the agent acts as your signed-in FrameThrower account.

Also available

Same account, same credits.

About

FrameThrower is the reference app for the future creative: one of the largest film still libraries on the internet, callable from a REST API, an MCP server and an npm SDK. Built by senior filmmakers and ads creatives, for working film professionals.

framethrower.ai · /mcp

MIT licensed.

来源：README.md，提交 47b3560

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v1.0.0最新Sep 16, 2026