FrameThrower MCP
Encuentra fotogramas de películas, capturas de pantalla de cine y referencias de cinematografía dentro de asistentes de IA para inspirarte, aprender y hacer películas más rápido.
Documentación
Conecta un agente
OAuth 2.1 — tu cliente abre un inicio de sesión de FrameThrower y no hay ninguna clave que pegar. Gratis para empezar, con medición de uso contra tu saldo de créditos.
Introducción
El servidor MCP de FrameThrower MCP brinda a cualquier cliente MCP acceso de búsqueda 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 aspecto en la conversación y el agente responde con fotogramas reales, acreditados a su película, director y director de fotografía.
URL del servidor
https://framethrower.ai/api/mcp
OAuth 2.1 · cuatro herramientas · sin límites de tasa · instrucciones de configuración por cliente
Conéctalo
1
Agrégalo como servidor MCP remoto
En la configuración de conectores de tu cliente, agrega https://framethrower.ai/api/mcp. Desde la CLI de Claude Code, eso es un solo comando:
claude mcp add --transport http framethrower https://framethrower.ai/api/mcp
2
Inicia sesión
La autenticación es OAuth 2.1 — tu cliente abre un inicio de sesión de FrameThrower y no hay ninguna clave que pegar. Después de eso, el agente actúa como tú, con el mismo acceso de referencia que tiene tu cuenta.
3
Pide un aspecto
El servidor envía sus propias instrucciones de uso al conectarse, por lo que no es necesario decirle al cliente cómo comportarse. Pide referencias para una escena y busca, muestra algunas y refina según lo que te guste.
Clientes para los que esto está configurado y documentado:
Cómo lo usa un agente
El servidor envía instrucciones de uso al conectarse, por lo que no es necesario decirle a un cliente cómo comportarse. La forma que solicita es: buscar, mostrar un conjunto pequeño — unas cuatro — con película, director y un enlace cada una, y luego refinar según lo que reaccione el usuario. Alguien que diga "más como la #2, más fría" se convierte en una llamada a find_similar en ese fotograma, o a find_by_craft con los atributos ajustados.
Cada resultado lleva un enlace de vuelta a FrameThrower, porque la representación de imágenes en línea en el chat no es confiable y la galería es donde los fotogramas realmente se ven como son.
Precios
El servidor MCP está incluido en el plan gratuito. Una cuenta nueva recibe $2 de créditos, sin tarjeta, y puede conectarse y empezar a llamar a las herramientas de inmediato — no hay ningún plan al que ascender para obtener acceso. El uso se mide por llamada, y compras más créditos cuando quieras más llamadas.
Every tool call 2 créditos
search_frames, find_by_craft, find_similar y get_frame_details cuestan lo mismo.
$1 1,000 créditos
Así que $1 cubre 500 llamadas a herramientas. Los créditos nunca caducan.
Top up Paquetes de $20
En Configuración → Facturación, en múltiplos enteros.
No hay límites de tasa.
Si te quedas sin saldo, la herramienta responde con un mensaje que lo indica, incluyendo el saldo y dónde recargar — un agente puede leer eso y decírselo a su usuario, en lugar de fallar silenciosamente.
search_frames
HERRAMIENTA search_frames 2 créditos por llamada
Busca en la biblioteca por concepto, estado de ánimo, color, composición o escena, en lenguaje natural.
query cadenarequerido
p. ej. neon-lit rainy street at night.
limit número
1–40. El valor predeterminado es 12.
find_by_craft
HERRAMIENTA find_by_craft 2 créditos por llamada
Encuentra fotogramas por atributos específicos de cinematografía. Todos son opcionales — combínalos para acotar. Se requiere al menos uno, o la herramienta pide uno en lugar de devolver toda la biblioteca.
lens cadena
anamorphic, spherical, vintage_soft
shot_size cadena
closeup, wide, medium
visual_style cadena
p. ej. noir, naturalistic, stylized
setting cadena
interior o exterior
time_of_day cadena
night, day
director cadena
Nombre completo, p. ej. Denis Villeneuve.
year_min / year_max número
Rango de años.
limit número
1–40. El valor predeterminado es 12.
find_similar
HERRAMIENTA find_similar 2 créditos por llamada
Obtén más fotogramas similares a uno que el usuario ya haya preseleccionado. Este es el bucle de refinamiento, y la herramienta a la que debería recurrir la respuesta "más como esa".
frameId cadenarequerido
Un id de un resultado anterior.
limit número
1–40. El valor predeterminado es 12.
get_frame_details
HERRAMIENTA get_frame_details 2 créditos por llamada
Metadatos completos, miniatura, mapa de profundidad y enlace para un solo fotograma.
frameId cadenarequerido
Un id de un resultado anterior.
Lo que devuelve
Cada herramienta devuelve fotogramas como texto que un agente puede citar: la película con su año, director y director de fotografía, los atributos técnicos detrás del plano, una URL de miniatura, la URL de la imagen en resolución completa y un enlace al fotograma en FrameThrower. Además, un enlace a la misma búsqueda como galería, para cuando el lector quiera seguir explorando manualmente.
Cada fotograma también lleva un mapa de profundidad — en escala de grises, con las mismas dimensiones que el fotograma, precalculado para los 410,000. Un agente que construye un plano puede pasarlo directamente a un ControlNet de profundidad para mantener la composición y la geometría de cámara de una referencia mientras cambia todo lo demás. No cuesta créditos adicionales ni requiere una llamada extra; la línea simplemente está ahí en el resultado.
Sin bytes de imagen, nunca. Esta es una herramienta de descubrimiento y referencia, no un conducto de entrega de imágenes — los fotogramas no son nuestros para licenciar, y los derechos permanecen con sus propietarios. Consulta la Política de Uso Previsto.
También hay API REST
El servidor MCP son cuatro herramientas sobre la misma biblioteca a la que llega una API REST de once endpoints — y el lado REST tiene las tres que las herramientas no tienen: búsqueda de imágenes, búsqueda de color y el catálogo de películas. Misma cuenta, mismos créditos.
npm install framethrower-ai
Preguntas frecuentes
¿Qué es el servidor MCP de FrameThrower MCP?
Un servidor MCP (Protocolo de Contexto de Modelo) en https://framethrower.ai/api/mcp que brinda a un agente de IA acceso de búsqueda a una biblioteca de referencia cinematográfica de 5,489 películas. Cuatro herramientas: search_frames, find_by_craft, find_similar y get_frame_details. Conéctalo en Claude, Cursor o cualquier cliente MCP y el agente puede encontrar referencias de películas reales en medio de la conversación.
¿Cómo lo conecto?
Agrega https://framethrower.ai/api/mcp como servidor MCP remoto en la configuración de conectores de tu cliente. La autenticación es OAuth 2.1 — tu cliente abre un inicio de sesión de FrameThrower, y después de eso el agente actúa como tú, con el mismo acceso de referencia que tiene tu cuenta. Cursor admite un enlace de instalación con un clic.
¿Cuánto cuesta?
Está incluido en el plan gratuito — no hay ningún nivel al que ascender para obtener acceso. Una cuenta nueva recibe $2 de créditos, sin tarjeta. Cada llamada a herramienta cuesta 2 créditos y $1 = 1,000 créditos, así que $1 cubre 500 llamadas a herramientas, y compras más créditos por uso cuando quieras más llamadas. Los créditos nunca caducan y no hay límites de tasa. Cuando un saldo se agota, la herramienta devuelve un mensaje que lo indica en lugar de fallar silenciosamente.
¿Devuelve imágenes?
Sin bytes de imagen, nunca. Las herramientas devuelven metadatos, una URL de miniatura y un enlace profundo de vuelta a FrameThrower. Es una herramienta de descubrimiento y referencia, no un conducto de entrega de imágenes — los fotogramas no son nuestros para licenciar, y los derechos permanecen con sus propietarios.
¿También hay una API REST?
Sí — 11 endpoints con autenticación de token portador y sin límites de tasa, además de un SDK de npm (npm install framethrower-ai). La especificación legible por máquina está en framethrower.ai/api/v1 y la documentación en framethrower.ai/developers. Mismos créditos, misma cuenta.
Más: configuración por cliente · documentación de la API · la base de datos de fotogramas