{"name":"ai.framethrower/framethrower","title":"FrameThrower","url":"https://framethrower.ai/api/mcp","host":"framethrower.ai","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":100,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":0,"info":1},"findings":[{"rule":"mcp-version-differs","severity":"info","message":"The version it reports differs from its newest registry entry. It reports 1.2.0; the registry lists 1.0.0.","fix":"","where":[],"count":0}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2025-11-25","server_info":{"name":"FrameThrower","version":"1.2.0","title":null},"capabilities":["tools"]},"sign_in":null,"tools":[{"name":"search_frames","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["query","limit","enhance"],"required":["query"],"price_stated_usd":null},{"name":"find_by_craft","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["lens","shot_size","visual_style","setting","time_of_day","director","year_min","year_max","limit"],"required":[],"price_stated_usd":null},{"name":"find_similar","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["frameId","limit"],"required":["frameId"],"price_stated_usd":null},{"name":"get_frame_details","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["frameId"],"required":["frameId"],"price_stated_usd":null},{"name":"search_commercials","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["query","brand","director","agency","production","dp","editor","music","person","industry","market","award_show","min_award","awarded","award_year","year_min","year_max","tone","genre","structure","format","season","celebrity","max_duration","min_duration","sort","limit","offset"],"required":[],"price_stated_usd":null},{"name":"search_commercial_shots","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["query","shot_size","camera_angle","setting","time_of_day","lighting","mood","people","product_visible","logo_visible","text_on_screen","black_and_white","brand","director","agency","production","dp","industry","market","award_show","min_award","awarded","year_min","year_max","season","spot","per_spot","limit","clips"],"required":["query"],"price_stated_usd":null},{"name":"get_commercial","title":null,"description":"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).","read_only":true,"destructive":null,"inputs":["id","shots","clips"],"required":["id"],"price_stated_usd":null},{"name":"similar_commercials","title":null,"description":"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).","read_only":true,"destructive":null,"inputs":["id","by","limit","brand","industry","awarded","min_award","year_min","year_max","tone"],"required":["id"],"price_stated_usd":null},{"name":"similar_commercial_shots","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["shot_ids","shot_size","camera_angle","setting","time_of_day","lighting","mood","people","product_visible","logo_visible","text_on_screen","black_and_white","brand","industry","awarded","min_award","year_min","year_max","tone","limit","clips"],"required":["shot_ids"],"price_stated_usd":null},{"name":"commercials_profile","title":null,"description":"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).","read_only":true,"destructive":null,"inputs":["kind","name"],"required":["kind","name"],"price_stated_usd":null},{"name":"commercials_stats","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["fields","brand","director","agency","production","dp","editor","music","person","industry","market","award_show","min_award","awarded","award_year","year_min","year_max","tone","genre","structure","format","season","celebrity","max_duration","min_duration","limit"],"required":["fields"],"price_stated_usd":null},{"name":"search_animation_frames","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["query","title","genre","theme","style","studio","kind","year_min","year_max","exclude_titles","nsfw","per_title","limit","offset","clips"],"required":["query"],"price_stated_usd":null},{"name":"similar_animation_frames","title":null,"description":"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'.","read_only":true,"destructive":null,"inputs":["frame_ids","image","by","other_titles","title","genre","theme","style","studio","kind","year_min","year_max","exclude_titles","nsfw","per_title","limit","clips"],"required":[],"price_stated_usd":null},{"name":"find_animation_titles","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["brief","like","image","frame_ids","title","genre","theme","style","studio","kind","year_min","year_max","exclude_titles","nsfw","limit"],"required":[],"price_stated_usd":null},{"name":"get_animation_title","title":null,"description":"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).","read_only":true,"destructive":null,"inputs":["title","frames","clips"],"required":["title"],"price_stated_usd":null},{"name":"get_animation_sequence","title":null,"description":"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).","read_only":true,"destructive":null,"inputs":["frame_id","before","after","clips"],"required":["frame_id"],"price_stated_usd":null}],"tools_listed":16,"samples":[{"kind":"tool","name":"find_by_craft","is_error":true,"price_asked_usd":null,"networks":null},{"kind":"tool","name":"search_commercials","is_error":true,"price_asked_usd":null,"networks":null}],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2026-12-08","days_after_check":27,"issuer":"Let's Encrypt"},"registry":{"version":"1.0.0","status":200,"published_at":"2026-08-12T13:27:50.57086Z","website_url":"https://framethrower.ai/mcp","repository":"https://github.com/framethrower-ai/framethrower-mcp"},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/ai.framethrower/framethrower","badge":{"url":"https://agoranome.com/mcp-servers/ai.framethrower/framethrower/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/ai.framethrower/framethrower/badge.svg)](https://agoranome.com/mcp-servers/ai.framethrower/framethrower)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}