FrameThrower MCP server

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

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 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 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 frames visually/semantically similar to a given frame id (from a prior result). Use this to pull more references like one the user shortlisted.

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

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

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 the full metadata, a preview image and the FrameThrower link for a single frame id. For the full-resolution file or the depth map (camera geometry for image generation), call get_frame_image.

One frame's image at a paid size, as a link valid for an hour: "full" = the original full-resolution file (5 credits), "large" = 1280px (2), "depth" = the precomputed depth map, ControlNet-ready (2). Search results show a preview only — use this when the user wants the actual image for a deck, document, download or an image-generation pipeline.

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.

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.

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 the FrameThrower cinematography reference library by concept, mood, color, composition, or scene. Returns reference frames with film/credits metadata, a preview image and a link to view on FrameThrower. For the full-resolution file or the precomputed depth map, call get_frame_image with the frame id.

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

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.

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