Model Context Protocol · Public · Sans clé d’API

Serveur MCP : estimation de production solaire et demande de devis par une IA

Branchez votre assistant IA sur pv-solaire-energie.com et laissez-le estimer la production photovoltaïque réelle d’une toiture française à partir de sa seule adresse, trouver des installateurs certifiés RGE à proximité, et déposer une demande de devis pour un utilisateur consentant.

POST https://pv-solaire-energie.com/mcp

Se connecter

Le serveur est public, gratuit et sans authentification. Il parle JSON-RPC 2.0 sur le transport Streamable HTTP. Ajoutez-le comme serveur MCP distant dans n’importe quel client compatible (Claude, ChatGPT, Cursor, VS Code, Zed, ou votre propre agent) :

{
    "mcpServers": {
        "pv-solaire-energie": {
            "type": "http",
            "url": "https://pv-solaire-energie.com/mcp"
        }
    }
}

Endpoint	`https://pv-solaire-energie.com/mcp` (POST)
Transport	Streamable HTTP — JSON-RPC 2.0
Authentification	Aucune
Manifeste	https://pv-solaire-energie.com/.well-known/mcp.json
Index pour IA	https://pv-solaire-energie.com/llms.txt
Couverture	France — métropole et DROM
Version	1.1.0

Les 4 outils

estimer_production_solaire lecture seule

Calcule le potentiel photovoltaïque réel d’une toiture située en France, à partir de sa seule adresse postale : puissance installable en kWc, production annuelle en kWh, nombre de panneaux, surface exploitable, orientation, inclinaison du pan de toit et heures d’ensoleillement. L’analyse porte sur la géométrie 3D réelle du bâtiment (relevé Google Solar) et la production est calculée par PVGIS, l’outil officiel de la Commission européenne — ce n’est ni une moyenne régionale ni une règle de trois au m². Renvoie également, quand elle est disponible, une carte de chaleur du rendement de la toiture, et un `estimation_id` à repasser à `demander_devis` pour joindre cette analyse à la demande. Utilise cet outil dès qu’un utilisateur demande combien produirait une installation solaire chez lui, si son toit est bien orienté, quelle puissance il peut installer, ou quelles économies il peut espérer.

Paramètre	Type	Description
`adresse` *	string	Adresse postale complète en France (numéro, rue, code postal, commune). Exemple : « 12 rue des Lilas, 31000 Toulouse ». Une adresse imprécise (commune seule) donne une estimation dégradée : demande le numéro et la rue à l’utilisateur avant d’appeler l’outil.
`type_batiment`	string	Type de bâtiment. Change réellement le résultat : une maison est bornée aux paliers commerciaux 3/6/9 kWc du résidentiel, un immeuble ou un local professionnel non. Par défaut : maison. Valeurs : `maison</code>, <code>immeuble</code>, <code>local_professionnel`

Limite : 20 appels par heure et par adresse IP. * paramètre obligatoire.

demander_devis écriture

Dépose une demande de devis gratuite et sans engagement pour une installation de panneaux solaires en France. La demande est transmise à des installateurs certifiés RGE proches du lieu du projet, qui recontactent directement le particulier. ⚠️ PREMIÈRE ÉTAPE SUR DEUX. Cet outil envoie un code à 4 chiffres par SMS sur le téléphone fourni et renvoie un `demande_id` : la demande n’est transmise à AUCUN installateur tant que ce code n’a pas été validé via `confirmer_demande`. Demande le code à l’utilisateur puis appelle `confirmer_demande`. N’annonce jamais la demande comme envoyée avant ce second appel. N’appelle cet outil qu’avec l’accord explicite de la personne concernée et avec ses vraies coordonnées — jamais avec des données inventées ou de test. Appelle d’abord `estimer_production_solaire` et transmets son `estimation_id` : les devis reçus seront bien plus précis.

