Skip to content

Boncourant

by boncourant.fr · remote · no sign-in to list tools · v1.5.1 · published by fr.boncourant

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

Changes · 12

19 tools: 12 change things and 7 only read.

Scanned Oct 21, 2026

2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http boncourant https://boncourant.fr/mcp

Findings

Matches of fixed checks, with the text they matched.

2 warn
  • The server marks "hc_schedule_change_impact" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "hc_schedule_change_impact" says "schedule": a word for a change.

    What this check looks for
  • The server marks "run_method" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "run_method" says "run": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

19 tools

Changes things 12Claude Code: ask
  • annualize_invoiceAnnualise 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • assess_ppaProduit une analyse PPA conditionnelle pour un acheteur, producteur ou prosumer : avantages, risques contractuels, sensibilités économiques fournies par le client, alternatives, li…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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é.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • check_subscribed_powerÉvalue la puissance à la date demandée sans extrapoler une pointe isolée.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    É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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • create_analysis_studyCrée et lance de façon idempotente une étude MCP temporaire pour n’importe quel outil analytique Boncourant pris en charge.No findings

    Why it is in this group

    • The name "create_analysis_study" says "create": a word for a change.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • decompose_invoiceAgrè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éc…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • eex_connectorLit 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • extract_energy_documentExtrait 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: true
  • hc_schedule_change_impactCalcule l’impact de deux horaires explicitement fournis, sans résoudre un horaire depuis une ville.1 finding

    Why it is in this group

    • The name "hc_schedule_change_impact" says "schedule": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "hc_schedule_change_impact" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "hc_schedule_change_impact" says "schedule": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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é.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • pro_catalogLit 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ép…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • renewal_advisorConseille 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 a…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • run_methodExécute directement une méthode pure publiée par get_methodology avec son JSON Schema, sa version et son hash d'entrée.1 finding

    Why it is in this group

    • The name "run_method" says "run": a word for a change.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.

    Findings

    • Warn

      The server marks "run_method" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

      Matched text

      annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "run_method" says "run": a word for a change.

      What this check looks for
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • simulateEstimation 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.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
Only reads 7Claude Code: allow
  • analyze_billÉ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.No findings

    Why it is in this group

    • The name "analyze_bill" says "analyze": a word for reading.
    Description, as the server wrote it
    É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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • analyze_renewal_termsCalcule 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 catalogu…No findings

    Why it is in this group

    • The name "analyze_renewal_terms" says "analyze": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • assess_historical_optimalityCompare un contrat signé uniquement aux offres datées, valides et faisables au moment de la signature, sans utiliser d'information postérieure.No findings

    Why it is in this group

    • The description's first verb is "compare": a word for reading.
    Description, as the server wrote it
    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é.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_analysis_reportRetourne le rapport Markdown d’une étude PPA terminée et une URL PDF privée valable deux minutes.No findings

    Why it is in this group

    • The name "get_analysis_report" says "get": a word for reading.
    Description, as the server wrote it
    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é.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_analysis_studyLit l’état queued/running/complete/partial/failed d’une étude temporaire à partir de son reçu secret.No findings

    Why it is in this group

    • The name "get_analysis_study" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_methodologyRetourne la méthodologie de calcul, ses sources, hypothèses et limites.No findings

    Why it is in this group

    • The name "get_methodology" says "get": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • list_capabilitiesListe les analyses réellement disponibles, les preuves nécessaires, les livrables, les limites, les méthodes et les prochains outils MCP à appeler.No findings

    Why it is in this group

    • The name "list_capabilities" says "list": a word for reading.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.5.1. Values in angle brackets are yours to fill in.

claude mcp add --transport http boncourant https://boncourant.fr/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__boncourant__list_capabilities",
      "mcp__boncourant__analyze_bill",
      "mcp__boncourant__get_methodology",
      "mcp__boncourant__analyze_renewal_terms",
      "mcp__boncourant__assess_historical_optimality",
      "mcp__boncourant__get_analysis_study",
      "mcp__boncourant__get_analysis_report"
    ],
    "ask": [
      "mcp__boncourant__hc_schedule_change_impact",
      "mcp__boncourant__simulate",
      "mcp__boncourant__decompose_invoice",
      "mcp__boncourant__annualize_invoice",
      "mcp__boncourant__check_subscribed_power",
      "mcp__boncourant__renewal_advisor",
      "mcp__boncourant__extract_energy_document",
      "mcp__boncourant__run_method",
      "mcp__boncourant__assess_ppa",
      "mcp__boncourant__create_analysis_study",
      "mcp__boncourant__eex_connector",
      "mcp__boncourant__pro_catalog"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as boncourant. Review it before you use it.