MCP.Market

FrameThrower MCP server

online · 100% uptime
by framethrower.ai·ai.framethrower/framethrower·v1.0.0·3 stars

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

A87/100grade A
What users say
No reviews yet
Be the first
Safety scan
A87/100

full report

Adoption
Growing

3 stars

Reviews

Write one

Nobody has reviewed FrameThrower yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

FrameThrower tools (16)

write = sends, deletes, buys or posts
  • commercials_profileFree

    The 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 most recent work — and, for directors / agencies / production companies with a public page, the researched profile (description, founded, HQ, website).

  • commercials_statsFree

    Count 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 car ads since 2015" = fields [agency], award_show Cannes Lions, industry Auto, year_min 2015.

  • find_animation_titlesFree

    Find 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 (like: "Akira"), by a LOOK (an image or frame ids — titles whose frames look like it), and/or by genre, theme, style, studio, movie/series and year. Signals combine. Returns each title with studio, director, genres, themes, its look, a synopsis, a poster, and for a look search the frames that matched.

  • find_by_craftFree

    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 this to refine a search precisely.

  • find_similarFree

    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.

  • get_animation_sequenceFree

    A 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 that covers them (run_url, with from/to seconds).

  • get_animation_titleFree

    One 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_commercialFree

    The 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 minute, when the product / brand / emotional peak / end card land), the script with timings, and the shot list (caption, tags and still per shot; with clips: true, each shot's clip too).

  • get_frame_detailsFree

    Get 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_animation_framesFree

    Find 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 watching the city lights", "two kids running through a summer field", "a tall man with a scarred face and a long black coat, rain". Narrow by title, genre, theme, style (80s cel, watercolour, neon night…), studio, movie/series and year. Each frame has a caption of what is in it, a 640px still for looking at, the full-size still, the frame id and a link. At most 3 frames per title unless per_title says otherwise.

  • search_commercial_shotsFree

    Find 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 any commercial-level filter (brand, director, agency, award show, year…). Each shot has its still, its tags and a link to the exact moment; with clips: true, also a short clip of just that shot.

  • search_commercialsFree

    Find 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, year, industry, market, tone, genre, structure, season. Without a query it lists matching spots, award winners first. Returns each spot with brand, title, year, credits, best award, logline, a still and a link to watch it.

  • search_framesFree

    Search 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.

  • similar_animation_framesFree

    More 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). by = look (composition, drawing and rendering — the default), colour (the palette) or content (what is in it). Same filters as search_animation_frames; other_titles: true keeps it to titles other than the seed frames'.

  • similar_commercial_shotsFree

    More 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.

  • similar_commercialsFree

    Commercials 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).

Public scan report

scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it

no findings
  • –Code scanremote-only server, no package to scann/a
  • Live reliabilityremote reachable in 902ms20/20
  • Tool poisoning16 tool descriptions checked15/15
  • Auth qualityopen endpoint, read-only tools10/15
  • Maintenancelast push 83 days ago12/15
  • Maintainer identityendpoint served from the registry-verified namespace domain8/10
Overall 87/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How FrameThrower compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
87/100
higher than 73% of 48,255 servers
Tools
16
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Uptime
100%
of our recent checks; the typical remote server answers 100%
Response time
371 ms
faster than 40% of 30,031 servers
GitHub stars
3
more than 80% of 28,688 servers

What its tools let an agent do: 16 read

Install FrameThrower in Claude Code, Cursor or VS Code

claude mcp add --transport http framethrower https://framethrower.ai/api/mcp
Add to Cursor

What the publisher says

From the FrameThrower repository's README, as published. We do not edit it. Read it on GitHub

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

search_frames

findbycraft

All optional — combine them to narrow.

find_similar

getframedetails

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:

findsimilar on that frame, or a findby_craft with attributes adjusted.

  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
  1. 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.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Grade history

  • 2026-11-03restoreB → Ascore 87

FrameThrower: common questions

Is FrameThrower MCP server safe?
Yes, by our scan: it is graded A (87/100). Read the FrameThrower safety report
How do I install FrameThrower?
It runs remotely at framethrower.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does FrameThrower need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is FrameThrower maintained?
The last commit was 84 days ago (2026-08-12). The latest release is v1.0.0.
Is FrameThrower up?
100% of our last 28 checks got an answer. We check remote servers about four times a day.
How does FrameThrower compare with other MCP servers?
safety score 87/100 (higher than 73% of 48,255 servers); tools 16 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.