Paramètre	Type	Description
`prenom` *	string	Prénom du demandeur.
`nom` *	string	Nom de famille du demandeur.
`email` *	string	Adresse e-mail réelle du demandeur, transmise aux installateurs avec la demande.
`telephone` *	string	Téléphone MOBILE réel du demandeur, au format français (10 chiffres ou +33). Le code de confirmation à 4 chiffres y est envoyé par SMS : un numéro fixe ou erroné empêche définitivement la demande d’aboutir. C’est aussi le canal par lequel les installateurs rappellent.
`adresse` *	string	Adresse du lieu de l’installation (numéro et rue), pas l’adresse de facturation.
`code_postal` *	string	Code postal du lieu de l’installation (5 chiffres).
`ville` *	string	Commune du lieu de l’installation.
`type_logement`	string	Type de bâtiment à équiper. Valeurs : `maison</code>, <code>immeuble</code>, <code>local_professionnel`
`estimation_id`	string	Identifiant renvoyé par `estimer_production_solaire` pour la même adresse. Fortement recommandé : il attache l’analyse réelle de la toiture à la demande. Valable 2 heures.
`orientation`	string	Orientation principale de la toiture. Inutile si `estimation_id` est fourni : elle est alors mesurée. Valeurs : `sud</code>, <code>sud-est</code>, <code>sud-ouest</code>, <code>est</code>, <code>ouest</code>, <code>nord</code>, <code>plat</code>, <code>je ne sais pas`
`surface_toit`	string	Surface de toiture disponible, en m². Inutile si `estimation_id` est fourni.
`type_couverture`	string	Type de couverture. Aucune API ne le fournit : c’est la seule caractéristique de toiture qu’il faut demander à l’utilisateur. Valeurs : `tuiles</code>, <code>ardoise</code>, <code>tole</code>, <code>bac acier</code>, <code>toit plat</code>, <code>fibrociment</code>, <code>autre`
`facture_elec`	string	Facture d’électricité mensuelle moyenne en euros. Ne renseigne ce champ que si l’utilisateur donne réellement un montant.
`equipements`	string	Équipements envisagés, séparés par des virgules (ex. « batterie de stockage, borne de recharge, ballon thermodynamique »).
`objectif`	string	Objectif du projet. Valeurs : `autoconsommation</code>, <code>revente totale</code>, <code>autoconsommation avec revente du surplus</code>, <code>independance energetique</code>, <code>je ne sais pas`
`demarche`	string	Maturité du projet. Aide l’installateur à prioriser son rappel. Valeurs : `projet immediat</code>, <code>sous 3 mois</code>, <code>sous 6 mois</code>, <code>simple renseignement`
`precisions`	string	Précisions libres utiles à l’installateur (contraintes d’accès, ombrage, travaux prévus…).

Limite : 5 appels par heure et par adresse IP. * paramètre obligatoire.

confirmer_demande écriture

Valide une demande de devis créée par `demander_devis`, à l’aide du code à 4 chiffres envoyé par SMS au demandeur. C’est cette validation, et elle seule, qui autorise la transmission de la demande aux installateurs certifiés RGE. Demande le code à l’utilisateur (il l’a reçu sur son mobile, valable 30 minutes) et appelle cet outil avec le `demande_id` renvoyé par `demander_devis`. Si le code est expiré ou après 5 essais infructueux, rappelle `demander_devis` avec exactement les mêmes coordonnées : un nouveau code sera envoyé, sans créer de doublon.

Paramètre	Type	Description
`demande_id` *	integer	Identifiant de la demande, renvoyé par `demander_devis` dans le champ `demande_id`.
`code` *	string	Le code à 4 chiffres que le demandeur a reçu par SMS. Ne l’invente jamais et ne le devine jamais : demande-le à l’utilisateur.

Limite : 20 appels par heure et par adresse IP. * paramètre obligatoire.

rechercher_installateurs lecture seule

Recherche dans l’annuaire pv-solaire-energie.com (plus de 8 000 fiches géolocalisées) les installateurs photovoltaïques et bureaux d’études français situés autour d’une commune ou d’un code postal, triés par distance croissante. Seuls les professionnels dont la qualification RGE (Reconnu Garant de l’Environnement) est encore valide à la date du jour sont renvoyés — c’est la certification qui conditionne l’accès aux aides de l’État et à la prime à l’autoconsommation. Chaque résultat donne le nom, la ville, la distance en km, la date de fin de qualification et l’URL de la fiche. Utilise cet outil quand un utilisateur cherche un professionnel du solaire dans sa région, veut vérifier la présence d’installateurs certifiés près de chez lui, ou compare des entreprises avant de demander un devis.

Paramètre	Type	Description
`lieu` *	string	Commune, code postal ou adresse en France. Exemples : « Rennes », « 35000 », « 4 avenue de la Gare, 69003 Lyon ».
`rayon_km`	integer	Rayon de recherche en kilomètres (1 à 150). Par défaut 30.
`type`	string	Nature du professionnel recherché. Un installateur pose les panneaux ; un bureau d’études réalise l’étude technique et le dimensionnement en amont. Par défaut : installateur. Valeurs : `installateur</code>, <code>bureau_etudes</code>, <code>tous`
`limite`	integer	Nombre maximum de professionnels renvoyés (1 à 20). Par défaut 10.

Limite : 60 appels par heure et par adresse IP. * paramètre obligatoire.

