Boncourant

Optimizador y auditor de costos de electricidad en Francia: simulaciones de tarifas, verificación de facturas, análisis de potencia contratada y de contrato. MCP remoto público; sin clave de API.

Servidor MCP alojado

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

Se instala en Claude Code, Codex, Cursor y más

Documentación

Dé a su agente un análisis de electricidad calculado

Boncourant expone sus herramientas de optimización y auditoría mediante MCP Streamable HTTP. Un agente puede elegir una capacidad, reunir las pruebas, ejecutar un método versionado y explicar sus límites. No se requiere cuenta ni token de API.

Conexión

Endpoint

https://boncourant.fr/mcp

Transporte

Streamable HTTP · JSON

Autenticación

Ninguna

Escritura

Solo estudios temporales

Primera llamada

  1. 1. Llame a list_capabilities con la audiencia conocida.
  2. 2. Solicite únicamente las pruebas indicadas por la capacidad.
  3. 3. Llame a la herramienta de negocio y luego cite su método, fecha y límites.

Manifiesto JSON OpenAPI Metodología

Documentos y cálculos largos

Un recibo privado durante 24 horas

  1. 1. Crear Llame a create_analysis_study con un UUID de idempotencia, la herramienta objetivo y sus argumentos. El recibo secreto solo se muestra al cliente.
  2. 2. Seguir Llame a get_analysis_study después del retraso indicado. Un trabajo interrumpido puede reanudarse sin duplicar el estudio.
  3. 3. Informar Para un PPA finalizado, get_analysis_report devuelve el Markdown y una URL PDF privada válida durante dos minutos.

El recibo es una autorización limitada a un único estudio. Boncourant conserva únicamente una huella criptográfica y una copia cifrada para reanudaciones idempotentes. La entrada bruta se elimina al finalizar el procesamiento; el resultado y el recibo expiran en 24 horas.

A2A y OpenAPI: los mismos cálculos públicos

El mapa de agente A2A describe la interfaz JSON-RPC 1.0 en /api/a2a. Acepta un Message estructurado y responde inmediatamente con un Message; no conserva tareas, documentos ni contexto de cliente. El protocolo MCP 2026-07-28 y su transporte streamable-http siguen disponibles por separado en /mcp.

Los esquemas de entrada y salida de las rutas /api/simulate, /api/audit, /api/trv-gap y /api/commissions se publican en el OpenAPI 3.1. /api/audit evalúa prospectivamente una factura residencial ya estructurada; los controles históricos y los PDF pasan por las herramientas MCP documentadas. Los resultados individuales nunca se almacenan en caché. Límite local: treinta cálculos por minuto y por dirección IP, cuerpo JSON de dieciséis kilobytes como máximo.

Ejemplo A2A: POST JSON a /api/a2a, con el encabezado 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"
            }
          }
        }
      ]
    }
  }
}

Los ejemplos describen perfiles ilustrativos, no sus datos. Los montos provienen del motor versionado, con alcance, confianza y procedencia. Una insuficiencia de datos devuelve grounded: false sin ahorro inventado. El texto libre no se interpreta mediante reglas de palabras clave en esta interfaz.

Integración

Una URL, luego una capacidad de negocio

Agregue la URL como servidor MCP remoto. La primera llamada a continuación permite que un agente elija el análisis adecuado antes de solicitar datos al cliente.

Configuración del cliente

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

Descubrimiento dirigido

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

Las llamadas ordinarias aceptan 32 Kio. assess_ppa acepta hasta 4 Mio para un año de curvas alineadas. extract_energy_document acepta un PDF acotado o un archivo temporal enviado por ChatGPT. Los errores de límite devuelven un estado explícito e invitan a reintentar.

Catálogo 2026-09-09

Capacidades y pruebas esperadas

La disponibilidad describe el nivel de prueba requerido. No transforma información faltante en hipótesis.

Optimización tarifaria residencial

available

Calcula la opción y la oferta adecuadas al consumo real de un hogar en Francia.

Pruebas

  • código postal
  • potencia contratada
  • consumo anual
  • distribución temporal cuando esté disponible
  • horarios de horas valle documentados cuando la reforma los cambie

Herramientas MCP

simulate · analyze_bill · hc_schedule_change_impact

Leer el alcance →

Auditoría de factura y contrato

available

Lee una factura o contrato de electricidad, estructura las pruebas y controla los conceptos calculables.

Pruebas

  • PDF o texto del documento
  • fecha de evaluación
  • anexos tarifarios y contractuales aplicables

Herramientas MCP

extract_energy_document · decompose_invoice · annualize_invoice

Leer el alcance →

Potencia, estructura y TURPE

evidence_dependent

Verifica si la potencia y la estructura tarifaria corresponden al perfil medido del sitio.

Pruebas

  • segmento de conexión
  • potencias contratadas
  • picos oficiales o curva de carga
  • período de medición

Herramientas MCP

check_subscribed_power · run_method

Leer el alcance →

Compra y renovación de electricidad

evidence_dependent

Relaciona preaviso, vencimiento, precio bloqueado, mercado fechado y ofertas comparables para preparar una decisión de compra.

Pruebas

  • contrato y preaviso
  • precio sin impuestos del suministro
  • consumo
  • presupuestos del mismo alcance

Herramientas MCP

analyze_renewal_terms · renewal_advisor · assess_historical_optimality · eex_connector · pro_catalog

Leer el alcance →

Análisis y apoyo a la decisión PPA

evidence_dependent

Extrae las cláusulas de un PPA y evalúa, para un comprador, un productor o un autoconsumidor, los efectos económicos, contractuales, fiscales, administrativos y ambientales.

Pruebas

  • proyecto de contrato y anexos
  • rol y estructura
  • precio, duración y volúmenes
  • consumo o producción
  • escenarios de precios
  • cargos, garantías y alternativas comparables

Herramientas MCP

extract_energy_document · assess_ppa

Leer el alcance →

Producción y flexibilidad

limited

Estudia por separado producción, autoconsumo, inyección y usos desplazables antes de valorar un escenario.

Pruebas

  • curvas alineadas
  • alcance del sitio
  • contratos de compra y venta
  • restricciones de operación

Herramientas MCP

assess_ppa · run_method

Leer el alcance →

Cartera multisitio

evidence_dependent

Relaciona las pruebas y análisis sitio por sitio en un estudio profesional común.

Pruebas

  • identificadores de sitios
  • facturas y contratos por período
  • curvas y potencias por punto de suministro

Herramientas MCP

extract_energy_document · run_method

Leer el alcance →

Reglas de uso

  • Las herramientas no requieren autenticación y no ejecutan ninguna acción ante un proveedor o cuenta de cliente. Solo se puede crear un estudio temporal aislado.
  • Los PDF y textos enviados directamente a extract_energy_document se procesan en memoria. En un estudio asíncrono, la entrada cifrada en reposo se elimina al finalizar el trabajo y el resultado expira en 24 horas.
  • Una conclusión cifrada debe conservar su identificador de método, versión, hipótesis y datos faltantes.
  • Boncourant optimiza y audita. No publica un ranking genérico de ofertas ni se presenta como comparador.