FrameThrower — Claude Code MCP server: what it does, how to install
Remote MCP server to pull cinematography stills from 5,489 films directly into agent conversations. Filters by lighting, lens, palette, and shot scale.
claude mcp add --transport http framethrower https://framethrower.ai/api/mcpWhat FrameThrower does
FrameThrower links coding assistants to a searchable film archive through https://framethrower.ai/api/mcp. It offers four tools: natural-language scene exploration with search_frames, parameter filtering with find_by_craft, similarity matching via find_similar, and record inspection using get_frame_details. Browser authentication handles permissions over OAuth 2.1, eliminating API token configuration.
The remote endpoint returns metadata, thumbnail URLs, color schemes, and direct links. It never supplies raw image files. You must click through to the web gallery to inspect scenes at original fidelity. New registrations receive $2 in starter credits with no credit card required. Each tool execution uses 2 credits, giving 500 queries per dollar. Clients restricted to stdio communication depend on mcp-remote to bridge the HTTP connection.
What it helps with
- find cinematography stills filtered by lens type, shot scale, and daytime
- build visual moodboards from real movies inside an agent chat
- discover matching film references from an existing frame identifier
- retrieve lighting metadata and color palettes for specific scenes
Example prompts for the agent
- Search FrameThrower for wide anamorphic night shots with neon lighting
- Find similar frames to frame ID ft_8921 with a tighter crop
- Look up exterior daylight scenes directed in the 1970s using warm palettes
How to install FrameThrower
Platform CLI: remote server
claude mcp add --transport http framethrower https://framethrower.ai/api/mcpPlatform CLI: remote server
codex mcp add framethrower --url https://framethrower.ai/api/mcpConfig file
{
"mcpServers": {
"framethrower": {
"url": "https://framethrower.ai/api/mcp"
}
}
}Config file
{
"servers": {
"framethrower": {
"type": "http",
"url": "https://framethrower.ai/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http framethrower https://framethrower.ai/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FrameThrower
How do I install FrameThrower in Claude Code?
Run claude mcp add --transport http framethrower https://framethrower.ai/api/mcp. Complete the OAuth sign-in when your browser opens.
What does FrameThrower do?
It queries an indexed catalogue of 5,489 movies for visual references based on lighting, lenses, color, and framing. The assistant receives previews, palettes, and director credits directly in chat.
Does FrameThrower return high-resolution image files?
No, queries deliver thumbnail URLs, color palettes, and links rather than original graphic files. Film rights remain with creators, making the tool a reference index rather than an asset host.
