Lego API: das Brickfact-Plugin für ChatGPT und der MCP-Server

Eine offizielle, öffentliche Entwickler-API für Katalog oder Shoppreise bietet Lego nicht an. Für den Einkauf schließt Brickfact diese Lücke: Mit dem Brickfact-Plugin für ChatGPT und unserem öffentlichen MCP-Server sucht ein KI-Assistent Lego Sets und vergleicht aktuelle Händlerangebote inklusive Versand in neun Ländern. Für beides brauchst du weder ein Brickfact-Konto noch einen Schlüssel.

Dieser Ratgeber zeigt, wie du das Plugin zu ChatGPT hinzufügst, wie du den MCP-Server mit anderen Assistenten verbindest und was die Tools liefern. Die Beispiele rechnen in Euro für Deutschland und Österreich und in Franken für die Schweiz. Den Dienst betreibt Brickfact selbst, deshalb beschreiben wir seine Grenzen genauso offen wie seine Funktionen.

Das Brickfact-Plugin zu ChatGPT hinzufügen

Am schnellsten geht es über das Brickfact-Plugin im Plugin-Verzeichnis von ChatGPT. Herunterladen musst du nichts: Das Plugin wird direkt in ChatGPT installiert und funktioniert im Browser, in der Desktop-App und auf dem Smartphone.

1. Öffne die Seite des Brickfact-Plugins, während du bei ChatGPT angemeldet bist. Alternativ wählst du in der Seitenleiste von ChatGPT Plugins und suchst nach Brickfact.
2. Sieh dir an, was das Plugin umfasst, und installiere es.
3. Starte einen Chat und stell eine Einkaufsfrage mit Land, zum Beispiel „Vergleiche Angebote für Lego 75192 mit Versand nach Deutschland“. ChatGPT nutzt installierte Plugins, wenn sie zu deiner Anfrage passen. Willst du Brickfact gezielt aufrufen, tippst du @Brickfact oder wählst + und gibst den Namen ein.

Im Verzeichnis erscheinen nur Plugins, die dein Abo und dein Workspace zulassen. In einem Firmen-Workspace legen die Admins fest, welche Plugins Mitglieder installieren dürfen. Eine Anmeldung bei Brickfact braucht das Plugin nicht, weil es nur den öffentlichen Katalog liest.

Was Brickfact abdeckt

Brickfact erfasst die Angebote, die es bei Händlern beobachtet: Artikelpreis, gemeldeten Versand und Gesamtpreis in der Währung des gewählten Ziellands. Plugin und MCP-Server greifen auf denselben Dienst unter https://mcp.brickfact.com/mcp zu: Set-Suche, technische Daten, Angebote, Vergleiche, der erfasste Händler-Preisverlauf, eine Angebotsbewertung und ähnliche Sets. Der Dienst hat nur Lesezugriff. Die JSON-Routen dahinter sind nicht öffentlich; sie brauchen einen Schlüssel, den Brickfact nicht öffentlich vergibt.

Dass kein Schlüssel nötig ist, heißt nicht, dass die Nutzung unbegrenzt ist oder für immer kostenlos bleibt. Alle Nutzer teilen sich den Dienst, deshalb sind Anfragen pro Client und insgesamt begrenzt. Ist ein Limit erreicht, antwortet der Server mit HTTP 429 und einem Retry-After-Header; der Client sollte dann die dort angegebene Zeit abwarten, bevor er es erneut versucht.

Jeder Tool-Aufruf braucht einen dieser Märkte. Er bestimmt, welche Händler zählen und in welcher Währung du Preise bekommst. Andere Länder werden abgelehnt, nicht auf ein Nachbarland umgebogen. Die optionale Angabe language ändert nur Namen und Beschriftungen. Eine Antwort für die Schweiz auf Englisch liefert weiterhin Franken, Schweizer Händler und einen Link auf die Schweizer Vergleichsseite.

Was die Tools liefern

Fragst du nach Sets innerhalb eines Budgets, ruft der Assistent search_sets auf. Das Tool filtert nach Name oder Set-Nummer, Thema, Budget, Teilezahl, Altersangaben wie 18+ und Auslaufstatus, sortiert nach Preis, Rabatt oder Neuheit und liefert bis zu 20 Sets pro Seite. Themen-IDs kommen von list_themes. Unbekannte Eingaben werden abgelehnt statt ignoriert; so macht ein falsch verstandener Filter die Suche nicht unbemerkt breiter.

Für ein einzelnes Set listet get_set_offers jedes Angebot mit Artikelpreis, Versand, Gesamtpreis, Währung, Feed-Zeitpunkt (feed_updated_at) und Lagerstatus. Angebote mit bekanntem Gesamtpreis stehen vorn, dazu nennt das Ergebnis den niedrigsten bekannten Gesamtpreis und den niedrigsten Artikelpreis. Im Test am 30. Oktober 2026 lag in der Schweiz ein Angebot mit CHF 30.79 Artikelpreis wegen CHF 16 Versand am Ende bei CHF 46.79, also hinter einem Angebot für CHF 38.95 ohne Versandkosten. Kennt Brickfact die Versandkosten eines Shops nicht, bleiben Versand und Gesamtpreis leer (null). Das heißt unbekannt, nie kostenlos.

