MCP public · sans authentification

Donnez à votre agent une analyse d’électricité calculée

Boncourant expose ses outils d’optimisation et d’audit par MCP Streamable HTTP. Un agent peut choisir une capacité, réunir les preuves, exécuter une méthode versionnée et expliquer ses limites. Aucun compte ni jeton d’API n’est demandé.

Connexion

Endpoint: https://boncourant.fr/mcp
Transport: Streamable HTTP · JSON
Authentification: Aucune
Écriture: Études temporaires uniquement

Premier appel

1. Appelez list_capabilities avec l’audience connue.
2. Demandez uniquement les preuves indiquées par la capacité.
3. Appelez l’outil métier, puis citez sa méthode, sa date et ses limites.

Manifeste JSON OpenAPI Méthodologie

Documents et calculs longs

Un reçu privé pendant 24 heures

1. CréerAppelez create_analysis_study avec un UUID d’idempotence, l’outil cible et ses arguments. Le reçu secret n’est affiché qu’au client.
2. SuivreAppelez get_analysis_study après le délai indiqué. Un job interrompu peut être repris sans dupliquer l’étude.
3. RapporterPour un PPA terminé, get_analysis_report retourne le Markdown et une URL PDF privée valable deux minutes.

Le reçu est une autorisation limitée à une seule étude. Boncourant en conserve seulement une empreinte cryptographique et une copie chiffrée pour les reprises idempotentes. L’entrée brute est effacée dès la fin du traitement ; le résultat et le reçu expirent sous 24 heures.

Intégration

Une URL, puis une capacité métier

Ajoutez l’URL comme serveur MCP distant. Le premier appel ci-dessous permet à un agent de choisir l’analyse adaptée avant de demander des données au client.

Configuration client

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

Découverte ciblée

{
  "jsonrpc": "2.0",
  "id": "capabilities-1",
  "method": "tools/call",
  "params": {
    "name": "list_capabilities",
    "arguments": { "audience": "professional" }
  }
}

Les appels ordinaires acceptent 32 Kio. assess_ppa accepte jusqu’à 4 Mio pour une année de courbes alignées. extract_energy_document accepte un PDF borné ou un fichier temporaire transmis par ChatGPT. Les erreurs de limite renvoient un statut explicite et invitent à réessayer.

Catalogue 2026-09-09

Capacités et preuves attendues

La disponibilité décrit le niveau de preuve requis. Elle ne transforme pas une information manquante en hypothèse.

Optimisation tarifaire résidentielle

available

Calcule l'option et l'offre adaptées à la consommation réelle d'un foyer en France.

Preuves

code postal
puissance souscrite
consommation annuelle
répartition temporelle quand elle est disponible

Outils MCP

simulate · analyze_bill

Lire le périmètre →

Audit de facture et de contrat

available

Lit une facture ou un contrat d'électricité, structure les preuves et contrôle les postes calculables.

Preuves

PDF ou texte du document
date d'évaluation
annexes tarifaires et contractuelles applicables

Outils MCP

extract_energy_document · decompose_invoice · annualize_invoice

Lire le périmètre →

Puissance, structure et TURPE

evidence_dependent

Vérifie si la puissance et la structure tarifaire correspondent au profil mesuré du site.

Preuves

segment de raccordement
puissances souscrites
pointes officielles ou courbe de charge
période de mesure

Outils MCP

check_subscribed_power · run_method

Lire le périmètre →

Achat et renouvellement d'électricité

evidence_dependent

Relie préavis, échéance, prix verrouillé, marché daté et offres comparables pour préparer une décision d'achat.

Preuves

contrat et préavis
prix HT fourniture
consommation
devis de même périmètre

Outils MCP

analyze_renewal_terms · renewal_advisor · assess_historical_optimality · eex_connector · pro_catalog

Lire le périmètre →

Analyse et aide à la décision PPA

evidence_dependent

Extrait les clauses d'un PPA et évalue, pour un acheteur, un producteur ou un autoconsommateur, les effets économiques, contractuels, fiscaux, administratifs et environnementaux.

Preuves

projet de contrat et annexes
rôle et montage
prix, durée et volumes
consommation ou production
scénarios de prix
frais, garanties et alternatives comparables

Outils MCP

extract_energy_document · assess_ppa

Lire le périmètre →

Production et flexibilité

limited

Étudie séparément production, autoconsommation, injection et usages déplaçables avant de valoriser un scénario.

Preuves

courbes alignées
périmètre du site
contrats d'achat et de vente
contraintes d'exploitation

Outils MCP

assess_ppa · run_method

Lire le périmètre →

Portefeuille multisite

evidence_dependent

Relie les preuves et analyses site par site dans une étude professionnelle commune.

Preuves

identifiants de sites
factures et contrats par période
courbes et puissances par point de livraison

Outils MCP

extract_energy_document · run_method

Lire le périmètre →

Règles d’usage

Les outils sont sans authentification et n’exécutent aucune action auprès d’un fournisseur ou d’un compte client. Seule une étude temporaire isolée peut être créée.
Les PDF et textes transmis directement à extract_energy_document sont traités en mémoire. Dans une étude asynchrone, l’entrée chiffrée au repos est supprimée dès la fin du job et le résultat expire sous 24 heures.
Une conclusion chiffrée doit conserver son identifiant de méthode, sa version, ses hypothèses et ses données manquantes.
Boncourant optimise et audite. Il ne publie pas un classement générique d’offres et ne se présente pas comme comparateur.