FrameThrower MCP
Encontre fotogramas de filmes, capturas de tela de filmes e referências de cinematografia dentro de assistentes de IA para inspiração, aprendizado e produção de filmes mais rápida.
Documentação
Conecte um agente
OAuth 2.1 — seu cliente abre um login do FrameThrower e não há chave para colar. Grátis para começar, medido contra seu saldo de créditos.
Introdução
O servidor MCP FrameThrower MCP dá a qualquer cliente MCP acesso de busca a uma biblioteca de referência cinematográfica de 5.489 filmes — indexada quadro a quadro por iluminação, caráter de lente, tamanho de plano, cor e clima. Peça um visual em conversa e o agente retorna com quadros reais, creditados ao filme, diretor e diretor de fotografia.
URL do servidor
https://framethrower.ai/api/mcp
OAuth 2.1 · quatro ferramentas · sem limites de taxa · instruções de configuração por cliente
Conecte-o
1
Adicione-o como um servidor MCP remoto
Nas configurações de conexão do seu cliente, adicione https://framethrower.ai/api/mcp. Pela CLI do Claude Code, isso é um único comando:
claude mcp add --transport http framethrower https://framethrower.ai/api/mcp
2
Entre
A autenticação é OAuth 2.1 — seu cliente abre um login do FrameThrower e não há chave para colar. Depois disso, o agente age como você, com o mesmo acesso de referência que sua conta tem.
3
Peça um visual
O servidor envia suas próprias instruções de uso ao conectar, então o cliente não precisa ser instruído sobre como se comportar. Peça referências para uma cena e ele busca, mostra algumas e refina com base no que você reage.
Clientes para os quais isso está configurado e documentado:
Como um agente usa isso
O servidor envia instruções de uso ao conectar, então um cliente não precisa ser instruído sobre como se comportar. O formato que ele pede é: buscar, mostrar um conjunto pequeno — cerca de quatro — com filme, diretor e um link cada, e então refinar com base no que o usuário reage. Alguém dizendo "mais como o #2, mais frio" vira uma chamada find_similar naquele quadro, ou uma find_by_craft com os atributos ajustados.
Cada resultado carrega um link de volta para o FrameThrower, porque a renderização inline de imagens em chat é pouco confiável e a galeria é onde os quadros realmente se parecem com eles mesmos.
Preços
O servidor MCP está incluído no plano gratuito. Uma conta nova recebe $2 em créditos, sem cartão, e pode conectar e começar a chamar ferramentas imediatamente — não há plano para fazer upgrade para obter acesso. O uso é medido por chamada, e você compra mais créditos quando quiser mais chamadas.
Every tool call 2 créditos
search_frames, find_by_craft, find_similar e get_frame_details custam o mesmo.
$1 1.000 créditos
Então $1 cobre 500 chamadas de ferramenta. Créditos nunca expiram.
Top up pacotes de $20
Em Configurações → Cobrança, em múltiplos inteiros.
Não há limites de taxa.
Se acabar, a ferramenta responde com uma mensagem dizendo isso, incluindo o saldo e onde recarregar — um agente pode ler isso e informar seu usuário, em vez de falhar silenciosamente.
search_frames
FERRAMENTA search_frames 2 créditos por chamada
Busque a biblioteca por conceito, clima, cor, composição ou cena, em linguagem natural.
query stringobrigatório
ex.: neon-lit rainy street at night.
limit número
1–40. Padrão: 12.
find_by_craft
FERRAMENTA find_by_craft 2 créditos por chamada
Encontre quadros por atributos específicos de cinematografia. Todos opcionais — combine-os para refinar. Pelo menos um é obrigatório, ou a ferramenta pede um em vez de retornar a biblioteca inteira.
lens string
anamorphic, spherical, vintage_soft
shot_size string
closeup, wide, medium
visual_style string
ex.: noir, naturalistic, stylized
setting string
interior ou exterior
time_of_day string
night, day
director string
Nome completo, ex.: Denis Villeneuve.
year_min / year_max número
Faixa de anos.
limit número
1–40. Padrão: 12.
find_similar
FERRAMENTA find_similar 2 créditos por chamada
Traga mais quadros parecidos com um que o usuário já selecionou. Este é o loop de refinamento, e a ferramenta que a resposta "mais como aquele" deve usar.
frameId stringobrigatório
Um id de um resultado anterior.
limit número
1–40. Padrão: 12.
get_frame_details
FERRAMENTA get_frame_details 2 créditos por chamada
Metadados completos, miniatura, mapa de profundidade e link para um único quadro.
frameId stringobrigatório
Um id de um resultado anterior.
O que retorna
Cada ferramenta retorna quadros como texto que um agente pode citar: o filme com seu ano, diretor e diretor de fotografia, os atributos técnicos por trás do plano, uma URL de miniatura, a URL da imagem em resolução total e um link para o quadro no FrameThrower. Além de um link para a mesma busca como galeria, para quando o leitor quiser continuar manualmente.
Cada quadro também carrega um mapa de profundidade — em tons de cinza, com as mesmas dimensões do quadro, pré-computado para todos os 410.000 deles. Um agente construindo um plano pode entregar isso diretamente a um ControlNet de profundidade para manter a composição e a geometria de câmera de uma referência enquanto muda todo o resto. Não custa créditos extras e não precisa de chamada adicional; a linha está simplesmente lá no resultado.
Nenhum byte de imagem, nunca. Esta é uma ferramenta de descoberta e referência, não um canal de entrega de imagens — os quadros não são nossos para licenciar, e os direitos permanecem com seus proprietários. Veja a Política de Uso Pretendido.
API REST também
O servidor MCP são quatro ferramentas sobre a mesma biblioteca que uma API REST de onze endpoints alcança — e o lado REST tem as três que as ferramentas não têm: busca por imagem, busca por cor e o catálogo de filmes. Mesma conta, mesmos créditos.
npm install framethrower-ai
Perguntas frequentes
O que é o servidor MCP FrameThrower MCP?
Um servidor MCP (Model Context Protocol) em https://framethrower.ai/api/mcp que dá a um agente de IA acesso de busca a uma biblioteca de referência cinematográfica de 5.489 filmes. Quatro ferramentas: search_frames, find_by_craft, find_similar e get_frame_details. Conecte-o no Claude, Cursor ou qualquer cliente MCP e o agente pode encontrar referências reais de filmes no meio da conversa.
Como conecto?
Adicione https://framethrower.ai/api/mcp como um servidor MCP remoto nas configurações de conexão do seu cliente. A autenticação é OAuth 2.1 — seu cliente abre um login do FrameThrower, e depois disso o agente age como você, com o mesmo acesso de referência que sua conta tem. O Cursor suporta um link de instalação com um clique.
Quanto custa?
Está incluído no plano gratuito — não há nível para fazer upgrade para obter acesso. Uma conta nova recebe $2 em créditos, sem cartão. Cada chamada de ferramenta custa 2 créditos e $1 = 1.000 créditos, então $1 cobre 500 chamadas de ferramenta, e você compra mais créditos por uso quando quiser mais chamadas. Créditos nunca expiram e não há limites de taxa. Quando um saldo acaba, a ferramenta retorna uma mensagem dizendo isso em vez de falhar silenciosamente.
Ele retorna imagens?
Nenhum byte de imagem, nunca. As ferramentas retornam metadados, uma URL de miniatura e um link profundo de volta ao FrameThrower. É uma ferramenta de descoberta e referência, não um canal de entrega de imagens — os quadros não são nossos para licenciar, e os direitos permanecem com seus proprietários.
Há também uma API REST?
Sim — 11 endpoints com autenticação por token de portador e sem limites de taxa, além de um SDK npm (npm install framethrower-ai). A especificação legível por máquina está em framethrower.ai/api/v1 e a documentação está em framethrower.ai/developers. Mesmos créditos, mesma conta.
Mais: configuração por cliente · documentação da API · o banco de dados de fotos