FrameThrower

FrameThrower MCP Server

Referencias cinematográficas, dentro de tu agente. Conecta cualquier cliente MCP a una biblioteca de referencia cinematográfica de 5,489 películas, indexada fotograma a fotograma por iluminación, carácter de lente, tamaño de plano, color y estado de ánimo.

Pide un look en la conversación y el agente responde con fotogramas reales, acreditados a su película, director y director de fotografía.

https://framethrower.ai/api/mcp

Servidor remoto, OAuth 2.1, cuatro herramientas, sin límites de tasa, $2 de créditos gratis al registrarse (sin tarjeta).

---

Inicio rápido

Claude (Escritorio / Web)

Configuración → Conectores → Añadir conector personalizado → pega:

https://framethrower.ai/api/mcp

Inicia sesión cuando se abra el navegador. Eso es todo.

Cursor

Un clic:

O añade a ~/.cursor/mcp.json:

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

Clientes que solo hablan stdio

Puente con mcp-remote, que maneja el flujo OAuth por ti:

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

Pasos completos por cliente en docs/install.md.

---

Las cuatro herramientas

Herramienta	Créditos	Qué hace
search_frames	2	Busca por concepto, estado de ánimo, color, composición o escena, en lenguaje natural
find_by_craft	2	Encuentra fotogramas por atributo cinematográfico — lente, tamaño de plano, estilo, entorno, momento del día, director, año
find_similar	2	Más fotogramas similares a uno ya preseleccionado. Este es el bucle de refinamiento
get_frame_details	2	Metadatos completos, miniatura y enlace para un solo fotograma

search_frames

Argumento	Tipo	Notas
query	string, obligatorio	p. ej. "neon-lit rainy street at night"
limit	number, 1–40	por defecto 12

find_by_craft

Todos opcionales — combínalos para acotar.

Argumento	Tipo	Notas
lens	string	"anamorphic", "spherical", "vintage_soft"
shot_size	string	"closeup", "wide", "medium"
visual_style	string
setting	string	"interior" o "exterior"
time_of_day	string	"night", "day"
director	string
year_min / year_max	number	rango de años
limit	number, 1–40	por defecto 12

find_similar

Argumento	Tipo	Notas
frameId	string, obligatorio	un id de un resultado anterior
limit	number, 1–40	por defecto 12

get_frame_details

Argumento	Tipo	Notas
frameId	string, obligatorio

---

Cómo se pretende usar

El servidor envía instrucciones de uso al conectarse, para que un cliente no necesite que le digan cómo comportarse. El bucle que pide:

1. Buscar — el agente llama a search_frames con lo que describiste.
2. Mostrar algunos — unos cuatro, cada uno con película, director y un enlace. No un volcado.
3. Reaccionar — "más como el #2", "más frío", "más cerrado". Eso se convierte en un find_similar sobre ese fotograma, o en un find_by_craft con atributos ajustados.
4. Repetir hasta que esté bien.

Cada resultado mantiene un enlace de vuelta a FrameThrower, porque la representación de imágenes en línea en el chat no es fiable y la galería es donde los fotogramas se ven como son.

Consulta examples/prompts.md para conversaciones que funcionan.

---

Cuánto cuesta

$2 de créditos gratis al registrarse, sin tarjeta. Luego $1 = 1,000 créditos, y cada llamada a herramienta cuesta 2 — así que $1 cubre 500 llamadas. Los créditos nunca caducan. No hay límites de tasa.

Si se agotan, la herramienta responde con un mensaje que lo indica, incluyendo tu saldo y dónde recargar, para que el agente pueda explicarse en lugar de fallar silenciosamente.

---

Qué devuelve — y qué no

Las herramientas devuelven metadatos, una URL de miniatura, paletas de color y un enlace profundo de vuelta a FrameThrower. Nunca bytes de imagen en bruto.

Esta es una herramienta de descubrimiento y referencia, no un conducto de entrega de imágenes. Los fotogramas no son nuestros para licenciar — se muestran a resolución reducida como referencias para comentario, educación y estudio, y los derechos permanecen con sus propietarios. Ver uso previsto.

---

Por qué no hay código de servidor aquí

El servidor MCP de FrameThrower es remoto y alojado — te conectas a él, no lo ejecutas. Así que este repositorio es el conector: manifiestos, configuración por cliente, firmas de herramientas y ejemplos trabajados. Nada que instalar, nada que mantener en ejecución, y ninguna clave API que gestionar — OAuth significa que el agente actúa como tu cuenta de FrameThrower con sesión iniciada.

---

También disponible

• API REST — 11 endpoints, sin límites de tasa. Especificación legible por máquina · docs
• SDK npm — npm install framethrower-ai (fuente)

Misma cuenta, mismos créditos.

---

Acerca de

FrameThrower es la aplicación de referencia para el creativo del futuro: una de las mayores bibliotecas de fotogramas de películas en internet, invocable desde una API REST, un servidor MCP y un SDK npm. Construida por cineastas senior y creativos publicitarios, para profesionales del cine en activo.

framethrower.ai · /mcp

Licencia MIT.