list_capabilities
Découvrir les capacités Boncourant
Liste les analyses réellement disponibles, les preuves nécessaires, les livrables, les limites, les méthodes et les prochains outils MCP à appeler. Utilisez cet outil en premier quand la demande porte sur l'électricité en France ou que le bon parcours est incertain.
輸入參數audiencecapability_id
hc_schedule_change_impact
Impact d'un changement d'heures creuses
Calcule l’impact de deux horaires explicitement fournis, sans résoudre un horaire depuis une ville. Calcule ce qu'un changement de plages d'heures creuses coûte à l'année, en facturant deux fois la même consommation (avant / après) avec les mêmes prix et le même abonnement. Les horaires viennent du courrier ou de la facture : aucune adresse ne résout des heures creuses, Enedis les attribuant par point de livraison. Accepte une répartition HP/HC facturée ou une consommation annuelle ; la courbe mesurée se lit dans l'étude Boncourant. Les prix sont fournis par l'appelant, toutes taxes comprises, et rien n'est conservé.
輸入參數consumption必填alternativesnew_schedule必填old_schedule必填current_option必填
simulate
Simuler une facture résidentielle
Estimation résidentielle rapide à partir des kWh, kVA, du code postal et de l’option, sans facture extraite ; avec des champs de facture structurés, appelez analyze_bill. Compare les offres évaluées au tarif réglementé et explicite les hypothèses.
輸入參數optionpostal_code必填proportion_hcpuissance_kva必填conso_annuelle_kwh必填
analyze_bill
Analyser une facture résidentielle
Évalue une facture résidentielle déjà extraite (champs structurés) via le moteur versionné ; pour une estimation sur paramètres sans facture, appelez simulate. Il s’agit d’une recommandation prospective, pas du contrôle historique de toutes les lignes facturées. Retourne un verdict explicite stay/switch et l'option tarifaire de chaque offre ; quand aucune offre ne bat le contrat actuel, recommended_offer ne désigne jamais l'offre plus chère du catalogue. MCP est JSON uniquement : extrayez le PDF en amont, puis appelez cet outil avec les champs.
輸入參數optionpostal_code必填conso_kwh_hcconso_kwh_hpcurrent_offerpuissance_kva必填current_supplierconso_annuelle_kwh必填current_annual_cost_eur
get_methodology
Consulter la méthodologie Boncourant
Retourne la méthodologie de calcul, ses sources, hypothèses et limites. Filtrez par method_id, family ou version pour éviter de charger tout le registre ; sans filtre, retourne le registre complet.
輸入參數familyversionmethod_id
decompose_invoice
Décomposer et réconcilier une facture
Agrège des lignes de facture déjà extraites en postes canoniques (énergie, TURPE, accise, CTA, TVA, capacité, CEE, frais) et vérifie que leur somme correspond aux totaux HT/TTC déclarés. Retourne la méthode, sa version et le hash des entrées.
輸入參數line_items必填stated_total_htstated_total_ttc
annualize_invoice
Annualiser une facture
Annualise la consommation et/ou le total TTC d'une période avec les coefficients officiels du profil Enedis correspondant au segment, à l'option et à la puissance. Si les coefficients sont indisponibles, le repli linéaire est explicite et borné pour les kWh.
輸入參數optionsegment必填period_end必填period_kwhperiod_start必填puissance_kva必填period_total_ttc_eur
check_subscribed_power
Vérifier la puissance souscrite
Évalue la puissance à la date demandée sans extrapoler une pointe isolée. Une candidature C5 exige une année de pointes apparentes officielles et les paliers du contrat ; une C4 exige P1 à P4 et reste non concluante si une pointe non étiquetée tombe entre les seuils actifs P1 × 0,93 et P4 × 0,93.
輸入參數max_demand_kwmax_demand_kvamonthly_max_kwsubscribed_kva必填evaluation_date必填monthly_max_kvameasurement_basisconnection_segment必填subscribed_powers_kvameasurement_period_daysavailable_contract_tiers_kva
analyze_renewal_terms
Analyser une échéance contractuelle
Calcule uniquement l’échéance et le préavis à partir des dates et clauses extraites, sans consulter les prix de marché ; pour une décision de renouvellement avec marché et catalogue, appelez renewal_advisor. Ne chiffre pas de pénalité de résiliation. Le type de prix est une valeur canonique, jamais déduit d'un texte libre par cet outil.
輸入參數end_dateauto_renewalpricing_typeevaluation_date必填notice_period_days
assess_historical_optimality
Contrôler l'optimalité historique
Compare un contrat signé uniquement aux offres datées, valides et faisables au moment de la signature, sans utiliser d'information postérieure. La conclusion est limitée aux preuves fournies et ne prétend jamais couvrir tout le marché.
輸入參數contract必填alternatives必填materiality_eur_year
renewal_advisor
Conseiller un renouvellement professionnel
Conseille un renouvellement B2B en combinant préavis, courbe EEX fraîche (eex_connector) et catalogue C5 (pro_catalog) ; pour les seules dates contractuelles sans marché, appelez analyze_renewal_terms. Les prix C4 restent sur devis. Une courbe stale/partielle ne déclenche jamais de décision, et seuls les prix HT fourniture sont comparés au prix verrouillé HT fourniture.
輸入參數segment必填end_datestructureauto_renewalpricing_typebudget_eur_mwhceiling_eur_mwhevaluation_date必填locked_fractionnotice_period_daysannual_consumption_mwhcurrent_locked_supply_eur_mwh必填
run_method
Exécuter une méthode Boncourant versionnée
Exécute directement une méthode pure publiée par get_methodology avec son JSON Schema, sa version et son hash d'entrée. Les méthodes nécessitant un contexte non sérialisable, comme le calendrier Tempo, sont explicitement refusées.
輸入參數input必填contextversionvalid_onmethod_id必填
assess_ppa
Évaluer un PPA pour un client
Produit une analyse PPA conditionnelle pour un acheteur, producteur ou prosumer : avantages, risques contractuels, sensibilités économiques fournies par le client, alternatives, liquidité, fiscalité, administration, garanties d'origine et points de négociation. Pour analyser le texte d'un contrat, appelez d'abord extract_energy_document puis transmettez extract.ppa et extract.reading_coverage. Ne présente jamais un scénario comme une prévision ni une orientation générale comme un avis juridique ou fiscal individualisé.
輸入參數customer必填contracts必填matched_profile
create_analysis_study
Créer une étude temporaire
Crée et lance de façon idempotente une étude MCP temporaire pour n’importe quel outil analytique Boncourant pris en charge. Retourne immédiatement un reçu opaque, un statut et une expiration ; utilisez get_analysis_study pour suivre le traitement. L’entrée brute est supprimée à la fin du job et le résultat expire sous 24 heures. Cette opération crée un état temporaire mais n’agit jamais auprès d’un fournisseur ni d’un compte client.
輸入參數arguments必填target_tool必填capability_iddocument_fileidempotency_key必填
get_analysis_study
Suivre une étude temporaire
Lit l’état queued/running/complete/partial/failed d’une étude temporaire à partir de son reçu secret. Retourne le résultat structuré lorsqu’il est prêt, sans permettre de lister ni d’ouvrir une autre étude.
輸入參數receipt必填
get_analysis_report
Télécharger le rapport d’une étude
Retourne le rapport Markdown d’une étude PPA terminée et une URL PDF privée valable deux minutes. Le reçu secret autorise uniquement cette étude et ne doit pas être journalisé ni partagé.
輸入參數receipt必填
eex_connector
Lire les indicateurs de marché EEX
Lit les indicateurs forward EEX France (CAL Y+1, CAL Y+2, M+1), sans décision contractuelle ; pour une recommandation de renouvellement, appelez renewal_advisor. Lit le snapshot public le plus récent depuis market_observation et indique explicitement quand aucune donnée récente n'est disponible.
輸入參數asof
pro_catalog
Consulter le catalogue professionnel
Lit le catalogue vérifié des offres d'électricité professionnelles (segment C5, jusqu'à 36 kVA) : nombre d'offres actives, fournisseurs, éventail des prix publiés tout compris, répartition fixe / indexée, date du dernier relevé hebdomadaire. Pour le segment C4 (36 à 250 kVA), retourne le nombre de fournisseurs servis — les prix C4 sont sur devis uniquement. Données relevées chaque semaine auprès du comparateur du Médiateur national de l'énergie.
無需輸入參數。