# Boncourant (remote · boncourant.fr)

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

- Trust score: 79/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-24

## Components

- remote · `boncourant.fr`: 79/100 (this document), [markdown](https://verifymcp.io/servers/fr-boncourant-boncourant/boncourant.md), [page](https://verifymcp.io/servers/fr-boncourant-boncourant/boncourant)

## Channel facts

- Endpoint: `https://boncourant.fr/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.5.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-24.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 73/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 2041 tokens (~107/item across 19 items; 18 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 50/100
  - Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 18 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Boncourant MCP server?

Boncourant is a hosted endpoint at https://boncourant.fr/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

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

### VS Code

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

### Codex

```toml
[mcp_servers.fr-boncourant-boncourant]
url = "https://boncourant.fr/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fr-boncourant-boncourant": {
      "type": "remote",
      "url": "https://boncourant.fr/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add fr-boncourant-boncourant --url 'https://boncourant.fr/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  fr-boncourant-boncourant:
    url: "https://boncourant.fr/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "fr-boncourant-boncourant": {
      "Transport": "http",
      "Url": "https://boncourant.fr/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add fr-boncourant-boncourant -t streamable-http -u 'https://boncourant.fr/mcp'
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-23 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-21 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-19 (score 77, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 76, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-15 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-13 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-10 (score 72, 0)

- [functional improvement] Stability: unverified → 0.03

## MCP tools (18)

### `list_capabilities` (~76 tokens)

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.

Input parameters:

- `audience` (string)
- `capability_id` (string)

### `simulate` (~80 tokens)

Simuler une facture résidentielle

Simule la facture annuelle d'électricité pour un foyer français. Compare les offres de marché au tarif réglementé et estime les économies potentielles.

Input parameters:

- `conso_annuelle_kwh` (number, required)
- `option` (string)
- `postal_code` (string, required)
- `proportion_hc` (number)
- `puissance_kva` (number, required)

### `analyze_bill` (~181 tokens)

Analyser une facture résidentielle

Analyse une facture d'électricité résidentielle déjà extraite (champs structurés) via le moteur versionné. 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.

Input parameters:

- `conso_annuelle_kwh` (number, required)
- `conso_kwh_hc` (number)
- `conso_kwh_hp` (number)
- `current_annual_cost_eur` (number)
- `current_offer` (string)
- `current_supplier` (string)
- `option` (string)
- `postal_code` (string, required)
- `puissance_kva` (number, required)

### `get_methodology` (~74 tokens)

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.

Input parameters:

- `family` (string)
- `method_id` (string)
- `version` (string)

### `eex_connector` (~61 tokens)

Lire les indicateurs de marché EEX

Courbe forward EEX France (CAL Y+1, CAL Y+2, M+1). Lit le snapshot public le plus récent depuis market_observation et indique explicitement quand aucune donnée récente n'est disponible.

Input parameters:

- `asof` (string)

### `pro_catalog` (~111 tokens)

Consulter le catalogue professionnel

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.

### `decompose_invoice` (~97 tokens)

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.

Input parameters:

- `line_items` (array, required)
- `stated_total_ht`
- `stated_total_ttc`

### `annualize_invoice` (~128 tokens)

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.

Input parameters:

- `option` (string)
- `period_end` (string, required)
- `period_kwh` (number)
- `period_start` (string, required)
- `period_total_ttc_eur` (number)
- `puissance_kva` (number, required)
- `segment` (string, required)

### `check_subscribed_power` (~181 tokens)

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.

Input parameters:

- `available_contract_tiers_kva`
- `connection_segment` (string, required)
- `evaluation_date` (string, required)
- `max_demand_kva`
- `max_demand_kw`
- `measurement_basis`
- `measurement_period_days`
- `monthly_max_kva`
- `monthly_max_kw`
- `subscribed_kva` (number, required)
- `subscribed_powers_kva`

### `analyze_renewal_terms` (~97 tokens)

Analyser une échéance contractuelle

Calcule l'échéance, la date limite de préavis, le dépassement éventuel et l'urgence à partir de clauses déjà extraites. Le type de prix est une valeur canonique, jamais déduit d'un texte libre par cet outil.

Input parameters:

- `auto_renewal`
- `end_date`
- `evaluation_date` (string, required)
- `notice_period_days`
- `pricing_type`

### `assess_historical_optimality` (~83 tokens)

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

Input parameters:

- `alternatives` (array, required)
- `contract` (object, required)
- `materiality_eur_year` (number)

### `renewal_advisor` (~167 tokens)

Conseiller un renouvellement professionnel

Joint l'échéance et le préavis du contrat, la courbe EEX CAL Y+1/Y+2 fraîche et le catalogue professionnel comparable. 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.

Input parameters:

- `annual_consumption_mwh`
- `auto_renewal`
- `budget_eur_mwh`
- `ceiling_eur_mwh`
- `current_locked_supply_eur_mwh` (number, required)
- `end_date`
- `evaluation_date` (string, required)
- `locked_fraction` (number)
- `notice_period_days`
- `pricing_type`
- `segment` (string, required)
- `structure`

### `extract_energy_document` (~114 tokens)

Extraire et auditer une facture ou un contrat

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.

Input parameters:

- `document_base64` (string)
- `document_file` (object)
- `document_kind` (string, required)
- `document_text` (string)
- `evaluation_date` (string, required)
- `segment` (string, required)

### `run_method` (~92 tokens)

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 parameters:

- `context` (object)
- `input` (object, required)
- `method_id` (string, required)
- `valid_on` (string)
- `version` (string)

### `assess_ppa` (~133 tokens)

É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é.

Input parameters:

- `contracts` (array)
- `customer` (object, required)
- `matched_profile` (object)

### `create_analysis_study` (~143 tokens)

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.

Input parameters:

- `arguments` (object, required)
- `capability_id` (string)
- `document_file` (object)
- `idempotency_key` (string, required)
- `target_tool` (string, required)

### `get_analysis_study` (~65 tokens)

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.

Input parameters:

- `receipt` (string, required)

### `get_analysis_report` (~55 tokens)

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

Input parameters:

- `receipt` (string, required)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/fr-boncourant-boncourant/boncourant#diagnostics

## Score history

- 2026-09-24: 79
- 2026-09-23: 79
- 2026-09-22: 78
- 2026-09-21: 78
- 2026-09-20: 77
- 2026-09-19: 77
- 2026-09-18: 76
- 2026-09-17: 76
- 2026-09-16: 75
- 2026-09-15: 75
- 2026-09-14: 74
- 2026-09-13: 74
- 2026-09-12: 73
- 2026-09-11: 73
- 2026-09-10: 72
- 2026-09-09: 72

## Common questions

### What is the Boncourant MCP server?

Boncourant is an MCP server listed in the public MCP registry as fr.boncourant/boncourant. Optimiseur et auditeur d'électricité en France : tarifs, contrats, puissance et PPA. This page covers its hosted endpoint (https://boncourant.fr/mcp).

### Is the Boncourant MCP server safe to use?

Boncourant scores 79 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Boncourant MCP server expose?

Boncourant exposes 18 tools: list_capabilities, simulate, analyze_bill, get_methodology, eex_connector, and 13 more. Their descriptions and schemas cost roughly 1,938 tokens of context every time the server is loaded.

### Does the Boncourant MCP server require authentication?

No. We connected to Boncourant without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Boncourant MCP server still maintained?

Boncourant is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://boncourant.fr/mcp
- Website: https://boncourant.fr/agents
- Changelog RSS feed: https://verifymcp.io/servers/fr-boncourant-boncourant/boncourant.xml
- Changelog JSON feed: https://verifymcp.io/servers/fr-boncourant-boncourant/boncourant.json
- HTML version of this page: https://verifymcp.io/servers/fr-boncourant-boncourant/boncourant