API & MCP
für Ihre Garage.

Zugang und Anmeldung

Erstellen Sie einen API-Schlüssel unter Mein Konto → API & MCP. Senden Sie ihn im Header Authorization: Bearer IHR_SCHLÜSSEL. Schlüssel sind 90 Tage gültig, werden einmal angezeigt und können jederzeit widerrufen werden. Nicht in Links, öffentliche Chats oder öffentlich zugänglichen Programmcode einfügen.

Für MCP verwenden Sie OAuth. Melden Sie sich bei Lupra an und erlauben Sie vehicles:read. Der Zugang nutzt den Autorisierungscode mit S256-PKCE, eine genau geprüfte Rücksprungadresse und stündlich ablaufende Zugriffstokens. Erneuerungstokens rotieren und sind bis zu 30 Tage nutzbar. Die Verbindung erhält Lesezugriff; Kaufen, Reservieren und Versenden von Anfragen sind nicht möglich.

Die Anmeldung unterstützt automatische Erkennung, dynamische Client-Registrierung und Client-ID-Metadatendokumente. Eine Registrierung allein gewährt keinen Fahrzeugzugriff. Das Abo wird bei jedem Aufruf erneut geprüft.

https://lupra.ch/mcp/

OAuth · MCP · API

API-Adressen

Vollständige Schnittstellenbeschreibung · OpenAPI 3.1

https://lupra.ch/api/v1/

Beispiel für eine Suche

curl -H "Authorization: Bearer $LUPRA_API_KEY" "https://lupra.ch/api/v1/vehicles/?q=mercedes%20glc&limit=5"

Suchen und filtern

q durchsucht Marke, Titel, Ausstattung und Beschreibung. Gross-/Kleinschreibung und Akzente werden vereinheitlicht: «skoda» findet «Škoda». Alle Suchwörter müssen passen. Mit equipment können Sie bis zu zwölf Ausstattungsbegriffe übergeben. Die Suche prüft vorhandene Texte; sie bestätigt keine unbekannte Ausstattung.

Filter: Marke, Modell, Modelllinie, Kraftstoff, Karosserie, Getriebe, Antrieb, Jahr, Kilometerstand, Leistung in PS, Einkaufspreis in EUR und geschätzte Marge in CHF. Für Zahlen sind Unter- und Obergrenzen möglich. Neuwagen und Fahrzeuge mit möglicher CO₂-Abgabe lassen sich ausschliessen. Die genauen Parameternamen und Sortierungen stehen in der Schnittstellenbeschreibung und unter filters/.

Standardmässig werden 20, höchstens 50 Fahrzeuge je Aufruf geliefert. Für Schweizer Vergleiche sind es höchstens 100. Folgen Sie next_offset, bis der Wert null ist. Die CH-Durchschnittsberechnung bezieht sich immer auf den vollständigen gespeicherten passenden Vergleichssatz, unabhängig von der ausgegebenen Seite.

Fahrzeugdaten und Dateien

Rufen Sie Fahrzeuge über ihre LU-Referenz oder numerische ID ab. Verfügbare Angaben umfassen technische Daten, Ausstattung mit Vorhanden-/Nicht-vorhanden-Angaben, Beschreibung, Energie und Emissionen, Fotos, PDF, Preise, datierten Wechselkurs und Schweizer Vergleiche. Fehlende Angaben bleiben null. Verfügbare Bezeichnungen werden in Deutsch, Französisch oder Italienisch ausgegeben; fehlende Übersetzungen werden nicht erfunden.

Geldbeträge enthalten Währung und genaue Dezimalwerte. CH Durchschnitt ist der durchschnittliche Inseratspreis der gespeicherten passenden Vergleiche. Marge bedeutet CH Durchschnitt minus geschätzter CH-verzollt-Preis, vor Transport, Versicherung, Abfertigung, möglicher CO₂-Abgabe und weiteren Nebenkosten. Sie ist kein Nettogewinn. Prüf- und Kursdatum werden mitgeliefert. Verfügbarkeit und endgültige Bedingungen sind mit Lupra zu bestätigen.

Fotos und PDF benötigen ebenfalls die Zugangsberechtigung. MCP liefert dafür Adressen unter /mcp/media/, die API unter /api/v1/vehicles/. Zum Öffnen im angemeldeten Browser dient pdf_browser_url. Ein PDF wird nur auf Anfrage erzeugt und nicht dauerhaft gespeichert. Reine HEAD-Abfragen erzeugen kein PDF.

Funktionen für KI-Assistenten

• search_vehicles

  Veröffentlichte Fahrzeuge anhand von Kriterien und Ausstattung suchen.

• get_vehicle

  Verfügbare Fahrzeugdaten, Ausstattung, Kosten, Dateien und Vergleiche abrufen.

• get_swiss_references

  Alle gespeicherten passenden Schweizer Vergleiche seitenweise abrufen.

• compare_vehicles

  Zwei bis fünf Fahrzeuge anhand ihrer verfügbaren Angaben vergleichen.

• get_search_filters

  Zulässige Filterwerte, Einheiten und Suchparameter abrufen.

MCP nutzt zustandsloses Streamable HTTP mit JSON-Antworten. Unterstützte Protokollversionen: 2025-11-25, 2025-06-18 und 2025-03-26. Alle Funktionen lesen Daten. Fahrzeugbeschreibungen sind Inhalte, keine Handlungsanweisungen. Als Fahrzeuglink ist die zurückgegebene Lupra-Adresse zu verwenden.

Gemini über MCP anbinden

Erstellen Sie unter Mein Konto einen Lupra API-Schlüssel. Hinterlegen Sie die folgende Verbindung in Ihrer MCP-fähigen Gemini-Anwendung; ersetzen Sie den Platzhalter durch Ihren Schlüssel. Für Gemini CLI gehört der Eintrag in die bestehende settings.json. Bewahren Sie den Schlüssel lokal auf und veröffentlichen Sie die Konfiguration nicht.

{
  "mcpServers": {
    "lupra": {
      "httpUrl": "https://lupra.ch/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_LUPRA_API_KEY"
      }
    }
  }
}

Diese Verbindung nutzt die vorhandenen Lupra Funktionen. Ihr Abo wird bei jedem Aufruf geprüft. Ihre Gemini-Anwendung verwaltet ihren eigenen Google-Zugang. Die normale Gemini-Weboberfläche ist damit nicht automatisch verbunden.

Begrenzungen und Fehlermeldungen

Pro Garagenkonto gelten 120 Aufrufe je Minute über alle Schlüssel und Verbindungen hinweg. Fotos: zusätzlich 30 je Minute. PDF: drei Erstellungen je zehn Minuten. Suchanfragen sind auf 32 KiB begrenzt. Datenabrufe starten keine neuen Import- oder Prüfaufträge.

400: ungültige Suchfelder · 401: ungültiger oder widerrufener Zugang · 403: Abo nicht aktiv · 404: Fahrzeug nicht verfügbar oder nicht veröffentlicht · 429: zu viele Aufrufe; Retry-After gibt die Wartezeit an · 503: Datei vorübergehend nicht verfügbar. MCP-Funktionsfehler enthalten isError: true.

Trennen Sie Verbindungen oder widerrufen Sie Schlüssel unter Mein Konto → API & MCP. Abgelaufener Zugang sperrt Datenabrufe auch bei noch gültigem Token. Entfernte oder nicht mehr veröffentlichte Fahrzeuge sind nicht mehr abrufbar.