Pour les agents IA et leurs développeurs

Serveur MCP de Vosthermos

Un assistant IA (Claude, ChatGPT, Cursor ou tout autre client du protocole MCP) peut interroger Vosthermos directement : diagnostiquer un problème de porte ou de fenêtre, lire les prix publiés, estimer une vitre thermos, vérifier qu'une ville est desservie et donner le lien de rendez-vous.

Adresse du serveur

https://www.vosthermos.com/api/mcp
  • Transport : HTTP (Streamable HTTP), messages JSON-RPC 2.0 envoyés en POST
  • Versions de la norme MCP : 2026-07-28 (sans poignée de main), et les versions antérieures 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05 pour les clients qui ouvrent encore par initialize
  • Authentification : aucune, le serveur est public
  • Lecture seule : aucun outil n'écrit, n'envoie ni ne réserve quoi que ce soit
  • Limite : 60 requêtes par minute et par adresse IP
  • CORS : ouvert, le serveur s'appelle aussi depuis un navigateur

Les prix rendus par les outils sont ceux des pages de prix du site, lus à la même source : un assistant ne peut pas citer un autre montant que celui que vous voyez sur la page.

Outils disponibles (11)

diagnose_window_door_problem

Diagnostiquer un problème de porte ou de fenêtre

Diagnostique un problème de fenêtre, de porte-patio ou de porte à partir d'une description en langage naturel (ex. « ma porte patio glisse mal », « buée entre les vitres »). Rend le service recommandé, la fourchette de prix publiée et la page à consulter.

  • description (obligatoire) : Description du problème, dans les mots du client.
  • symptoms (facultatif) : Symptômes précis (facultatif).

estimate_thermos_replacement_cost

Estimer le prix d'une vitre thermos

Estime le prix de remplacement d'une vitre thermos (unité scellée) selon ses dimensions en pouces, taxes incluses, aux tarifs en vigueur. Rend aussi la fourchette du désembuage, l'autre option. Pour un prix exact : soumission gratuite.

  • widthInches (obligatoire) : Largeur de la vitre, en pouces (1 à 240).
  • heightInches (obligatoire) : Hauteur de la vitre, en pouces (1 à 240).
  • quantity (facultatif) : Nombre de vitres identiques (1 à 20, défaut 1).

estimate_energy_savings

Estimer les économies d'énergie

Estimation indicative des économies de chauffage quand on passe à des vitrages plus performants (Low-E argon ou triple). Ordre de grandeur seulement, pas une soumission.

  • windowCount (obligatoire) : Nombre de fenêtres concernées (1 à 200).
  • oldType (facultatif) : Vitrage actuel.
  • newType (facultatif) : Vitrage visé.
  • houseAgeYears (facultatif) : Âge de la maison, en années (facultatif).
  • currentHydroMonthly (facultatif) : Facture d'électricité mensuelle, en dollars canadiens (facultatif, 180 par défaut).

compare_repair_vs_replace

Réparer ou remplacer ?

Compare la réparation et le remplacement pour un problème donné, selon l'âge de la fenêtre ou de la porte et l'état du cadre. Rend une recommandation, les prix publiés des deux options et le tableau de comparaison de la page de prix.

  • problem (obligatoire) : Description du problème.
  • windowAgeYears (facultatif) : Âge de la fenêtre ou de la porte, en années (défaut 15).
  • frameStatus (facultatif) : État du cadre : bon, déformé ou pourri.

check_window_warranty

Vérifier une garantie

Calcule si une fenêtre serait encore sous garantie d'après sa date d'installation et la durée de garantie du fabricant (10 ans par défaut). Rappelle aussi la garantie de Vosthermos sur ses propres travaux.

  • installDate (obligatoire) : Date d'installation, format AAAA-MM-JJ.
  • windowBrand (facultatif) : Fabricant (facultatif).
  • warrantyYears (facultatif) : Durée de la garantie du fabricant, en années (défaut 10).

get_service_pricing

Prix d'un service

Rend les prix publiés d'un service de Vosthermos : prix de départ, fourchette, grille détaillée (une ligne par type de travail) et page de prix. Services : remplacement-quincaillerie, remplacement-vitre-thermos, reparation-portes-bois, moustiquaires-sur-mesure, calfeutrage, desembuage, insertion-porte, coupe-froid, reparation-porte-patio, reparation-porte-fenetre.

  • serviceSlug (obligatoire) : Identifiant du service. Valeurs : remplacement-quincaillerie, remplacement-vitre-thermos, reparation-portes-bois, moustiquaires-sur-mesure, calfeutrage, desembuage, insertion-porte, coupe-froid, reparation-porte-patio, reparation-porte-fenetre. Le nom courant est aussi compris (« porte patio », « thermos », « moustiquaire »).

list_services

Liste des services