Der Lagerstatus (stock_status) steht immer auf not_verified. Ein Preis im Feed beweist nicht, dass das Set lieferbar ist, und der gemeldete Versand gilt für ein einzelnes Set. Grenzen für kostenlosen Versand, Gutscheine und Regeln an der Kasse können den Endbetrag ändern; verbindlich ist erst der Checkout des Händlers.

get_set_details ergänzt UVP, Altersangabe, Minifiguren, Maße und ein geschätztes Auslaufdatum. compare_sets stellt zwei bis vier Sets nebeneinander.

Artikelpreis oder Preis inklusive Versand?

Standard ist "price_basis": "item". In diesem Modus rechnen Budget und Sortierung mit dem reinen Set-Preis, item_price ist gefüllt und total_price bleibt null. Ein Set für 45 € mit 6,99 € Versand rutscht so durch ein Budget von 50 €, obwohl es dich mehr als 50 € kostet.

Mit "delivered" nimmt Brickfact den Gesamtpreis inklusive gemeldetem Versand in den gewählten Markt. Angebote mit unbekanntem Versand fliegen vor Preisfilter, Trefferzahl und Seitenaufteilung heraus. total und jede Seite enthalten also nur Sets mit bekanntem Gesamtpreis, und zwischen den Seiten entstehen durch den Filter keine Lücken. Der Preis dafür: Ein Shop, der keine Versandkosten meldet, taucht in dieser Suche gar nicht auf.

Für den Einkauf ist der Preis inklusive Versand meist die ehrliche Wahl. Ein niedriger Artikelpreis aus einem Shop im Ausland ist oft kein Schnäppchen mehr, sobald der Versand nach Deutschland, Österreich oder in die Schweiz dazukommt. Sammler vergleichen deshalb meist Preise inklusive Versand. Den Artikelpreis-Modus brauchst du für Katalogansichten, bei denen Versand keine Rolle spielt.

Zwei Arten von Preisverlauf

Brickfact führt zwei Verlaufsdatensätze, und wer sie verwechselt, bekommt falsche Antworten.

Der Händler-Preisverlauf (Tool get_retail_price_history) speichert pro Tag den niedrigsten bekannten Preis inklusive Versand bei den beobachteten Händlern eines Markts, in dessen Währung. Amazon ist ausgenommen, ebenso Tage mit unbekanntem oder geschätztem Versand. Vergangene Tage werden mit den heutigen Versandregeln für das Zielland gerechnet. Das Ergebnis nennt observation_days und first_observed_day. Diese Reihe beginnt erst am 12. Oktober 2026; ein langes angefragtes Zeitfenster heißt also nicht, dass auch entsprechend viele Daten vorliegen. Prüf die Abdeckung, bevor du Schlüsse ziehst.

Der Marktwert-Verlauf (Tool get_price_history) ist eine eigene Reihe von Bewertungen versiegelter Sets in Euro. Sie zeigt, was ein versiegeltes Set über die Zeit wert ist, also die Art von Marktwert, die unsere Studie zur Lego-Marktentwicklung auswertet. Auch mit dem Markt Schweiz bleibt sie in Euro, und sie ist kein Verlauf von Händlerpreisen.

Die Angebotsbewertung (Tool assess_deal) vergleicht das günstigste aktuelle Angebot inklusive Versand, aus einem höchstens 48 Stunden alten Feed, mit dem erfassten Tiefstpreis der Händler. Sie antwortet mit at_or_below_recorded_low oder above_recorded_low und der Abweichung in Prozent. Fehlen mindestens zwei erfasste Tage oder ist der Verlauf älter als 48 Stunden, lautet die Antwort insufficient_history, ohne verwertbares Angebot no_delivered_offer. Das aktuelle Angebot kann von Amazon stammen, obwohl der Verlauf Amazon ausschließt. Ein Ergebnis auf dem erfassten Tiefststand ist kein Allzeittief und sagt nichts über den Preis im nächsten Monat.

Den MCP-Server mit anderen Assistenten verbinden

Das Model Context Protocol ist ein offener Standard, mit dem KI-Anwendungen externe Systeme anbinden. Der Assistent findet die Brickfact-Tools und ruft sie auf, sobald deine Frage aktuelle Daten braucht; Abfragen musst du also nicht selbst schreiben.

Jeder Client, der entfernte Server über Streamable HTTP unterstützt, verbindet sich mit dieser URL. Rein lokale Clients, die nur stdio sprechen, brauchen eine Brücke.

