Boncourant

fr.boncourant由 boncourant.fr 發布官方發布者v1.5.1更新於 Oct 24, 2026

Optimiseur et auditeur d'électricité en France : tarifs, contrats, puissance et PPA.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

託管式法國電力優化與稽核服務,讓助理模擬電費、分析合約、核查訂閱功率並評估購電協議。

可以做什麼
列出可用分析、所需證據、交付項目與限制,並讀取計算方法及其來源與假設。依 kWh、kVA、郵遞區號與電價選項快速估算住宅電費,或評估已擷取的帳單並給出續留或更換的結論。將發票拆解為標準費用項目,以官方係數年化用電量,並對照尖峰核查訂閱功率。分析續約期限與通知期,結合 EEX 遠期曲線與專業報價目錄給出 B2B 續約建議,並評估歷史合約是否最佳。擷取 PDF 或文字能源文件,直接執行已發布方法,並產生 PPA 或臨時分析研究與報告。
適用情境
當問題涉及法國電力時使用:家庭或企業帳單、電價選項、尖離峰時段調整、訂閱功率、合約續約、市場價格或購電協議。若不確定該走哪條分析路徑,先呼叫能力清單。
執行需求
遠端 Streamable HTTP 端點,不需本機套件或程序。公用工具不需要帳號、API 金鑰或 OAuth,未宣告環境變數或請求標頭。需要能連線至該託管服務的網路。
安裝前請注意
測試階段,提交用於擷取的文件會傳送給位於中國的第三方服務商,請避免敏感資料。研究會建立會到期的狀態,並可能抓取所提供的文件;回執屬機密,不得記錄或分享。輸出為前瞻性建議,不能證明帳單錯誤或全市場最佳。不提供供應商切換或帳號存取。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Boncourant,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/fr.boncourant%2Fboncourant/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "boncourant": {
      "type": "http",
      "url": "https://boncourant.fr/mcp"
    }
  }
}

README

Boncourant MCP

Public integration documentation for Boncourant, the French electricity-cost optimizer and auditor. This repository contains documentation and public discovery metadata for the hosted service.

Connect

Add the endpoint as a remote HTTP MCP server in your client. Clients using the mcpServers URL configuration format can use:

json
{  "mcpServers": {    "boncourant": {      "url": "https://boncourant.fr/mcp"    }  }}

Client configuration formats vary; use your client's remote Streamable HTTP server instructions. No local package or server process is needed.

Capabilities

Start with list_capabilities to discover supported tasks, evidence requirements and limits. The public server exposes 19 tools as of 15 October 2026:

list_capabilities, hc_schedule_change_impact, simulate, analyze_bill, get_methodology, decompose_invoice, annualize_invoice, check_subscribed_power, analyze_renewal_terms, assess_historical_optimality, renewal_advisor, extract_energy_document, run_method, assess_ppa, create_analysis_study, get_analysis_study, get_analysis_report, eex_connector, pro_catalog.

Use the live manifest or MCP tools/list for current schemas. Available checks depend on the supplied evidence. Retrospective billing findings and prospective savings estimates are distinct; incomplete evidence does not establish a billing error or whole-market optimality.

Privacy and boundaries

The public MCP service does not expose private customer accounts, workspaces, Enedis consent, supplier switching or supplier outreach. Direct document extraction is non-retained. Asynchronous studies use opaque receipts; raw input is encrypted until processing ends, then erased, and results expire within 24 hours. Shared-service rate and size limits apply. Review the integration guidance and privacy policy before submitting documents.

Public metadata

server.json is the official registry publication descriptor. discovery.json is a dated snapshot of the public discovery manifest, not a replacement for live discovery. This repository does not contain the hosted application's implementation.

Contact: [email protected].

Version 1.5.1

Adds repository discovery metadata, clearer tool routing, and explicit temporary-study safety and receipt-access documentation. run_method is read-only. Creating an isolated study writes expiring state and may fetch an explicitly supplied document, so it remains non-destructive and idempotent, with readOnlyHint: false and openWorldHint: true. It never changes a customer account or supplier contract.

來源:README.md,提交 44f691a

工具

19

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必填

extract_energy_document

Extraire et auditer une facture ou un contrat

Extrait en mémoire un PDF ou un texte de facture/contrat, retire les identifiants sensibles de la réponse et lance immédiatement les méthodes déterministes applicables. Pendant la phase de test précédant l'ouverture aux clients, l'extraction est réalisée par DeepSeek, un prestataire situé en Chine, sans garanties de transfert : n'envoyez pas de document contenant des données personnelles réelles. Boncourant ne conserve pas le document ; les champs incertains exigent confirmation.

輸入參數segment必填document_filedocument_kind必填document_textdocument_base64evaluation_date必填

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.

無需輸入參數。

版本歷史

2
  1. v1.5.1最新Oct 15, 2026
  2. v1.5.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。