Boncourant

npx add-mcp 'https://boncourant.fr/mcp'

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. 1. Appelez list_capabilities avec l’audience connue.
2. 2. Demandez uniquement les preuves indiquées par la capacité.
3. 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. 1. Créer Appelez 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. 2. Suivre Appelez get_analysis_study après le délai indiqué. Un job interrompu peut être repris sans dupliquer l’étude.
3. 3. Rapporter Pour 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.

A2A et OpenAPI: les mêmes calculs publics

La carte agent A2A décrit l’interface JSON-RPC 1.0 à /api/a2a. Elle accepte un Message structuré et répond immédiatement par un Message; elle ne conserve pas de tâche, de document ni de contexte client. Le protocole MCP 2026-07-28 et son transport streamable-http restent disponibles séparément à /mcp.

Les schémas d’entrée et de sortie des routes /api/simulate, /api/audit, /api/trv-gap et /api/commissions sont publiés dans l’OpenAPI 3.1. /api/audit évalue prospectivement une facture résidentielle déjà structurée; les contrôles historiques et les PDF passent par les outils MCP documentés. Les résultats individuels ne sont jamais mis en cache. Limite locale: trente calculs par minute et par adresse IP, corps JSON de seize kilo-octets maximum.

Exemple A2A: POST JSON à /api/a2a, avec l’en-tête A2A-Version: 1.0.

{
  "jsonrpc": "2.0",
  "id": "example",
  "method": "SendMessage",
  "params": {
    "message": {
      "messageId": "example-4500",
      "role": "ROLE_USER",
      "parts": [
        {
          "mediaType": "application/json",
          "data": {
            "skillId": "tariff_comparison",
            "arguments": {
              "postal_code": "75001",
              "puissance_kva": 9,
              "conso_annuelle_kwh": 4500,
              "option": "Base"
            }
          }
        }
      ]
    }
  }
}

Les exemples décrivent des profils illustratifs, pas vos données. Les montants viennent du moteur versionné, avec périmètre, confiance et provenance. Une donnée insuffisante retourne grounded: false sans économie inventée. Le texte libre n’est pas interprété par des règles de mots-clés dans cette interface.

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
• horaires d'heures creuses documentés quand la réforme les change

Outils MCP

simulate · analyze_bill · hc_schedule_change_impact

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.