# Boncourant

> Boncourant is a free MCP server for finance and payments. Audit and choose a French electricity tariff using versioned calculation methods. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://boncourant.fr/agents
- **Repository:** https://github.com/amrit-gill/boncourant-mcp
- **MCP Registry name:** fr.boncourant/boncourant
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://boncourant.fr/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/boncourant
