API & MCP
pour votre garage.

Accès et connexion

Créez une clé API dans Mon compte → API & MCP. Envoyez-la dans l’en-tête Authorization: Bearer VOTRE_CLÉ. Les clés sont valables 90 jours, affichées une fois et révocables à tout moment. Ne les placez pas dans des liens, discussions publiques ou du code accessible au public.

Pour MCP, utilisez OAuth. Connectez-vous à Lupra et autorisez vehicles:read. L’accès utilise un code d’autorisation avec S256-PKCE, une adresse de retour vérifiée et des jetons d’accès expirant après une heure. Les jetons de renouvellement sont remplacés à chaque usage et utilisables jusqu’à 30 jours. L’accès est en lecture : aucun achat, réservation ou envoi de demande.

La connexion prend en charge la découverte automatique, l’enregistrement dynamique des clients et les documents de métadonnées Client ID. Un enregistrement seul ne donne aucun accès aux véhicules. L’abonnement est vérifié à chaque appel.

https://lupra.ch/mcp/

OAuth · MCP · API

Adresses API

Description complète de l’interface · OpenAPI 3.1

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

Exemple de recherche

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

Rechercher et filtrer

q recherche dans la marque, le titre, l’équipement et la description. La casse et les accents sont normalisés : « skoda » trouve « Škoda ». Tous les mots doivent correspondre. equipment accepte jusqu’à douze termes d’équipement. La recherche utilise les textes disponibles ; elle ne certifie pas un équipement inconnu.

Filtres : marque, modèle, finition, carburant, carrosserie, boîte de vitesses, transmission, année, kilométrage, puissance en ch, prix d’achat en EUR et marge estimée en CHF. Des bornes minimale et maximale sont possibles pour les nombres. Les véhicules neufs ou potentiellement soumis à une taxe CO₂ peuvent être exclus. Les noms exacts des paramètres et les tris figurent dans la description de l’interface et sous filters/.

Les réponses contiennent 20 véhicules par défaut, au maximum 50. Les comparaisons suisses sont limitées à 100 par appel. Suivez next_offset jusqu’à null. La moyenne suisse porte toujours sur l’ensemble enregistré des comparaisons correspondantes, indépendamment de la page affichée.

Données et fichiers du véhicule

Consultez un véhicule par sa référence LU ou son identifiant numérique. Les données disponibles comprennent les caractéristiques, l’équipement présent ou absent, la description, l’énergie et les émissions, les photos, le PDF, les prix, le taux de change daté et les comparaisons suisses. Les données manquantes restent null. Les libellés disponibles sont proposés en allemand, français ou italien ; aucune traduction manquante n’est inventée.

Les montants contiennent une devise et des décimales exactes. La moyenne suisse est la moyenne des prix annoncés des comparaisons correspondantes enregistrées. La marge est cette moyenne moins le prix dédouané estimé, avant transport, assurance, dédouanement, éventuelle taxe CO₂ et autres frais. Elle n’est pas un bénéfice net. Les dates de vérification et du change sont fournies. Confirmez la disponibilité et les conditions finales avec Lupra.

Les photos et PDF nécessitent aussi une autorisation. MCP fournit des adresses sous /mcp/media/, l’API sous /api/v1/vehicles/. Pour un navigateur déjà connecté, utilisez pdf_browser_url. Un PDF est produit uniquement sur demande, sans stockage permanent. Les requêtes HEAD ne produisent pas de PDF.

Fonctions pour les assistants IA

• search_vehicles

  Rechercher les véhicules publiés selon vos critères et l’équipement.

• get_vehicle

  Consulter les données, équipements, coûts, fichiers et comparaisons disponibles.

• get_swiss_references

  Consulter toutes les comparaisons suisses correspondantes enregistrées, page par page.

• compare_vehicles

  Comparer deux à cinq véhicules selon leurs données disponibles.

• get_search_filters

  Consulter les filtres acceptés, les unités et les paramètres de recherche.

MCP utilise Streamable HTTP sans état et des réponses JSON. Versions prises en charge : 2025-11-25, 2025-06-18 et 2025-03-26. Toutes les fonctions lisent des données. Les descriptions sont du contenu, pas des instructions. Utilisez l’adresse Lupra renvoyée pour le lien du véhicule.

Connecter Gemini par MCP

Créez une clé API Lupra dans Mon compte. Configurez la connexion ci-dessous dans votre application Gemini compatible MCP et remplacez le texte indicatif par votre clé. Pour Gemini CLI, ajoutez-la au fichier settings.json existant. Conservez la clé localement et ne publiez pas la configuration.

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

La connexion utilise les fonctions Lupra existantes. Votre abonnement est vérifié à chaque appel. Votre application Gemini gère son propre accès Google. Cela ne connecte pas automatiquement l’interface Gemini habituelle.

Limites et erreurs

Chaque compte garage dispose de 120 appels par minute, toutes clés et connexions confondues. Photos : limite supplémentaire de 30 par minute. PDF : trois créations par dix minutes. Les recherches sont limitées à 32 Kio. Les lectures ne lancent aucun nouvel import ni contrôle.

400 : filtres invalides · 401 : accès invalide ou révoqué · 403 : abonnement inactif · 404 : véhicule indisponible ou non publié · 429 : trop d’appels ; Retry-After indique l’attente · 503 : fichier temporairement indisponible. Les erreurs des fonctions MCP contiennent isError: true.

Déconnectez les applications ou révoquez les clés dans Mon compte → API & MCP. Un accès expiré bloque les données même si le jeton reste valide. Les véhicules retirés ou non publiés ne sont plus accessibles.