Lego no ofrece una API pública para su catálogo ni para los precios de su tienda. Brickfact cubre la parte de las compras: el plugin de Brickfact para ChatGPT y nuestro servidor MCP público permiten a un asistente de IA buscar sets de Lego y comparar las ofertas actuales de las tiendas, con envío incluido, en nueve países. Ninguno de los dos pide cuenta de Brickfact ni clave.
Esta guía explica cómo añadir el plugin a ChatGPT, cómo conectar el servidor MCP a otros asistentes y qué devuelven las herramientas. Los ejemplos están pensados para España y usan euros. Brickfact gestiona este servicio, así que describimos sus límites con la misma franqueza que sus funciones.
Añadir el plugin de Brickfact a ChatGPT
La forma más rápida de empezar es el plugin de Brickfact en el directorio de plugins de ChatGPT. No hay nada que descargar: el plugin se instala dentro de ChatGPT y funciona en la web, en la app de escritorio y en el móvil.
- Abre la página del plugin de Brickfact con la sesión de ChatGPT iniciada. También puedes seleccionar Plugins en la barra lateral de ChatGPT y buscar Brickfact.
- Revisa lo que incluye el plugin e instálalo.
- Abre un chat y haz una pregunta de compra que mencione el país, por ejemplo «Compara las ofertas del set Lego 75192 con envío a España». ChatGPT usa los plugins instalados cuando encajan con lo que pides. Para llamar directamente a Brickfact, escribe @Brickfact o selecciona + e introduce su nombre.
El directorio solo muestra los plugins que permiten tu plan y tu espacio de trabajo. En el espacio de trabajo de una empresa, el administrador decide qué plugins pueden instalar los miembros. El plugin no te pide iniciar sesión en Brickfact, porque solo lee el catálogo público.
Qué cubre Brickfact
Brickfact monitoriza las ofertas de las tiendas: precio del artículo, gastos de envío declarados y total en la moneda del país de destino elegido. El plugin y el servidor MCP usan el mismo servicio, en https://mcp.brickfact.com/mcp: búsqueda de sets, características, ofertas, comparativas, el historial de precios registrado en tiendas, la valoración de una oferta y los sets parecidos. El servicio es de solo lectura. Las rutas JSON que hay detrás no son públicas: requieren una clave que Brickfact no ofrece al público.
Que no haga falta clave no significa uso ilimitado ni la promesa de un servicio gratuito para siempre. Es un servicio compartido, así que las peticiones están limitadas por cliente y en total. Cuando se alcanza un límite, el servidor responde con HTTP 429 y una cabecera Retry-After, y el cliente debe esperar ese tiempo antes de volver a intentarlo.
| Mercado | Código | Moneda |
|---|---|---|
| España | ES | EUR |
| Alemania | DE | EUR |
| Austria | AT | EUR |
| Suiza | CH | CHF |
| Reino Unido | GB | GBP |
| Estados Unidos | US | USD |
| Francia | FR | EUR |
| Países Bajos | NL | EUR |
| Italia | IT | EUR |
Cada llamada a una herramienta necesita uno de estos mercados: decide qué tiendas cuentan y en qué moneda llegan los precios. Otros países, Portugal por ejemplo, se rechazan en lugar de sustituirse por un vecino. El parámetro opcional language solo cambia nombres y etiquetas. Una respuesta en inglés para el mercado español sigue mostrando euros, tiendas españolas y un enlace a la página de comparación española.
Qué devuelven las herramientas
Si pides sets dentro de un presupuesto, el asistente llama a search_sets. La herramienta filtra por nombre o número de set, tema, presupuesto, número de piezas, edades como 18+ y estado de retirada, ordena por precio, descuento o novedad y devuelve hasta 20 sets por página. Los identificadores de tema salen de list_themes. Un parámetro desconocido se rechaza en vez de ignorarse, así que un filtro mal entendido no amplía la búsqueda sin que te enteres.
Ojo con las tildes: en nuestras pruebas, «orquídea» encontraba los sets y «orquidea» sin tilde no devolvía nada. Si no estás seguro del nombre exacto, busca por número de set, que es lo más fiable.
Para un solo set, get_set_offers enumera cada oferta con el precio del artículo, el envío, el total, la moneda, la hora del feed (feed_updated_at) y el estado de existencias. Las ofertas con total conocido van primero, y el resultado indica el total conocido más bajo y el precio de artículo más bajo. Cuando Brickfact no conoce los gastos de envío de una tienda, el envío y el total quedan vacíos (null). Léelo como desconocido, nunca como gratis.
El estado de existencias (stock_status) siempre vale not_verified. Un precio en un feed no demuestra que haya existencias, y el envío declarado corresponde a un solo set. Los umbrales de envío gratuito, los cupones y las reglas del carrito pueden cambiar el importe final; manda el importe del proceso de pago de la tienda.
get_set_details añade el precio recomendado, la edad indicada, el número de minifiguras, las medidas y una fecha estimada de retirada. compare_sets compara de dos a cuatro sets, uno junto a otro.
¿Precio del artículo o precio con envío?
Por defecto, price_basis vale "item". En este modo, el presupuesto y el orden usan solo el precio del set, item_price viene relleno y total_price queda en null. Un set de 45 € con 6,99 € de envío entra así en un presupuesto de 50 €, aunque recibirlo en casa te cueste más.
Con "delivered", Brickfact usa el total con el envío declarado al mercado elegido. Las ofertas con envío desconocido se descartan antes del filtro de precio, el recuento y la paginación: total y cada página solo incluyen sets con un total conocido, sin huecos entre páginas. La contrapartida es que una tienda que no declara sus gastos de envío desaparece por completo de estos resultados.
Para comprar, el precio con envío suele ser la opción más honesta. Un precio bajo en una tienda extranjera deja muchas veces de ser una ganga en cuanto se suma el envío a España, y por eso los coleccionistas suelen comparar con envío incluido. Reserva el modo artículo para vistas de catálogo en las que el envío no importa.
Dos tipos de historial de precios
Brickfact lleva dos historiales distintos, y confundirlos da respuestas equivocadas.
El historial de precios en tiendas (herramienta get_retail_price_history) guarda cada día el precio más bajo conocido con envío en las tiendas monitorizadas de un mercado, en su moneda. Amazon queda fuera, igual que los días con envío desconocido o estimado. Los días pasados se calculan con las reglas de envío actuales para el país. El resultado indica observation_days y first_observed_day. Esta serie empezó el 12 de octubre de 2026: pedir un periodo largo no garantiza un historial largo. Revisa la cobertura antes de sacar conclusiones.
El historial de valor de mercado (herramienta get_price_history) es otra serie: valoraciones de sets precintados en euros. Muestra cuánto vale un set precintado a lo largo del tiempo; nuestro estudio sobre la inversión en Lego usa valoraciones así para los sets que siguen en las colecciones. Aunque pidas GB, US o CH, sigue en euros, y no es un historial de lo que cobran las tiendas.
La valoración de oferta (herramienta assess_deal) compara la oferta actual más barata con envío, de un feed de menos de 48 horas, con el mínimo registrado en las tiendas. Responde at_or_below_recorded_low o above_recorded_low, con la diferencia en porcentaje. Sin al menos dos días registrados o con un historial de más de 48 horas responde insufficient_history, y sin una oferta utilizable no_delivered_offer. La oferta actual puede ser de Amazon aunque el historial lo excluya. Un resultado en el mínimo registrado no es un mínimo histórico absoluto ni dice nada del precio del mes que viene.
Conectar el servidor MCP a otros asistentes
El Model Context Protocol es un estándar abierto para conectar aplicaciones de IA con sistemas externos. El asistente descubre las herramientas de Brickfact y las llama cuando tu pregunta necesita datos actuales, así que no tienes que escribir ninguna petición.
| Ajuste | Valor |
|---|---|
| URL del servidor | https://mcp.brickfact.com/mcp |
| Transporte | Streamable HTTP (peticiones POST sin estado) |
| Autenticación | Ninguna |
| Herramientas | 11, todas de solo lectura |
Cualquier cliente compatible con servidores remotos por Streamable HTTP se conecta con esta URL. Los clientes locales que solo admiten stdio necesitan un puente.
En ChatGPT también puedes conectar tú mismo el servidor en lugar de instalar el plugin, por ejemplo si tu espacio de trabajo permite servidores MCP propios pero no el plugin del directorio, o si a tu plugin le falta alguna herramienta de la lista de abajo. La guía de conexión de OpenAI describe el camino: abre ChatGPT Plugins, pulsa el botón «+» y luego Add custom MCP server, ponle nombre y descripción, escribe la URL con /mcp, elige sin autenticación, confirma el aviso de riesgo y selecciona Create as a plugin.
Las once herramientas:
| Herramienta | Para qué sirve |
|---|---|
search_sets | Buscar por nombre, número, tema, presupuesto, piezas, edad o retirada |
get_set_details | Características, fecha estimada de retirada y ofertas |
get_set_offers | Ofertas de un set con gastos de envío |
compare_sets | De dos a cuatro sets lado a lado |
list_themes | Nombres e identificadores de temas |
get_retail_price_history | Precios de tiendas registrados, envío incluido |
assess_deal | Oferta actual frente al mínimo registrado |
get_price_history | Valor de sets precintados en euros |
find_alternatives | Sets parecidos, más baratos o más pequeños |
render_sets | Tarjetas de compra o vista comparativa |
get_app_handoff | Pasos para crear una alerta de precio o añadir un set a la watchlist en la app de Brickfact |
Qué pedirle al asistente para comprar
El servidor pide al asistente que tome el país de compra de la conversación y que lo pregunte si falta, así que menciónalo desde el principio. Estos prompts cubren las herramientas principales:
- «Busca sets de Lego Star Wars por menos de 100 € con envío a España y muéstralos como tarjetas.»
- «Ayúdame a elegir un regalo de Lego de hasta 60 € con envío en España para un niño de 10 años al que le gustan los coches.»
- «Compara los sets Lego 10311 y 10313 con entrega en España, con número de piezas y precio con envío.»
- «¿Es bueno el precio actual del set Lego 75192 en España frente a los precios registrados en tiendas? Dime cuántos días de datos tienes.»
- «Busca alternativas más baratas al set Lego 75192 con entrega en España.»
Los hosts compatibles con MCP Apps muestran tarjetas de sets con imágenes, una comparativa lado a lado y gráficos del historial de precios en tiendas. En otros, el asistente responde en texto con los mismos datos. Si el host deja que las apps guarden estado, la tarjeta puede conservar una lista de hasta seis números de set. Esa lista pertenece a la tarjeta dentro de la conversación, no a una cuenta de Brickfact, y puede que no esté en un chat nuevo.
Lo que el asistente no puede hacer
El plugin y el servidor MCP solo leen datos públicos del catálogo. No pueden comprar nada, no piden datos de pago, no ven tu colección de Brickfact y no cambian tu cuenta. Si pides un aviso para cuando el set Lego 10311 baje de 30 €, el asistente te devolverá un enlace a la app con "created": false: un enlace a la app de Brickfact y los pasos para crear allí la alerta. No se crea nada hasta que lo confirmas en la app. Si lo que buscas son descuentos del día, nuestra página de ofertas de Lego los reúne.
Los precios de una respuesta nunca son más recientes que el feed que los alimenta. Una buena oferta puede agotarse minutos después de una bajada, así que abre el enlace de comparación devuelto y revisa la tienda antes de comprar.
Buenas prácticas para respuestas fiables
Unas cuantas costumbres evitan errores cuando cambian los datos:
- Empieza con un set y un mercado, y comprueba la moneda y la base de precio en cada respuesta antes de añadir más países.
- Interpreta un envío desconocido como desconocido, nunca como gratis.
- Fíjate en cuándo se actualizó el feed (
feed_updated_at) o apunta la hora de tu pregunta junto a los precios. - Trata los resultados vacíos y los historiales cortos como respuestas normales, no como errores.
- Tras un error HTTP 429, respeta
Retry-After, y no recorras todo el catálogo a base de páginas de búsqueda. - Usa el enlace de comparación devuelto (
comparison_url) en lugar de construir tú las direcciones de las páginas de sets.
Si prefieres comparar precios a mano, el catálogo de Lego muestra las mismas ofertas con filtros, y cómo comparamos precios explica qué tiendas monitorizamos.
Otras fuentes de datos de Lego
Brickfact cubre las ofertas de las tiendas, no las piezas ni el mercado de segunda mano. Para piezas, colores e inventarios de sets, la fuente habitual es la API de Rebrickable; la API de Brickset cubre fichas de sets y colecciones, y la API de BrickLink da acceso a los precios de su marketplace para sets nuevos y usados. Las tres piden su propia clave y fijan sus propias reglas de uso.
Una API para programar hubs y motores de Lego es cosa de robótica, no de datos: nuestra guía para programar un robot Lego trata SPIKE, Mindstorms y Python con Pybricks. Brickfact es independiente del Grupo Lego.
