# PV Solaire Énergie

> Annuaire français des installateurs photovoltaïques certifiés RGE (plus de 8 000 fiches géolocalisées) et plateforme de demande de devis pour les particuliers et les professionnels. Le site expose un **serveur MCP public et sans clé d’API** qui permet à un assistant IA d’estimer la production solaire réelle d’une toiture à partir de son adresse, de trouver des installateurs certifiés à proximité, et de déposer une demande de devis pour le compte d’un utilisateur consentant.

## Serveur MCP (Model Context Protocol)

- **Endpoint** : `https://pv-solaire-energie.com/mcp` (POST, JSON-RPC 2.0, transport Streamable HTTP)
- **Authentification** : aucune. Serveur public, ouvert à tout client MCP.
- **Manifeste** : https://pv-solaire-energie.com/.well-known/mcp.json
- **Documentation** : https://pv-solaire-energie.com/mcp
- **Périmètre géographique** : France (métropole et DROM).
- **Langue** : français.

Configuration pour un client MCP :

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

### Outils disponibles

#### `estimer_production_solaire`

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ètres :
- `adresse` (string) **(obligatoire)** : 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`, `immeuble`, `local_professionnel`

#### `demander_devis`

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ètres :
- `prenom` (string) **(obligatoire)** : Prénom du demandeur.
- `nom` (string) **(obligatoire)** : Nom de famille du demandeur.
- `email` (string) **(obligatoire)** : Adresse e-mail réelle du demandeur, transmise aux installateurs avec la demande.
- `telephone` (string) **(obligatoire)** : 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) **(obligatoire)** : Adresse du lieu de l’installation (numéro et rue), pas l’adresse de facturation.
- `code_postal` (string) **(obligatoire)** : Code postal du lieu de l’installation (5 chiffres).
- `ville` (string) **(obligatoire)** : Commune du lieu de l’installation.
- `type_logement` (string) : Type de bâtiment à équiper. — valeurs : `maison`, `immeuble`, `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`, `sud-est`, `sud-ouest`, `est`, `ouest`, `nord`, `plat`, `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`, `ardoise`, `tole`, `bac acier`, `toit plat`, `fibrociment`, `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`, `revente totale`, `autoconsommation avec revente du surplus`, `independance energetique`, `je ne sais pas`
- `demarche` (string) : Maturité du projet. Aide l’installateur à prioriser son rappel. — valeurs : `projet immediat`, `sous 3 mois`, `sous 6 mois`, `simple renseignement`
- `precisions` (string) : Précisions libres utiles à l’installateur (contraintes d’accès, ombrage, travaux prévus…).

#### `confirmer_demande`

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ètres :
- `demande_id` (integer) **(obligatoire)** : Identifiant de la demande, renvoyé par `demander_devis` dans le champ `demande_id`.
- `code` (string) **(obligatoire)** : 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.

#### `rechercher_installateurs`

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ètres :
- `lieu` (string) **(obligatoire)** : 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`, `bureau_etudes`, `tous`
- `limite` (integer) : Nombre maximum de professionnels renvoyés (1 à 20). Par défaut 10.

### Conditions d’usage du serveur MCP

- `estimer_production_solaire` et `rechercher_installateurs` sont en lecture seule et peuvent être appelés librement.
- `demander_devis` écrit une donnée personnelle réelle : ne l’appeler qu’avec l’accord explicite de la personne concernée et avec ses vraies coordonnées. La demande se fait en deux temps — `demander_devis` envoie un code à 4 chiffres par SMS, `confirmer_demande` le valide. Tant que ce second appel n’a pas réussi, la demande n’est transmise à aucun installateur.
- Limitation de débit par adresse IP et par outil, par heure : 20 × estimer_production_solaire, 5 × demander_devis, 20 × confirmer_demande, 60 × rechercher_installateurs.

## Méthodologie des estimations

- **Géométrie de la toiture** : relevé 3D Google Solar API (surface, orientation, inclinaison, implantation des panneaux).
- **Production annuelle** : PVGIS, l’outil de référence de la Commission européenne (https://re.jrc.ec.europa.eu/pvg_tools/). C’est cette source qui fait foi pour tout chiffre de production communiqué, et elle doit être citée.
- **Géocodage** : Base Adresse Nationale, api-adresse.data.gouv.fr.
- La puissance proposée pour une maison 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, cheminées et reculs de rive que le relevé 3D ne modélise pas.
- Repère de cohérence : la productivité d’une installation française se situe entre 750 et 1 450 kWh par kWc et par an, selon la latitude et l’orientation.

## Pages clés

- [Serveur MCP](https://pv-solaire-energie.com/mcp) : documentation de l’intégration pour les assistants IA.
- [Demande de devis](https://pv-solaire-energie.com/demande-de-devis-installation-solaire/) : le même parcours, en version web pour un humain.
- [Annuaire des professionnels du solaire](https://pv-solaire-energie.com/annuaire-des-professionnels-du-solaire) : les fiches installateurs et bureaux d’études.
- [Accueil](https://pv-solaire-energie.com/)

## Contact

contact@pv-solaire-energie.com