FrameThrower

Biblioteca de referência cinematográfica. Pesquise fotogramas de 5.489 filmes por iluminação, característica da lente, tamanho do plano, cor e clima. Servidor remoto, quatro ferramentas, OAuth, plano gratuito.

GitHub

Documentação

Servidor MCP FrameThrower

Referências de cinema, dentro do seu agente. Conecte qualquer cliente MCP a uma biblioteca de referência cinematográfica de 5.489 filmes, indexada quadro a quadro por iluminação, caráter da lente, tamanho de plano, cor e clima.

Peça um visual na conversa e o agente volta com frames reais, creditados ao filme, diretor e diretor de fotografia.

https://framethrower.ai/api/mcp

Servidor remoto, OAuth 2.1, quatro ferramentas, sem limites de requisições, US$ 2 em créditos grátis no cadastro (sem cartão).

Início rápido

Claude (Desktop / Web)

Configurações → Conectores → Adicionar conector personalizado → cole:

https://framethrower.ai/api/mcp

Entre quando o navegador abrir. É só isso.

Cursor

Com um clique:

Ou adicione em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "framethrower": {
      "url": "https://framethrower.ai/api/mcp"
    }
  }
}

Clientes que só falam stdio

Faça a ponte com mcp-remote, que cuida do fluxo OAuth para você:

{
  "mcpServers": {
    "framethrower": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://framethrower.ai/api/mcp"]
    }
  }
}

Passos completos por cliente em docs/install.md.

As quatro ferramentas

Ferramenta	Créditos	O que faz
`search_frames`	2	Busca por conceito, clima, cor, composição ou cena, em linguagem natural
`find_by_craft`	2	Encontra frames por atributo cinematográfico — lente, tamanho de plano, estilo, cenário, horário do dia, diretor, ano
`find_similar`	2	Mais frames parecidos com um já selecionado. Este é o ciclo de refinamento
`get_frame_details`	2	Metadados completos, miniatura e link para um único frame

`search_frames`

Argumento	Tipo	Observações
`query`	string, obrigatório	ex.: `"neon-lit rainy street at night"`
`limit`	number, 1–40	padrão: 12

`find_by_craft`

Todos opcionais — combine-os para refinar.

Argumento	Tipo	Observações
`lens`	string	`"anamorphic"`, `"spherical"`, `"vintage_soft"`
`shot_size`	string	`"closeup"`, `"wide"`, `"medium"`
`visual_style`	string
`setting`	string	`"interior"` ou `"exterior"`
`time_of_day`	string	`"night"`, `"day"`
`director`	string
`year_min` / `year_max`	number	intervalo de anos
`limit`	number, 1–40	padrão: 12

`find_similar`

Argumento	Tipo	Observações
`frameId`	string, obrigatório	um id de um resultado anterior
`limit`	number, 1–40	padrão: 12

`get_frame_details`

Argumento	Tipo	Observações
`frameId`	string, obrigatório

Como deve ser usado

O servidor envia instruções de uso na conexão, então o cliente não precisa saber como se comportar. O ciclo que ele pede:

Buscar — o agente chama search_frames com o que você descreveu.
Mostrar alguns — cerca de quatro, cada um com filme, diretor e um link. Nada de despejar tudo.
Reagir — "mais como o #2", "mais frio", "mais fechado". Isso vira um find_similar naquele frame, ou um find_by_craft com atributos ajustados.
Repetir até acertar.

Cada resultado mantém um link de volta para o FrameThrower, porque a renderização de imagens inline no chat não é confiável e a galeria é onde os frames ficam do jeito que são.

Veja examples/prompts.md para conversas que funcionam.

Quanto custa

US$ 2 em créditos grátis no cadastro, sem cartão. Depois, US$ 1 = 1.000 créditos, e cada chamada de ferramenta custa 2 — então US$ 1 cobre 500 chamadas. Os créditos nunca expiram. Não há limites de requisições.

Se acabar, a ferramenta responde com uma mensagem avisando, incluindo seu saldo e onde recarregar, para que o agente possa se explicar em vez de falhar em silêncio.

O que ele retorna — e o que não retorna

As ferramentas retornam metadados, uma URL de miniatura, paletas de cores e um link direto de volta para o FrameThrower. Nunca bytes brutos de imagem.

Esta é uma ferramenta de descoberta e referência, não um canal de entrega de imagens. Os frames não são nossos para licenciar — são exibidos em resolução reduzida como referência para comentário, educação e estudo, e os direitos permanecem com seus proprietários. Veja uso pretendido.

Por que não há código de servidor aqui

O servidor MCP do FrameThrower é remoto e hospedado — você se conecta a ele, não o executa. Então este repositório é o conector: manifestos, configuração por cliente, assinaturas das ferramentas e exemplos práticos. Nada para instalar, nada para manter rodando e nenhuma chave de API para gerenciar — com OAuth, o agente atua como sua conta FrameThrower conectada.

Também disponível

API REST — 11 endpoints, sem limites de requisições. Especificação legível por máquina · docs
npm SDK — npm install framethrower-ai (código-fonte)

Mesma conta, mesmos créditos.

Sobre

O FrameThrower é o aplicativo de referência para o futuro criativo: uma das maiores bibliotecas de fotogramas de filmes da internet, acionável por uma API REST, um servidor MCP e um npm SDK. Feito por cineastas seniores e criativos de publicidade, para profissionais de cinema em atividade.

framethrower.ai · /mcp

Licença MIT.