Skip to content
MCP server

Boncourant

Audit and choose a French electricity tariff using versioned calculation methods

Status and history

Answered our latest tool-list check 17 hours ago with 19 tools. It will be marked verified after 3 successful checks in 7 days.

Install
Pricing
Free
Platforms
API, Web
Runs
Remotely
Version
1.6.0
Listing updated
3 days ago

About Boncourant

Boncourant is a free MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

Boncourant's MCP server is designed so an agent first calls list_capabilities, learns which analysis fits and what evidence it needs, then runs a versioned method and cites its date and limits. Typical inputs are postal code, subscribed power in kVA, annual consumption and tariff option such as Base, heures pleines/creuses or Tempo. When evidence is insufficient the result carries grounded: false rather than an invented saving.

For long documents and calculations there are private study receipts that expire after 24 hours. A study is created with an idempotency UUID, followed up later, and a finished PPA report returns Markdown plus a private PDF link valid for two minutes. assess_ppa accepts up to 4 MiB for a year of aligned load curves, and extract_energy_document reads a bounded PDF.

The same calculations are reachable over an A2A endpoint and OpenAPI routes. The limit is thirty calculations per minute per IP address. No account or token is needed; only temporary studies are written. The documentation is in French.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://boncourant.fr/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "boncourant": {
      "url": "https://boncourant.fr/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "boncourant": {
      "serverUrl": "https://boncourant.fr/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (19)

Read directly from the server.

list_capabilities
Liste les analyses disponibles, les preuves nécessaires, les livrables, les limites, les méthodes et les prochains outils MCP à appeler. Utile si le parcours est incertain.
hc_schedule_change_impact
Calcule le coût annuel d'un changement de plages d'heures creuses : même consommation, mêmes prix et abonnement, avant / après. Les deux horaires viennent du courrier ou de la facture (Enedis les attribue par point de livraison, pas par ville). Accepte une répartition HP/HC ou une consommation annuelle ; prix TTC fournis par l'appelant ; rien n'est conservé.
simulate
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.
analyze_bill
Évalue une facture résidentielle déjà extraite (champs structurés) ; sans facture, appelez simulate. Recommandation prospective, pas contrôle historique des lignes facturées. Retourne un verdict stay/switch et l'option tarifaire de chaque offre ; si aucune offre ne bat le contrat actuel, recommended_offer n'en désigne pas une plus chère. JSON uniquement : extrayez le PDF en amont (extract_energy_d
get_methodology
Retourne la méthodologie de calcul, ses sources, hypothèses et limites. Sans filtre : index compact (id, version, famille, titre, validité). Avec method_id, family ou version : documents complets avec schéma d'entrée.
decompose_invoice
Agrège des lignes de facture déjà extraites en postes canoniques (énergie, abonnement, TURPE, accise, TCFE, CTA, TVA, capacité, CEE, frais) et vérifie que leur somme correspond aux totaux HT/TTC déclarés, sans contrôler les taux. Pour une facture brute (PDF ou texte), appelez extract_energy_document, qui contrôle aussi l'accise de la période.
annualize_invoice
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.
check_subscribed_power
É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.
analyze_renewal_terms
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.
assess_historical_optimality
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é.
renewal_advisor
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. Prix C4 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.
extract_energy_document
Extrait en mémoire un PDF ou un texte de facture/contrat via l'extracteur européen, retire les identifiants sensibles de la réponse et lance immédiatement les méthodes déterministes applicables. Le document n'est pas conservé ; les champs incertains exigent confirmation.
assess_ppa
Analyse PPA conditionnelle (acheteur, producteur, prosumer) : avantages, risques contractuels, sensibilités fournies, alternatives, liquidité, fiscalité, garanties d'origine, points de négociation. Pour un texte de contrat, appelez d'abord extract_energy_document puis transmettez extract.ppa et extract.reading_coverage. Un scénario n'est ni une prévision ni un avis juridique ou fiscal.
create_analysis_study
Crée de façon idempotente une étude temporaire pour un traitement long : extraction de document ou analyse PPA. Retourne 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 comp
get_analysis_study
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.
get_analysis_report
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é.
eex_connector
Lit les forwards EEX France (CAL Y+1, CAL Y+2, M+1) en vigueur à une date (historique dès le 29 mai 2026), sans décision de contrat ; pour un renouvellement, appelez renewal_advisor.
simulate_pro
Coût annuel TTC par offre chiffrable d'un site pro C5 (3 à 36 kVA, Enedis). Avec curve_file : courbe mesurée, HP/HC si heures_creuses. Aucun gain sans coût actuel.
pro_catalog
Catalogue professionnel hebdomadaire (comparateur du Médiateur national de l'énergie) : offres C5 actives, fournisseurs, prix publiés, fixe / indexé, date du relevé ; C4 (36 à 250 kVA) sur devis seulement. Pour chiffrer un site C5, appelez simulate_pro.

What it does

Capability discovery
list_capabilities tells the agent which analysis and evidence apply.
Tariff comparison
Base, heures pleines/creuses and Tempo options for a household.
Document extraction
Reads a bounded energy PDF.
PPA assessment
Evaluates a power purchase agreement against a year of load curves.
24-hour study receipts
Private, resumable jobs that expire after a day.
A2A and OpenAPI
The same public calculations over other interfaces.

Good for

  • Compare Base, HP/HC and Tempo for a flat
  • Check a historical electricity bill
  • Assess a PPA offer from load curves
  • Extract data from a supplier PDF

Pricing

Free

Public use without account.

Prices change. Check boncourant.fr before you buy.

Boncourant FAQ

Do I need an account?

No. The public tools need no account or API token.

What if data is missing?

The result returns grounded: false with no invented saving.

How long do results last?

Study results and receipts expire within 24 hours.

What are the rate limits?

Thirty calculations a minute per IP address, with ordinary calls limited to 32 KiB.

Is Boncourant free?

Yes. Boncourant is free to use.

How do I add Boncourant to Claude Code?

Run this command in your terminal: claude mcp add --transport http boncourant https://boncourant.fr/mcp

What are the best alternatives to Boncourant?

The closest alternatives to Boncourant are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Boncourant

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government