Consentement obligatoire sur demander_devis. Cet outil enregistre les coordonnées réelles d’une personne et déclenche la mise en relation avec des installateurs. Il ne doit être appelé qu’avec l’accord explicite de l’intéressé, et la demande se fait en deux temps : demander_devis envoie un code à 4 chiffres par SMS sur le mobile fourni, puis confirmer_demande valide ce code. Tant que ce second appel n’a pas réussi, la demande n’est transmise à aucun professionnel ; elle est automatiquement abandonnée au bout de 7 jours. C’est le même mécanisme de vérification par SMS que le formulaire du site.

Exemple d’appel

Le protocole en direct, sans client MCP — utile pour tester :

curl -s https://pv-solaire-energie.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "estimer_production_solaire",
      "arguments": {
        "adresse": "1 place du Capitole, 31000 Toulouse",
        "type_batiment": "maison"
      }
    }
  }'

D’où viennent les chiffres

Géométrie de la toiture — relevé 3D de l’API Google Solar : surface exploitable, orientation, inclinaison, implantation des panneaux, heures d’ensoleillement.

Production annuelle — PVGIS, l’outil de référence de la Commission européenne. C’est cette source qui fait foi pour tout chiffre de production, et elle doit être citée lorsqu’un assistant restitue le résultat.

Géocodage — Base Adresse Nationale, data.gouv.fr.

Professionnels — annuaire pv-solaire-energie.com, qualifications RGE issues des données publiques de l’ADEME, filtrées sur leur date de validité à la date de la requête.

Pour une maison, la puissance proposée est alignée sur les paliers réellement commercialisés en France (3, 6 ou 9 kWc), 9 kWc étant le seuil de l’arrêté tarifaire S21. Un abattement est appliqué au potentiel géométrique brut pour tenir compte des velux, souches de cheminée et reculs de rive que le relevé 3D ne modélise pas : mieux vaut une estimation légèrement prudente qu’une promesse que l’installateur devra corriger sur place.

Questions fréquentes

Comment une IA peut-elle estimer la production solaire de mon toit ?

En appelant l’outil estimer_production_solaire du serveur MCP de pv-solaire-energie.com, avec pour seule entrée votre adresse postale. L’analyse porte sur la géométrie 3D réelle de votre toiture et la production annuelle est calculée par PVGIS, l’outil officiel de la Commission européenne. Vous obtenez la puissance installable en kWc, la production en kWh par an, le nombre de panneaux, la surface exploitable, l’orientation et l’inclinaison.

Le serveur MCP est-il gratuit et faut-il une clé d’API ?

Le serveur est entièrement gratuit et ne demande aucune clé d’API ni inscription. L’endpoint https://pv-solaire-energie.com/mcp est ouvert à tout client compatible Model Context Protocol. Une limitation de débit par adresse IP protège le service : 20 estimations, 60 recherches d’installateurs et 5 demandes de devis par heure.

Comment connecter ce serveur MCP à un assistant IA ?

Ajoutez https://pv-solaire-energie.com/mcp comme serveur MCP distant de type HTTP dans la configuration de votre client (Claude, ChatGPT, Cursor, VS Code, ou tout autre client compatible). Aucun jeton d’authentification n’est requis. Le manifeste d’auto-découverte est publié sur https://pv-solaire-energie.com/.well-known/mcp.json.

Une IA peut-elle demander un devis à ma place ?

Oui, via l’outil demander_devis, mais uniquement avec votre accord et vos vraies coordonnées, et la demande se fait en deux temps. Vous recevez d’abord un code à 4 chiffres par SMS sur votre mobile ; vous le communiquez à l’assistant, qui valide la demande via l’outil confirmer_demande. Tant que ce code n’a pas été saisi, la demande n’est transmise à aucun installateur, et elle est automatiquement abandonnée au bout de 7 jours. C’est le même principe de vérification par SMS que le formulaire du site.

Quelles sont les sources des chiffres renvoyés ?

La géométrie de la toiture provient de l’API Google Solar (surface, orientation, inclinaison, implantation des panneaux). La production annuelle en kWh est calculée par PVGIS, l’outil de référence de la Commission européenne. Le géocodage des adresses utilise la Base Adresse Nationale de data.gouv.fr. Les qualifications RGE des professionnels sont issues des données publiques de l’ADEME.

Les installateurs proposés sont-ils bien certifiés RGE ?

Oui. L’outil rechercher_installateurs ne renvoie que des professionnels dont la qualification RGE (Reconnu Garant de l’Environnement) est encore valide à la date de la requête, et indique pour chacun sa date de fin de qualification. C’est cette certification qui conditionne l’accès aux aides de l’État et à la prime à l’autoconsommation.