Liste les services de Vosthermos avec leur description, leur prix de départ, leur fourchette de prix et leurs pages.

Aucun argument.

list_service_cities

Villes desservies

Liste les villes qui ont une page (Rive-Sud, Montréal, Laval, Montérégie, Laurentides, Lanaudière) et le rayon de service.

Aucun argument.

check_service_area

Cette ville est-elle desservie ?

Dit si Vosthermos dessert une ville ou un quartier donné et rend la page de cette ville. À utiliser quand le client dit où il habite.

  • city (obligatoire) : Ville ou quartier (ex. « Longueuil », « Chomedey », « St-Bruno »).

get_business_info

Coordonnées et heures d'ouverture

Rend les coordonnées de Vosthermos : téléphone, courriel, adresse, heures d'ouverture, licence RBQ, garanties, zone desservie, marques dont on tient les pièces.

Aucun argument.

book_appointment_url

Prendre rendez-vous

Rend l'adresse de prise de rendez-vous en ligne, le téléphone et les heures d'ouverture. À utiliser quand le client veut passer à l'action (soumission gratuite, visite, appel). Cet outil ne réserve rien : il donne le lien.

  • serviceType (facultatif) : Service souhaité (facultatif).
  • preferredDate (facultatif) : Date souhaitée (facultatif).

Ressources (4)

Les mêmes données, en JSON, pour les clients qui lisent des ressources :

  • vosthermos://services : Les 10 services de Vosthermos : description, prix de départ, fourchette, questions fréquentes.
  • vosthermos://cities : Les 62 villes qui ont une page, avec leur région et leurs particularités.
  • vosthermos://pricing : Prix publiés de chaque service : prix de départ, fourchette et grille détaillée.
  • vosthermos://business-info : Téléphone, adresse, heures d'ouverture, licence RBQ, garanties, zone desservie.

Gabarits de requête (2)

  • diagnose_window_issue : Diagnostiquer un problème de fenêtre ou de porte avec les outils de Vosthermos.
  • get_repair_quote : Obtenir le prix publié d'une réparation et la marche à suivre pour une soumission.

Brancher un assistant

Dans un client qui accepte un serveur MCP distant, il suffit de donner l'adresse du serveur ; aucune clé n'est demandée. Avec Claude Code, par exemple :

claude mcp add --transport http vosthermos https://www.vosthermos.com/api/mcp

Pour un client qui ne lance que des serveurs locaux, le pont mcp-remote fait le relais :

{
  "mcpServers": {
    "vosthermos": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.vosthermos.com/api/mcp"]
    }
  }
}

Exemple d'appel

Un appel conforme à la norme 2026-07-28 porte sa version dans les en-têtes et dans _meta :

curl -X POST https://www.vosthermos.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: tools/call" \
  -H "Mcp-Name: get_service_pricing" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_service_pricing",
      "arguments": { "serviceSlug": "reparation-porte-patio" },
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

Un appel écrit à la main, sans version, est accepté aussi (règles des versions antérieures) :

curl -X POST https://www.vosthermos.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "diagnose_window_door_problem",
      "arguments": { "description": "Ma porte patio est difficile à glisser" }
    }
  }'

Une erreur de saisie (service inconnu, dimension hors bornes) revient avec isError: true et les valeurs permises : l'assistant peut se corriger et rappeler l'outil.

Exemple de conversation

La personne :

« Ma porte patio est difficile à glisser depuis cet hiver. Je suis à Longueuil. Combien ça pourrait coûter ? »

L'assistant, avec le serveur MCP de Vosthermos :

[Appelle diagnose_window_door_problem : « Porte-patio qui glisse mal »]
[Appelle get_service_pricing : 75 $ à 300 $ selon la réparation]
[Appelle check_service_area : Longueuil est desservie]
[Appelle book_appointment_url : lien de rendez-vous]

« D'après Vosthermos, cela ressemble au problème « Porte-patio qui glisse mal ». Le prix publié est de 75 $ à 300 $ selon la réparation ; le prix exact est confirmé par une soumission gratuite. Vosthermos dessert Longueuil : réservez sur vosthermos.com/rendez-vous ou appelez le 514-825-8411. »

Sans le protocole MCP

Les mêmes renseignements se lisent aussi sans client MCP :

Pourquoi ce serveur existe

De plus en plus de gens demandent à un assistant IA quoi faire d'une vitre embuée ou d'une porte-patio qui glisse mal. Ce serveur donne à l'assistant les réponses de Vosthermos à la source : le bon service, le prix publié et la façon de prendre rendez-vous, avec la page du site à citer pour que la personne puisse vérifier.

Il est gratuit et public. Si vous l'intégrez à un agent, écrivez-nous : nous aimons savoir ce qui se construit avec.

Une question sur le serveur ?

Écrivez à info@vosthermos.com.

Voir la description du serveur (JSON)