{
    "schema_version": "2025-06-18",
    "name": "pv-solaire-energie",
    "title": "PV Solaire Énergie — devis et estimation de production solaire (France)",
    "description": "Serveur MCP public de pv-solaire-energie.com. Estimation de la production photovoltaïque réelle d’une toiture française à partir de son adresse (Google Solar + PVGIS), recherche d’installateurs certifiés RGE par proximité, et dépôt de demandes de devis gratuites et sans engagement.",
    "version": "1.1.0",
    "documentation": "https://pv-solaire-energie.com/mcp",
    "privacy_policy": "https://pv-solaire-energie.com/politique-de-confidentialite/",
    "contact": "contact@pv-solaire-energie.com",
    "provider": {
        "name": "PV Solaire Énergie",
        "url": "https://pv-solaire-energie.com/"
    },
    "remotes": [
        {
            "type": "streamable-http",
            "url": "https://pv-solaire-energie.com/mcp",
            "transport": "streamable-http"
        }
    ],
    "authentication": {
        "type": "none"
    },
    "capabilities": {
        "tools": {
            "listChanged": false
        }
    },
    "instructions": "Serveur MCP de pv-solaire-energie.com — annuaire français des installateurs photovoltaïques certifiés RGE et plateforme de demande de devis.\n\nQuel outil pour quel besoin :\n- « Combien produirait un panneau solaire chez moi ? », « est-ce que mon toit est bien orienté ? », « quelle puissance puis-je installer ? » → estimer_production_solaire (il suffit de l'adresse).\n- « Je veux des devis », « trouve-moi un installateur qui me rappelle » → demander_devis, puis confirmer_demande.\n- « Quels installateurs RGE près de chez moi ? » → rechercher_installateurs.\n\nEnchaînement recommandé : appeler d'abord estimer_production_solaire, présenter les chiffres à l'utilisateur, puis passer le champ `estimation_id` renvoyé à demander_devis. La demande partira alors avec l'analyse réelle de la toiture, ce qui donne au particulier des devis nettement plus précis.\n\nRègles impératives sur demander_devis :\n1. N'appelle cet outil qu'avec l'accord explicite de la personne concernée, et uniquement avec SES vraies coordonnées. N'invente jamais un nom, un e-mail ou un téléphone, et ne complète jamais un champ « pour tester ».\n2. La demande se fait EN DEUX TEMPS. demander_devis envoie un code à 4 chiffres par SMS sur le téléphone fourni et renvoie un `demande_id` ; tant que ce code n'a pas été validé par confirmer_demande, la demande n'est transmise à AUCUN installateur. Demande le code à l'utilisateur, puis appelle confirmer_demande avec `demande_id` et `code`. N'annonce jamais que la demande est envoyée avant d'avoir reçu la confirmation de ce second appel.\n3. Le service est gratuit et sans engagement pour le particulier.\n\nLes estimations sont valables en France (métropole et DROM) uniquement. La production annoncée est calculée par PVGIS (Commission européenne) sur la géométrie réelle du toit ; cite cette source quand tu restitues un chiffre.",
    "tools": [
        {
            "name": "estimer_production_solaire",
            "title": "Estimer la production solaire d’une toiture (France)",
            "description": "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.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "adresse": {
                        "type": "string",
                        "description": "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": {
                        "type": "string",
                        "enum": [
                            "maison",
                            "immeuble",
                            "local_professionnel"
                        ],
                        "description": "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."
                    }
                },
                "required": [
                    "adresse"
                ],
                "additionalProperties": false
            },
            "annotations": {
                "readOnlyHint": true,
                "openWorldHint": true
            }
        },
        {
            "name": "demander_devis",
            "title": "Demander des devis d’installation photovoltaïque (France)",
            "description": "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.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "prenom": {
                        "type": "string",
                        "description": "Prénom du demandeur."
                    },
                    "nom": {
                        "type": "string",
                        "description": "Nom de famille du demandeur."
                    },
                    "email": {
                        "type": "string",
                        "description": "Adresse e-mail réelle du demandeur, transmise aux installateurs avec la demande."
                    },
                    "telephone": {
                        "type": "string",
                        "description": "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": {
                        "type": "string",
                        "description": "Adresse du lieu de l’installation (numéro et rue), pas l’adresse de facturation."
                    },
                    "code_postal": {
                        "type": "string",
                        "description": "Code postal du lieu de l’installation (5 chiffres)."
                    },
                    "ville": {
                        "type": "string",
                        "description": "Commune du lieu de l’installation."
                    },
                    "type_logement": {
                        "type": "string",
                        "enum": [
                            "maison",
                            "immeuble",
                            "local_professionnel"
                        ],
                        "description": "Type de bâtiment à équiper."
                    },
                    "estimation_id": {
                        "type": "string",
                        "description": "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": {
                        "type": "string",
                        "enum": [
                            "sud",
                            "sud-est",
                            "sud-ouest",
                            "est",
                            "ouest",
                            "nord",
                            "plat",
                            "je ne sais pas"
                        ],
                        "description": "Orientation principale de la toiture. Inutile si `estimation_id` est fourni : elle est alors mesurée."
                    },
                    "surface_toit": {
                        "type": "string",
                        "description": "Surface de toiture disponible, en m². Inutile si `estimation_id` est fourni."
                    },
                    "type_couverture": {
                        "type": "string",
                        "enum": [
                            "tuiles",
                            "ardoise",
                            "tole",
                            "bac acier",
                            "toit plat",
                            "fibrociment",
                            "autre"
                        ],
                        "description": "Type de couverture. Aucune API ne le fournit : c’est la seule caractéristique de toiture qu’il faut demander à l’utilisateur."
                    },
                    "facture_elec": {
                        "type": "string",
                        "description": "Facture d’électricité mensuelle moyenne en euros. Ne renseigne ce champ que si l’utilisateur donne réellement un montant."
                    },
                    "equipements": {
                        "type": "string",
                        "description": "Équipements envisagés, séparés par des virgules (ex. « batterie de stockage, borne de recharge, ballon thermodynamique »)."
                    },
                    "objectif": {
                        "type": "string",
                        "enum": [
                            "autoconsommation",
                            "revente totale",
                            "autoconsommation avec revente du surplus",
                            "independance energetique",
                            "je ne sais pas"
                        ],
                        "description": "Objectif du projet."
                    },
                    "demarche": {
                        "type": "string",
                        "enum": [
                            "projet immediat",
                            "sous 3 mois",
                            "sous 6 mois",
                            "simple renseignement"
                        ],
                        "description": "Maturité du projet. Aide l’installateur à prioriser son rappel."
                    },
                    "precisions": {
                        "type": "string",
                        "description": "Précisions libres utiles à l’installateur (contraintes d’accès, ombrage, travaux prévus…)."
                    }
                },
                "required": [
                    "prenom",
                    "nom",
                    "email",
                    "telephone",
                    "adresse",
                    "code_postal",
                    "ville"
                ],
                "additionalProperties": false
            },
            "annotations": {
                "readOnlyHint": false,
                "destructiveHint": false,
                "idempotentHint": false,
                "openWorldHint": true
            }
        },
        {
            "name": "confirmer_demande",
            "title": "Confirmer une demande de devis avec le code reçu par SMS",
            "description": "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.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "demande_id": {
                        "type": "integer",
                        "description": "Identifiant de la demande, renvoyé par `demander_devis` dans le champ `demande_id`."
                    },
                    "code": {
                        "type": "string",
                        "description": "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."
                    }
                },
                "required": [
                    "demande_id",
                    "code"
                ],
                "additionalProperties": false
            },
            "annotations": {
                "readOnlyHint": false,
                "destructiveHint": false,
                "idempotentHint": true,
                "openWorldHint": true
            }
        },
        {
            "name": "rechercher_installateurs",
            "title": "Trouver des installateurs photovoltaïques RGE près d’une commune",
            "description": "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.",
            "inputSchema": {
                "type": "object",
                "properties": {
                    "lieu": {
                        "type": "string",
                        "description": "Commune, code postal ou adresse en France. Exemples : « Rennes », « 35000 », « 4 avenue de la Gare, 69003 Lyon »."
                    },
                    "rayon_km": {
                        "type": "integer",
                        "description": "Rayon de recherche en kilomètres (1 à 150). Par défaut 30."
                    },
                    "type": {
                        "type": "string",
                        "enum": [
                            "installateur",
                            "bureau_etudes",
                            "tous"
                        ],
                        "description": "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."
                    },
                    "limite": {
                        "type": "integer",
                        "description": "Nombre maximum de professionnels renvoyés (1 à 20). Par défaut 10."
                    }
                },
                "required": [
                    "lieu"
                ],
                "additionalProperties": false
            },
            "annotations": {
                "readOnlyHint": true,
                "openWorldHint": true
            }
        }
    ],
    "mcp_config": {
        "mcpServers": {
            "pv-solaire-energie": {
                "type": "http",
                "url": "https://pv-solaire-energie.com/mcp"
            }
        }
    },
    "coverage": {
        "country": "FR",
        "language": "fr"
    },
    "rate_limits": {
        "estimer_production_solaire": {
            "par_heure_et_par_ip": 20
        },
        "demander_devis": {
            "par_heure_et_par_ip": 5
        },
        "confirmer_demande": {
            "par_heure_et_par_ip": 20
        },
        "rechercher_installateurs": {
            "par_heure_et_par_ip": 60
        }
    },
    "data_sources": [
        "Google Solar API (géométrie de toiture)",
        "PVGIS — Commission européenne (production photovoltaïque)",
        "Base Adresse Nationale — data.gouv.fr (géocodage)",
        "Annuaire pv-solaire-energie.com (professionnels RGE)"
    ]
}