FrameThrower
Overview
Description from the maker (original English)
Film stills from 5,489 films, searchable by lighting, lens character, shot size, colour and mood.
What you can do with it
We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.
- Connection: Runs in the cloud
- Transport: Streamable HTTP
- Category: Games, sports, food & learning
Install
Pick the AI app you use, then copy the settings.
Passed 5/5 checks · What you ask goes through the maker’s server (framethrower.ai)
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude · about 2 min
No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1
Open Claude’s Connectors page
CustomizeConnectors
Click “+ Add” → “Add custom connector” and fill in these 2 fields
Copy each value into the field with the same name in Claude, then click Continue
Name · NameFrameThrowerRemote MCP server URL · Addresshttps://framethrower.ai/api/mcpLeave Authentication as Claude detected it, then click Add
Turn it on in a chat
+ConnectorsFrameThrower
Try it
Use FrameThrower and tell me what you can do for me, then show me one thing✓ If Claude says it is using FrameThrower or shows a FrameThrower tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with ChatGPT on business plans only
ChatGPT Business, Enterprise or Edu on the web, added by a workspace admin or owner · On Free, Plus or Pro: your ChatGPT plan cannot connect MCP yet
Open ChatGPT’s add-MCP page on the web
Plugins+Add custom MCP server
Fill in the name and address
Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin
Name · NameFrameThrowerConnection · Addresshttps://framethrower.ai/api/mcpPick FrameThrower in a chat
Start a new chat and pick FrameThrower from your plugins before typing
Try it
Use FrameThrower and tell me what you can do for me, then show me one thing✓ If ChatGPT says it is using FrameThrower or shows a FrameThrower tool in the answer, you are connected
Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Claude Code · about 2 min
No key, nothing to install
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --transport http framethrower https://framethrower.ai/api/mcpType /mcp in Claude Code
You should see FrameThrower listed as connected
Try it
Use FrameThrower and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using FrameThrower or shows a FrameThrower tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor · about 2 min
No key, nothing to install
Open the AI chat in Cursor in Agent mode
Try it
Use FrameThrower and tell me what you can do for me, then show me one thing✓ If Cursor says it is using FrameThrower or shows a FrameThrower tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code · about 2 min
No key, nothing to install
Open the AI chat in VS Code in Agent mode
Try it
Use FrameThrower and tell me what you can do for me, then show me one thing✓ If VS Code says it is using FrameThrower or shows a FrameThrower tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
Address for apps that connect over the web
https://framethrower.ai/api/mcpJSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Over the web
Claude Code
claude mcp add --transport http framethrower https://framethrower.ai/api/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"framethrower": {
"url": "https://framethrower.ai/api/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"framethrower": {
"type": "http",
"url": "https://framethrower.ai/api/mcp"
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
- Verified domain
- ✓ framethrower.ai
- Connection
- Runs in the cloud
- Transport
- streamable-http
- Latest versioni
- 1.0.0
- Categoryi
- Games, sports, food & learning
- Published to registryi
- Aug 12, 2026
- Code last changedi
- Aug 12, 2026
- Maker
- framethrower-ai
- Website
- framethrower.ai
- Registry status
- Active
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Connect over the internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Related guides
What it can do
Tool names and descriptions exactly as the server reported them on Nov 11, 2026. The maker wrote them, not us; we show them as plain text.
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 u
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.
search_commercialsFind whole COMMERCIALS (TV / online spots) in FrameThrower's ads library by idea, story or brief ("two rival neighbours outdo each other at Christmas", "a product demo told as a heist") and/or by facts: brand, director, agency, production company, DP, editor, award show and level
search_commercial_shotsFind individual SHOTS inside commercials by what is in the frame ("hand pouring beer in slow motion", "car drifting at night in the rain", "family laughing at a kitchen table"), with shot tags (size, angle, setting, time of day, lighting, mood, people, product / logo visible) and
get_commercialThe full breakdown of one commercial by id: idea, logline, tagline, product, audience, every credit by role (director, agency, production company, DP, editor, music, post, sound, VFX), every award (show, year, level, category), craft numbers (shots, average shot length, cuts per
similar_commercialsCommercials like a given one — by STORY (similar idea, tropes and tone) or by LOOK (similar shots: light, framing, palette). Accepts the same filters as search_commercials to narrow (e.g. only award winners, only another brand).
similar_commercial_shotsMore shots that look like the given shot ids (from earlier results or a shot list) — the refine loop: "more like #2". Takes the same shot tags and commercial filters to steer.
commercials_profileThe track record of a brand, director, agency, production company, DP, editor or composer in FrameThrower's ads library: how many spots, which years, who they work with (clients, agencies, directors, production companies), awards by show, typical tones and genres, their best and
commercials_statsCount and rank the ads library: how many commercials match a filter, broken down by any of brand, director, agency, production, dp, editor, music, industry, market, year, genre, structure, format, tone, trope, award_show, season. E.g. "which agencies won the most Cannes Lions for
search_animation_framesFind frames in FrameThrower's ANIMATION library — animated series and films only, never live-action (mostly anime, plus Western animation; the whole of every title, not a sample) for a scene, a moment or a CHARACTER LOOK, described in plain words: "a girl on a rooftop at dusk wat
similar_animation_framesMore ANIMATION frames (animation library only) like ones the user already has — frame ids from earlier results ("more like #2"), or ANY IMAGE: a generated frame on their canvas, an upload, a sketch (pass an http(s) URL or a data: URL, e.g. data:image/png;base64,… for a local file
find_animation_titlesFind animated SERIES and FILMS (animation library only — mostly anime, plus Western animation) that fit what the user is making — by a story brief in plain words ("a quiet coming-of-age story about two sisters in a seaside town, bittersweet, summer"), by a title it should be like
get_animation_titleOne anime series or film in depth, by slug or name: synopsis, studio and key credits, main characters, genres, themes, its look, the trailer, how many shots are indexed, titles with a similar look and a similar story, and sample frames spread across it (frames: 0–24, default 6).
get_animation_sequenceA frame in its sequence: the shots just before and after it in the same episode / film, in order, each with its still and caption — to see how a moment is built, or to lay a beat out across several canvas panels. With clips: true, each shot's clip plus the continuous "run" video
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified against the domain framethrower.ai (the registry checks domain ownership)
- ✓ Pass
Still maintained
Code last changed 3 months ago
- ✓ Pass
Has a licence
Uses MIT
- ✓ Pass
Endpoint responds
Responded in 310 ms (HTTP 200)
- – Not applicable
Sign-in with OAuth
No sign-in needed
- ✓ Pass
No hidden instructions in tool descriptions
Read 16 tool descriptions and found no hidden instructions to the AI
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Games, sports, food & learningi
- More stars than 92% of the other 1450 servers in this category
- Published to the registry more recently than 20% of the other 1450 servers in this category
- Basic checks equal to or better than 100% of the other 1450 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is FrameThrower safe?
It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.
Is it still maintained?
The GitHub repo last changed 3 months ago, and the latest version (1.0.0) reached the registry 3 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT Business and above.
What can I use instead?
In the same category: Honcho, ShipSwift, Pm Claude Skills
Alternatives
Servers in the same category from other makers, sorted by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
ShipSwift
40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP.
Pm Claude Skills
1310 professional Agent Skills + workflow recipes — searchable & fetchable over MCP.
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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:
Or add to ~/.cursor/mcp.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:
{
"mcpServers": { "framethrower": { "command": "npx", "args": ["-y", "mcp-remote", "https://framethrower.ai/api/mcp"] } } }
Full per-client steps in docs/install.md.
The four tools
| Tool | Credits | What it does |
|---|---|---|
search_frames | 2 | Search by concept, mood, colour, composition or scene, in natural language |
find_by_craft | 2 | Find frames by cinematography attribute — lens, shot size, style, setting, time of day, director, year |
find_similar | 2 | More frames like one already shortlisted. This is the refinement loop |
get_frame_details | 2 | Full metadata, thumbnail and link for a single frame |
search_frames
| Argument | Type | Notes |
|---|---|---|
query | string, required | e.g. "neon-lit rainy street at night" |
limit | number, 1–40 | defaults to 12 |
find_by_craft
All optional — combine them to narrow.
| Argument | Type | Notes |
|---|---|---|
lens | string | "anamorphic", "spherical", "vintage_soft" |
shot_size | string | "closeup", "wide", "medium" |
visual_style | string | |
setting | string | "interior" or "exterior" |
time_of_day | string | "night", "day" |
director | string | |
year_min / year_max | number | year range |
limit | number, 1–40 | defaults to 12 |
find_similar
| Argument | Type | Notes |
|---|---|---|
frameId | string, required | an id from a previous result |
limit | number, 1–40 | defaults to 12 |
get_frame_details
| Argument | Type | Notes |
|---|---|---|
frameId | string, 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:
- Search — the agent calls
search_frameswith what you described. - Show a few — about four, each with film, director and a link. Not a dump.
- React — "more like #2", "colder", "tighter". That becomes a
find_similaron that frame, or afind_by_craftwith attributes adjusted. - 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
- REST API — 11 endpoints, no rate limits. Machine-readable spec · docs
- npm SDK —
npm install framethrower-ai(source)
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.
MIT licensed.