Boncourant
Audit and choose a French electricity tariff using versioned calculation methods
Answered our latest tool-list check 17 hours ago with 19 tools. It will be marked verified after 3 successful checks in 7 days.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://boncourant.fr/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"boncourant": {
"url": "https://boncourant.fr/mcp"
}
}
}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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government