In ChatGPT kannst du den Server auch selbst anbinden, statt das Plugin zu installieren, etwa wenn dein Workspace eigene MCP-Server erlaubt, das Plugin aus dem Verzeichnis aber nicht, oder wenn deinem Plugin ein Tool aus der Liste unten fehlt. Die Anleitung von OpenAI beschreibt den Weg: ChatGPT Plugins öffnen, über das Plus-Symbol Add custom MCP server wählen, Name und Beschreibung vergeben, die URL samt /mcp eintragen, keine Authentifizierung auswählen, den Risikohinweis bestätigen und Create as a plugin wählen.

Die elf Tools:

Prompts, die beim Einkaufen helfen

Der Server weist den Assistenten an, das Einkaufsland aus dem Gespräch zu übernehmen und nachzufragen, wenn es fehlt. Nenn es also gleich mit. Diese Prompts decken die wichtigsten Tools ab:

• „Finde Lego Star Wars Sets unter 100 € inklusive Versand nach Deutschland und zeig sie als Karten.“
• „Hilf mir, ein Lego Geschenk bis 60 Franken mit Lieferung in die Schweiz für einen Zehnjährigen zu finden, der Autos mag.“
• „Vergleiche Lego 10311 und 10313 für eine Lieferung nach Österreich, inklusive Teilezahl und Gesamtpreis.“
• „Ist der heutige Preis für Lego 75192 in Deutschland gut im Vergleich zu den erfassten Händlerpreisen? Sag mir, wie viele Tage Daten du hast.“
• „Finde günstigere Alternativen zu Lego 75192 mit Lieferung in die Schweiz.“

Hosts mit Unterstützung für MCP Apps zeigen Set-Karten mit Bildern, eine Vergleichsansicht und Diagramme zum Händler-Preisverlauf. Andere antworten mit denselben Daten als Text. Wo der Host Apps einen Zustand speichern lässt, merkt sich die Karte eine Auswahlliste von bis zu sechs Set-Nummern. Diese Liste gehört zur Karte im Chat, nicht zu einem Brickfact-Konto, und ist in einem neuen Chat womöglich nicht mehr da.

Was der Assistent nicht kann

Plugin und MCP-Server lesen nur öffentliche Katalogdaten. Sie können nichts kaufen, fragen keine Zahlungsdaten ab, sehen deine Brickfact-Sammlung nicht und ändern nichts an deinem Konto. Bittest du darum, dich zu benachrichtigen, wenn Lego 10311 unter 30 € fällt, bekommst du eine Übergabe an die App mit "created": false: einen Link zur Brickfact App und die Schritte, den Alarm dort anzulegen. Angelegt ist erst etwas, wenn du es in der App bestätigst. Wie Preisalarme funktionieren, erklärt unser Ratgeber zum Lego Preisalarm.

Preise in einer Antwort sind nur so aktuell wie der Feed dahinter. Ein gutes Angebot kann Minuten nach dem Preissturz ausverkauft sein; öffne deshalb vor dem Kauf den mitgelieferten Vergleichslink und prüf den Shop.

So bleiben die Antworten verlässlich

Ein paar Gewohnheiten halten die Antworten korrekt, wenn sich die Daten ändern:

• Fang mit einem Set und einem Markt an und prüf in jeder Antwort Währung und Preisbasis, bevor du weitere Länder ergänzt.
• Werte unbekannten Versand nie als kostenlos.
• Achte darauf, wann der Feed aktualisiert wurde (feed_updated_at), oder notier den Zeitpunkt deiner Frage neben den Preisen.
• Behandle leere Treffer und kurze Verläufe als normale Antworten, nicht als Fehler.
• Halte dich nach HTTP 429 an Retry-After und durchkämm nicht den ganzen Katalog über Suchseiten.
• Nutze den gelieferten Vergleichslink (comparison_url), statt Set-URLs selbst zusammenzubauen.

Wer Preise lieber von Hand vergleicht, findet dieselben Angebote mit Filtern in der Lego Datenbank, und so vergleichen wir Preise erklärt, welche Händler wir beobachten.

Weitere Lego-Datenquellen

Brickfact deckt Händlerangebote ab, nicht Teile oder den Gebrauchtmarkt. Für Teile, Farben und Set-Inventare ist die API von Rebrickable die übliche Quelle; die Brickset API liefert Set-Daten und Sammlungen, und die BrickLink API gibt Marktpreise für neue und gebrauchte Sets aus. Alle drei brauchen einen eigenen Schlüssel und setzen eigene Nutzungsregeln.

Eine API, um Lego Hubs und Motoren zu programmieren, ist ein Robotik-Thema, kein Datenthema. Unser Ratgeber Lego Roboter programmieren behandelt SPIKE, Mindstorms und Python mit Pybricks. Brickfact ist unabhängig von der Lego-Gruppe.