Serveur MCP

Votre assistant IA, branché sur nos prix

Collez cette ligne dans votre terminal. Votre assistant pourra chercher un matériau et comparer son prix chez les détaillants, sans que vous quittiez votre conversation.

Compte gratuit accepté

Un compte gratuit suffit pour brancher votre assistant, avec 5 comparaisons par mois, les mêmes que sur le site. Les forfaits payants en donnent davantage.

claude mcp add --transport http -s user batirarabais https://batirarabais.ca/api/mcp

1. Collez la commande

Aucune clé à générer, aucun fichier à modifier. La même ligne fonctionne pour tout le monde.

2. Connectez votre compte

Au premier usage, votre navigateur s’ouvre sur batirarabais.ca. Vous vous connectez avec le compte que vous avez déjà, vous autorisez, et c’est terminé.

3. Demandez un prix

Par exemple : « Compare le prix du 2x4x8 épinette » ou « Quel détaillant est le moins cher pour du gypse 5/8 ? »

Ce que votre assistant peut faire

Chercher un matériauTrouver le bon produit dans le catalogue. Gratuit.
Comparer les prixLe prix du produit chez chaque détaillant, du moins cher au plus cher. Coûte 1 comparaison.
Parcourir une vitrineCéramique, vanités, robinets : filtrer par couleur, format ou fini, avec les photos et les prix. 1 comparaison par vitrine par mois.
Détaillants à proximitéQuels détaillants desservent votre code postal. Gratuit.
Mon forfaitCombien de comparaisons il vous reste. Gratuit.

Ce que ça consomme

Exactement la même chose que sur le site : 1 produit dont vous consultez les prix égale 1 comparaison de votre forfait. Chercher, lister les détaillants et vérifier votre quota ne coûtent rien. Votre assistant ne peut pas dépasser votre forfait.

Usage permis

Le serveur MCP est offert pour votre usage personnel ou pour les besoins de votre propre entreprise, exactement comme le site. Branchez votre assistant, comparez vos matériaux, bâtissez vos plans d’achat.

Tout autre usage exige notre autorisation écrite préalable. Sont notamment visés :

intégrer nos comparaisons de prix dans votre application, votre site, votre logiciel ou votre produit;
revendre, redistribuer ou afficher nos données à vos propres clients ou utilisateurs;
vous en servir pour bâtir, alimenter ou entraîner un service concurrent.

Sans notre autorisation écrite, ce n’est pas permis. Vous avez un projet commercial en tête ? Écrivez à partenaires@batirarabais.ca, on regarde ça avec plaisir.

Lire les conditions d’utilisation

Autres assistants

N’importe quel client qui parle MCP par HTTP fonctionne. Pointez-le sur l’adresse ci-dessous, il découvrira tout seul comment vous faire connecter.

https://batirarabais.ca/api/mcp

Si la page « localhost » n’ouvre pas

Après avoir autorisé, votre navigateur revient vers une adresse qui commence par localhost. C’est votre assistant lui-même qui écoute là, sur votre ordinateur, le temps de finir la connexion. S’il a cessé d’écouter, la page reste blanche ou affiche une erreur. Rien n’est perdu : copiez l’adresse complète de cette page et collez-la dans votre assistant, la connexion se termine toute seule.

Le plus simple pour l’éviter : connectez-vous à votre compte Bâtir à Rabais avant de lancer la commande. L’autorisation prend alors deux secondes au lieu du temps de vous connecter.

Référence technique

Pour les développeurs et les plateformes d’assistants. Votre client MCP reçoit déjà la liste des outils et de leurs paramètres à la connexion. Cette section la rend lisible.

Adresse: https://batirarabais.ca/api/mcp
Transport: HTTP streamable : POST en JSON-RPC 2.0, sans état (aucun en-tête Mcp-Session-Id). GET et DELETE répondent 405.
Authentification: OAuth 2.1 avec PKCE S256 obligatoire. Clients publics seulement, sans secret, avec enregistrement dynamique (RFC 7591). Sans jeton, le serveur répond 401 avec un en-tête WWW-Authenticate qui pointe vers la découverte.
Découverte: https://batirarabais.ca/.well-known/oauth-protected-resource https://batirarabais.ca/.well-known/oauth-authorization-server
Permissions: catalogue:read pour chercher, comparaisons:consume pour comparer les prix, offline_access pour rester connecté.
Langue et territoire: Les réponses sont en français. Le catalogue et les détaillants couvrent le Québec.

Les outils

search_materials
Paramètres : query (texte, requis), limit (entier, facultatif)
Renvoie : Les produits du catalogue qui correspondent, avec leur canonical_id et le lien de leur fiche. Aucun prix.
Coût : Gratuit
compare_prices
Paramètres : canonical_id ou slug (l’un des deux)
Renvoie : Le prix chez chaque détaillant, du moins cher au plus cher, avec le prix à l’unité, le lien du produit, l’écart en % et les comparaisons restantes.
Coût : 1 comparaison à chaque appel
browse_vitrine
Paramètres : canonical_id ou slug ; color, format, finish, brand, style et q en texte libre ; page, limit ; with_prices (vrai par défaut)
Renvoie : Les modèles filtrés (photo, prix, fournisseur, lien d’achat), les filtres disponibles et le lien de la vitrine filtrée sur batirarabais.ca.
Coût : 1 comparaison au premier appel avec prix sur une vitrine, puis gratuit pour la période ; gratuit sans les prix
retailers_near
Paramètres : postal_code, ou lat et lng ; radius_km (facultatif)
Renvoie : Les détaillants qui ont une succursale dans le rayon.
Coût : Gratuit
my_quota
Paramètres : Aucun
Renvoie : Le forfait, les comparaisons utilisées et restantes, et le début de la période.
Coût : Gratuit

Les erreurs

Une erreur d’outil arrive comme un résultat marqué isError, jamais comme une erreur HTTP, pour que votre assistant puisse vous en lire la raison.

quota_exceeded : plus aucune comparaison pour la période. Rien n’est consulté ni facturé.
Produit introuvable : aucune comparaison n’est consommée (charged: 0). Relancez search_materials.
use_browse_vitrine : compare_prices sur une vitrine renvoie vers browse_vitrine, sans rien consommer.
401 sans jeton ou avec un jeton expiré : votre client relance la connexion tout seul.

Créer un compte gratuit Voir les forfaits