Servidor MCP
Boncourant
fr.boncourant/boncourant
Qué hace este MCP
Analyzes French electricity bills and contracts, compares tariffs, evaluates PPAs, estimates costs, and checks subscribed power and renewal conditions.
Capacidades
Herramientas
19
herramientas
analyze_bill
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['conso_annuelle_kwh', 'puissance_kva', 'postal_code'], 'properties': {'option': {'enum': ['Base', 'HP/HC', 'Tempo'], 'type': 'string', 'description': 'Option tarifaire actuelle'}, 'postal_code': {'type': 'string', 'description': 'Code postal à 5 chiffres'}, 'conso_kwh_hc': {'type': 'number', 'description': 'Consommation en heures creuses (kWh), si option HP/HC'}, 'conso_kwh_hp': {'type': 'number', 'description': 'Consommation en heures pleines (kWh), si option HP/HC'}, 'current_offer': {'type': 'string', 'description': "Nom de l'offre actuelle (facultatif)"}, 'puissance_kva': {'type': 'number', 'description': 'Puissance souscrite en kVA'}, 'current_supplier': {'type': 'string', 'description': 'Fournisseur actuel (facultatif)'}, 'conso_annuelle_kwh': {'type': 'number', 'description': 'Consommation annuelle en kWh (lue sur la facture)'}, 'current_annual_cost_eur': {'type': 'number', 'description': "Coût annuel TTC du contrat actuel en euros (facultatif) — sert de référence pour l'économie"}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
analyze_renewal_terms
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['evaluation_date'], 'properties': {'end_date': {'type': ['string', 'null'], 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}, 'auto_renewal': {'type': ['boolean', 'null']}, 'pricing_type': {'enum': ['fixed', 'market_indexed', 'spot_indexed', 'trve_linked', 'arenh_reference', None], 'type': ['string', 'null']}, 'evaluation_date': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}, 'notice_period_days': {'type': ['number', 'null'], 'minimum': 0}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
annualize_invoice
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'anyOf': [{'required': ['period_kwh']}, {'required': ['period_total_ttc_eur']}], 'required': ['period_start', 'period_end', 'segment', 'puissance_kva'], 'properties': {'option': {'enum': ['base', 'hp_hc', 'tempo'], 'type': 'string'}, 'segment': {'enum': ['residentiel', 'pro_bt36', 'pro_bt36plus'], 'type': 'string'}, 'period_end': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}, 'period_kwh': {'type': 'number', 'minimum': 0}, 'period_start': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}, 'puissance_kva': {'type': 'number', 'maximum': 250, 'exclusiveMinimum': 0}, 'period_total_ttc_eur': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
assess_historical_optimality
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é.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['contract', 'alternatives'], 'properties': {'contract': {'type': 'object', 'required': ['contract_id', 'supplier_id', 'signed_at', 'delivery_start', 'delivery_end', 'term_months', 'comparable_cost_eur_year', 'comparison_basis'], 'properties': {'signed_at': {'type': ['string', 'null'], 'format': 'date'}, 'contract_id': {'type': 'string'}, 'supplier_id': {'type': ['string', 'null']}, 'term_months': {'type': ['number', 'null'], 'exclusiveMinimum': 0}, 'delivery_end': {'type': ['string', 'null'], 'format': 'date'}, 'delivery_start': {'type': ['string', 'null'], 'format': 'date'}, 'comparison_basis': {'type': ['string', 'null']}, 'comparable_cost_eur_year': {'type': ['number', 'null'], 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'alternatives': {'type': 'array', 'items': {'type': 'object', 'required': ['candidate_id', 'supplier_id', 'issued_at', 'valid_from', 'valid_until', 'delivery_start', 'delivery_end', 'term_months', 'comparable_cost_eur_year', 'comparison_basis', 'feasibility'], 'properties': {'issued_at': {'type': ['string', 'null'], 'format': 'date'}, 'valid_from': {'type': ['string', 'null'], 'format': 'date'}, 'feasibility': {'enum': ['confirmed', 'unconfirmed', 'rejected'], 'type': 'string'}, 'supplier_id': {'type': 'string'}, 'term_months': {'type': ['number', 'null'], 'exclusiveMinimum': 0}, 'valid_until': {'type': ['string', 'null'], 'format': 'date'}, 'candidate_id': {'type': 'string'}, 'delivery_end': {'type': ['string', 'null'], 'format': 'date'}, 'evidence_ref': {'type': ['string', 'null']}, 'delivery_start': {'type': ['string', 'null'], 'format': 'date'}, 'comparison_basis': {'type': ['string', 'null']}, 'feasibility_reasons': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20}, 'comparable_cost_eur_year': {'type': ['number', 'null'], 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'maxItems': 100}, 'materiality_eur_year': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
assess_ppa
É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é.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['customer', 'contracts'], 'properties': {'customer': {'type': 'object', 'properties': {'role': {'enum': ['buyer', 'producer', 'prosumer'], 'type': 'string'}, 'requested': {'type': 'boolean'}, 'scenarios': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'marketPriceEurMwh'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'marketPriceEurMwh': {'type': 'number'}, 'productionChangePct': {'type': 'number', 'maximum': 300, 'minimum': -100}, 'consumptionChangePct': {'type': 'number', 'maximum': 300, 'minimum': -100}, 'settlementPriceEurMwh': {'type': 'number'}}, 'additionalProperties': False}, 'maxItems': 20}, 'structure': {'enum': ['physical', 'sleeved', 'onsite', 'virtual'], 'type': 'string'}, 'termYears': {'type': 'number', 'maximum': 60, 'exclusiveMinimum': 0}, 'goRequired': {'type': 'boolean'}, 'volumeBasis': {'enum': ['pay_as_produced', 'baseload', 'pay_as_consumed', 'fixed_volume'], 'type': 'string'}, 'alternatives': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'annualNetEur', 'role', 'comparable', 'basis'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'role': {'enum': ['buyer', 'producer'], 'type': 'string'}, 'basis': {'type': 'string', 'minLength': 1}, 'comparable': {'type': 'boolean'}, 'annualNetEur': {'type': 'number'}}, 'additionalProperties': False}, 'maxItems': 20}, 'strikeEurMwh': {'type': 'number'}, 'annualFeesEur': {'type': 'number', 'minimum': 0}, 'collateralEur': {'type': 'number', 'minimum': 0}, 'goTransferred': {'type': 'boolean'}, 'supportScheme': {'type': 'string'}, 'upfrontCostEur': {'type': 'number', 'minimum': 0}, 'annualVolumeMwh': {'type': 'number', 'exclusiveMinimum': 0}, 'discountRatePct': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'accountingStandard': {'enum': ['french_gaap', 'ifrs', 'unknown'], 'type': 'string'}, 'liquidityBudgetEur': {'type': 'number', 'minimum': 0}, 'annualProductionMwh': {'type': 'number', 'exclusiveMinimum': 0}, 'fixedPriceConfirmed': {'type': 'boolean'}, 'annualConsumptionMwh': {'type': 'number', 'exclusiveMinimum': 0}, 'costPerimeterComplete': {'type': 'boolean'}, 'commitmentHorizonYears': {'type': 'number', 'exclusiveMinimum': 0}, 'legalTaxReviewConfirmed': {'type': 'boolean'}, 'productionAllocationPct': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'useUploadedProductionForPpa': {'type': 'boolean'}, 'operationalReadinessConfirmed': {'type': 'boolean'}}, 'additionalProperties': False}, 'contracts': {'type': 'array', 'items': {'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'ppa': {'anyOf': [{'type': 'object', 'required': ['is_ppa', 'structure', 'volume_basis', 'buyer', 'producer', 'asset', 'technology', 'jurisdiction', 'annual_volume_mwh', 'strike_eur_mwh', 'go_transferred', 'support_scheme'], 'properties': {'asset': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'buyer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'is_ppa': {'type': 'boolean'}, 'producer': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'structure': {'enum': ['physical', 'sleeved', 'onsite', 'virtual', 'unknown'], 'type': 'string'}, 'technology': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'jurisdiction': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'volume_basis': {'enum': ['pay_as_produced', 'baseload', 'pay_as_consumed', 'fixed_volume', 'unknown'], 'type': 'string'}, 'go_transferred': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}]}, 'strike_eur_mwh': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'support_scheme': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'annual_volume_mwh': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'reference': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'reading_coverage': {'type': 'object', 'required': ['status', 'total_characters', 'processed_characters', 'chunks', 'conflict_paths', 'rejected_evidence_count', 'source_sha256', 'evidence', 'limitation'], 'properties': {'chunks': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'status': {'enum': ['text_read', 'needs_review'], 'type': 'string'}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['topic', 'title', 'summary', 'consequence', 'beneficiary', 'obligation', 'deadline', 'risk', 'negotiation', 'excerpt', 'confidence', 'start', 'end'], 'properties': {'end': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'risk': {'enum': ['high', 'medium', 'low', 'unknown'], 'type': 'string'}, 'start': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'title': {'type': 'string'}, 'topic': {'enum': ['parties', 'asset', 'term', 'price', 'volume', 'delivery', 'balancing', 'negative_prices', 'curtailment', 'availability', 'commissioning', 'credit', 'collateral', 'termination', 'force_majeure', 'change_in_law', 'assignment', 'disputes', 'tax', 'administration', 'guarantees_of_origin', 'public_support', 'reporting', 'other'], 'type': 'string'}, 'excerpt': {'type': 'string'}, 'summary': {'type': 'string'}, 'deadline': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'confidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'obligation': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'beneficiary': {'enum': ['buyer', 'producer', 'both', 'unknown'], 'type': 'string'}, 'consequence': {'type': 'string'}, 'negotiation': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'verified_pages': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}}, 'additionalProperties': False}}, 'limitation': {'type': 'string'}, 'source_sha256': {'type': 'string', 'pattern': '^[a-f0-9]{64}$'}, 'conflict_paths': {'type': 'array', 'items': {'type': 'string'}}, 'total_characters': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'pages_without_text': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'processed_characters': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'rejected_evidence_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'page_provenance_available': {'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'default': [], 'maxItems': 20}, 'matched_profile': {'type': 'object', 'required': ['consumption_kwh', 'ppa_generation_kwh', 'interval_minutes', 'start', 'end'], 'properties': {'end': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$'}, 'start': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$'}, 'consumption_kwh': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 35136, 'minItems': 1}, 'interval_minutes': {'anyOf': [{'type': 'number', 'const': 15}, {'type': 'number', 'const': 30}, {'type': 'number', 'const': 60}]}, 'ppa_generation_kwh': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 35136, 'minItems': 1}}, 'additionalProperties': False}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
check_subscribed_power
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['evaluation_date', 'subscribed_kva', 'connection_segment'], 'properties': {'max_demand_kw': {'type': ['number', 'null'], 'minimum': 0}, 'max_demand_kva': {'type': ['number', 'null'], 'minimum': 0}, 'monthly_max_kw': {'type': ['array', 'null'], 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 12, 'minItems': 1}, 'subscribed_kva': {'type': 'number', 'maximum': 250, 'exclusiveMinimum': 0}, 'evaluation_date': {'type': 'string', 'pattern': '^[0-9]{4}-[0-9]{2}-[0-9]{2}$'}, 'monthly_max_kva': {'type': ['array', 'null'], 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 12, 'minItems': 1}, 'measurement_basis': {'enum': ['official_metering', 'invoice_peak', None], 'type': ['string', 'null']}, 'connection_segment': {'enum': ['c5_bt_le_36', 'c4_bt_gt_36_le_250'], 'type': 'string'}, 'subscribed_powers_kva': {'type': ['object', 'null'], 'required': ['p1', 'p2', 'p3', 'p4'], 'properties': {'p1': {'type': 'number', 'maximum': 250, 'exclusiveMinimum': 0}, 'p2': {'type': 'number', 'maximum': 250, 'exclusiveMinimum': 0}, 'p3': {'type': 'number', 'maximum': 250, 'exclusiveMinimum': 0}, 'p4': {'type': 'number', 'maximum': 250, 'exclusiveMinimum': 36}}, 'additionalProperties': False}, 'measurement_period_days': {'type': ['integer', 'null'], 'maximum': 370, 'minimum': 1}, 'available_contract_tiers_kva': {'type': ['array', 'null'], 'items': {'type': 'number', 'maximum': 36, 'exclusiveMinimum': 0}, 'minItems': 1, 'uniqueItems': True}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
create_analysis_study
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.
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['idempotency_key', 'target_tool', 'arguments'], 'properties': {'arguments': {'type': 'object', 'description': 'Arguments exacts du target_tool selon son schéma tools/list.', 'additionalProperties': True}, 'target_tool': {'enum': ['simulate', 'analyze_bill', 'get_methodology', 'decompose_invoice', 'annualize_invoice', 'check_subscribed_power', 'analyze_renewal_terms', 'assess_historical_optimality', 'renewal_advisor', 'extract_energy_document', 'run_method', 'assess_ppa', 'eex_connector', 'pro_catalog'], 'type': 'string'}, 'capability_id': {'type': 'string', 'description': 'Identifiant optionnel retourné par list_capabilities ; l’outil doit appartenir à cette capacité.'}, 'document_file': {'type': 'object', 'required': ['download_url', 'file_id'], 'properties': {'file_id': {'type': 'string'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string'}, 'download_url': {'type': 'string'}}, 'description': 'Fichier temporaire ChatGPT à injecter dans extract_energy_document pour un job asynchrone.', 'additionalProperties': False}, 'idempotency_key': {'type': 'string', 'pattern': '^[A-Za-z0-9._:-]+$', 'maxLength': 200, 'minLength': 16, 'description': 'Valeur opaque stable pour réessayer exactement la même création, par exemple un UUID.'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
decompose_invoice
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['line_items'], 'properties': {'line_items': {'type': 'array', 'items': {'type': 'object', 'required': ['component', 'confidence'], 'properties': {'unit': {'type': ['string', 'null']}, 'quantity': {'type': ['number', 'null']}, 'amount_ht': {'type': ['number', 'null']}, 'component': {'enum': ['energy', 'turpe_fixed', 'turpe_variable', 'accise', 'cta', 'tva', 'capacity', 'cee', 'fees', 'other'], 'type': 'string'}, 'amount_ttc': {'type': ['number', 'null']}, 'amount_tva': {'type': ['number', 'null']}, 'confidence': {'enum': ['confirmed', 'estimated', 'indicative', 'not_enough_data'], 'type': 'string'}, 'temporal_class': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'maxItems': 500, 'minItems': 1}, 'stated_total_ht': {'type': ['number', 'null']}, 'stated_total_ttc': {'type': ['number', 'null']}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
eex_connector
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {'asof': {'type': 'string', 'description': "Date de référence ISO 8601 (YYYY-MM-DD). Défaut : aujourd'hui."}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
extract_energy_document
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.
Solo lectura
Acceso externo
Idempotente
Esquema de entrada
{'type': 'object', 'oneOf': [{'required': ['document_file']}, {'required': ['document_base64']}, {'required': ['document_text']}], 'required': ['document_kind', 'segment', 'evaluation_date'], 'properties': {'segment': {'enum': ['residentiel', 'professionnel'], 'type': 'string'}, 'document_file': {'type': 'object', 'required': ['download_url', 'file_id'], 'properties': {'file_id': {'type': 'string'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string'}, 'download_url': {'type': 'string'}}, 'additionalProperties': False}, 'document_kind': {'enum': ['bill', 'contract'], 'type': 'string'}, 'document_text': {'type': 'string', 'maxLength': 100000, 'description': 'Texte déjà extrait, alternative au PDF'}, 'document_base64': {'type': 'string', 'description': 'PDF base64, 10 Mo maximum'}, 'evaluation_date': {'type': 'string', 'format': 'date'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
get_analysis_report
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é.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['receipt'], 'properties': {'receipt': {'type': 'string', 'pattern': '^bas_[A-Za-z0-9_-]{43}$'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
get_analysis_study
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['receipt'], 'properties': {'receipt': {'type': 'string', 'pattern': '^bas_[A-Za-z0-9_-]{43}$'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
get_methodology
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'family': {'type': 'string'}, 'version': {'type': 'string'}, 'method_id': {'type': 'string'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
hc_schedule_change_impact
Impact d'un changement d'heures creuses
Calcule ce qu'un changement de plages d'heures creuses coûte à l'année, en facturant deux fois la même consommation (avant / après) avec les mêmes prix et le même abonnement. Les horaires viennent du courrier ou de la facture : aucune adresse ne résout des heures creuses, Enedis les attribuant par point de livraison. Accepte une répartition HP/HC facturée ou une consommation annuelle ; la courbe mesurée se lit dans l'étude Boncourant. Les prix sont fournis par l'appelant, toutes taxes comprises, et rien n'est conservé.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['old_schedule', 'new_schedule', 'current_option', 'consumption'], 'properties': {'consumption': {'oneOf': [{'type': 'object', 'required': ['basis', 'annual_kwh', 'hp_kwh', 'hc_kwh'], 'properties': {'basis': {'const': 'split'}, 'shape': {'type': 'object', 'required': ['hourly_share', 'monthly_share'], 'properties': {'label': {'type': 'string', 'maxLength': 120}, 'hourly_share': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 24, 'minItems': 24}, 'monthly_share': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 12, 'minItems': 12}}, 'additionalProperties': False}, 'hc_kwh': {'type': 'number', 'minimum': 0}, 'hp_kwh': {'type': 'number', 'minimum': 0}, 'annual_kwh': {'type': 'number', 'maximum': 1000000, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['basis', 'annual_kwh'], 'properties': {'basis': {'const': 'annual'}, 'shape': {'type': 'object', 'required': ['hourly_share', 'monthly_share'], 'properties': {'label': {'type': 'string', 'maxLength': 120}, 'hourly_share': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 24, 'minItems': 24}, 'monthly_share': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 12, 'minItems': 12}}, 'additionalProperties': False}, 'annual_kwh': {'type': 'number', 'maximum': 1000000, 'exclusiveMinimum': 0}}, 'additionalProperties': False}]}, 'alternatives': {'type': 'array', 'items': {'type': 'object', 'required': ['option', 'hp_eur_per_kwh', 'hc_eur_per_kwh', 'subscription_eur_per_year'], 'properties': {'option': {'enum': ['base', 'hp_hc', 'tempo'], 'type': 'string'}, 'price_as_of': {'type': 'string', 'maxLength': 40}, 'price_label': {'type': 'string', 'maxLength': 200}, 'kwh_by_colour': {'type': 'object', 'required': ['bleu', 'blanc', 'rouge'], 'properties': {'bleu': {'type': 'number', 'minimum': 0}, 'blanc': {'type': 'number', 'minimum': 0}, 'rouge': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}, 'hc_eur_per_kwh': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'hp_eur_per_kwh': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'subscription_eur_per_year': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}}, 'new_schedule': {'type': 'object', 'required': ['winter_windows', 'summer_windows'], 'properties': {'evidence': {'enum': ['bill', 'declaration', 'meter', 'assumed'], 'type': 'string'}, 'summer_windows': {'type': 'array', 'items': {'type': 'object', 'required': ['start_h', 'end_h'], 'properties': {'end_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}, 'start_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}}, 'additionalProperties': False}, 'minItems': 1}, 'winter_windows': {'type': 'array', 'items': {'type': 'object', 'required': ['start_h', 'end_h'], 'properties': {'end_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}, 'start_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}}, 'additionalProperties': False}, 'minItems': 1}}, 'additionalProperties': False}, 'old_schedule': {'type': 'object', 'required': ['winter_windows', 'summer_windows'], 'properties': {'evidence': {'enum': ['bill', 'declaration', 'meter', 'assumed'], 'type': 'string'}, 'summer_windows': {'type': 'array', 'items': {'type': 'object', 'required': ['start_h', 'end_h'], 'properties': {'end_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}, 'start_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}}, 'additionalProperties': False}, 'minItems': 1}, 'winter_windows': {'type': 'array', 'items': {'type': 'object', 'required': ['start_h', 'end_h'], 'properties': {'end_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}, 'start_h': {'type': 'integer', 'maximum': 23, 'minimum': 0}}, 'additionalProperties': False}, 'minItems': 1}}, 'additionalProperties': False}, 'current_option': {'type': 'object', 'required': ['option', 'hp_eur_per_kwh', 'hc_eur_per_kwh', 'subscription_eur_per_year'], 'properties': {'option': {'enum': ['base', 'hp_hc', 'tempo'], 'type': 'string'}, 'price_as_of': {'type': 'string', 'maxLength': 40}, 'price_label': {'type': 'string', 'maxLength': 200}, 'kwh_by_colour': {'type': 'object', 'required': ['bleu', 'blanc', 'rouge'], 'properties': {'bleu': {'type': 'number', 'minimum': 0}, 'blanc': {'type': 'number', 'minimum': 0}, 'rouge': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}, 'hc_eur_per_kwh': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'hp_eur_per_kwh': {'type': 'number', 'maximum': 1, 'exclusiveMinimum': 0}, 'subscription_eur_per_year': {'type': 'number', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
list_capabilities
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'audience': {'enum': ['household', 'professional', 'large_consumer', 'producer'], 'type': 'string'}, 'capability_id': {'type': 'string', 'description': "Identifiant exact retourné lors d'un appel précédent."}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
pro_catalog
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
renewal_advisor
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['evaluation_date', 'current_locked_supply_eur_mwh', 'segment'], 'properties': {'segment': {'enum': ['c5_bt_le_36', 'c4_bt_gt_36_le_250'], 'type': 'string'}, 'end_date': {'type': ['string', 'null'], 'format': 'date'}, 'structure': {'enum': ['base', 'hp_hc', 'hph_hch_hpe_hce', None], 'type': ['string', 'null']}, 'auto_renewal': {'type': ['boolean', 'null']}, 'pricing_type': {'enum': ['fixed', 'market_indexed', 'spot_indexed', 'trve_linked', 'arenh_reference', None], 'type': ['string', 'null']}, 'budget_eur_mwh': {'type': ['number', 'null'], 'exclusiveMinimum': 0}, 'ceiling_eur_mwh': {'type': ['number', 'null'], 'exclusiveMinimum': 0}, 'evaluation_date': {'type': 'string', 'format': 'date'}, 'locked_fraction': {'type': 'number', 'default': 0, 'maximum': 1, 'minimum': 0}, 'notice_period_days': {'type': ['number', 'null'], 'minimum': 0}, 'annual_consumption_mwh': {'type': ['number', 'null'], 'exclusiveMinimum': 0}, 'current_locked_supply_eur_mwh': {'type': 'number', 'description': 'Prix actuel HT fourniture, en €/MWh', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
run_method
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'oneOf': [{'required': ['version']}, {'required': ['valid_on']}], 'required': ['method_id', 'input'], 'properties': {'input': {'type': 'object', 'additionalProperties': True}, 'context': {'type': 'object', 'properties': {'cta_fraction': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, 'version': {'type': 'string'}, 'valid_on': {'type': 'string', 'format': 'date'}, 'method_id': {'type': 'string'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
simulate
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.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['postal_code', 'puissance_kva', 'conso_annuelle_kwh'], 'properties': {'option': {'enum': ['Base', 'HP/HC', 'Tempo'], 'type': 'string'}, 'postal_code': {'type': 'string', 'description': 'Code postal à 5 chiffres'}, 'proportion_hc': {'type': 'number', 'description': 'Proportion de consommation en heures creuses (0.0 à 1.0). Requis si option = HP/HC.'}, 'puissance_kva': {'type': 'number', 'description': 'Puissance du compteur en kVA'}, 'conso_annuelle_kwh': {'type': 'number', 'description': 'Consommation annuelle en kWh (lue sur la facture)'}}, 'additionalProperties': False}
Esquema de salida
{'type': 'object', 'additionalProperties': True}
Historial
Cambios recientes en herramientas
Añadido
hc_schedule_change_impact
27 de September de 2026 a las 02:43
Añadido
pro_catalog
17 de September de 2026 a las 12:39
Añadido
eex_connector
17 de September de 2026 a las 12:39
Añadido
get_analysis_report
17 de September de 2026 a las 12:39
Añadido
get_analysis_study
17 de September de 2026 a las 12:39
Añadido
create_analysis_study
17 de September de 2026 a las 12:39
Añadido
assess_ppa
17 de September de 2026 a las 12:39
Añadido
run_method
17 de September de 2026 a las 12:39
Añadido
extract_energy_document
17 de September de 2026 a las 12:39
Añadido
renewal_advisor
17 de September de 2026 a las 12:39
Añadido
assess_historical_optimality
17 de September de 2026 a las 12:39
Añadido
analyze_renewal_terms
17 de September de 2026 a las 12:39
Añadido
check_subscribed_power
17 de September de 2026 a las 12:39
Añadido
annualize_invoice
17 de September de 2026 a las 12:39
Añadido
decompose_invoice
17 de September de 2026 a las 12:39
Añadido
get_methodology
17 de September de 2026 a las 12:39
Añadido
analyze_bill
17 de September de 2026 a las 12:39
Añadido
simulate
17 de September de 2026 a las 12:39
Añadido
list_capabilities
17 de September de 2026 a las 12:39
Descubrir
Servidores MCP similares
AdButler
com.adbutler/mcp-server
Manages AdButler advertisers, campaigns, ad items, audiences, zones, creatives, catalogs, and advertising reports.
Duvo MCP
io.github.duvoai/duvo
Provides governed retail and CPG operations for cases, queues, approvals, automations, process documentation, integrations, and a…
Lovie Company Formation
co.lovie/company-formation
Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…
freedom-mcp
com.getfreedomos/freedom-mcp
Supports company operations through commitments, teams, agents, customer evidence, leads, content workflows, spreadsheets, commer…
独行录 / opcmenu
io.github.yzlee/opcmenu
Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…
Meta Council
com.meta-council/decision-intelligence
Provides governed workflows for consulting, outreach, sales deals, invoices, marketing campaigns, content approvals, accounting a…
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…