Boncourant

Otimizador e auditor de custos de eletricidade franceses: simulações de tarifas, verificação de contas, análise de potência contratada e de contratos. MCP remoto público; sem chave de API.

Ver em boncourant.fr

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Dê ao seu agente uma análise de eletricidade calculada

O Boncourant expõe suas ferramentas de otimização e auditoria via MCP Streamable HTTP. Um agente pode escolher uma capacidade, reunir as evidências, executar um método versionado e explicar suas limitações. Nenhuma conta ou token de API é solicitado.

Conexão

Endpoint

https://boncourant.fr/mcp

Transporte

Streamable HTTP · JSON

Autenticação

Nenhuma

Escrita

Somente estudos temporários

Primeira chamada

  1. 1. Chame list_capabilities com o público conhecido.
  2. 2. Solicite apenas as evidências indicadas pela capacidade.
  3. 3. Chame a ferramenta de negócio e, em seguida, cite seu método, data e limitações.

Manifesto JSON OpenAPI Metodologia

Documentos e cálculos longos

Um recibo privado por 24 horas

  1. 1. Criar Chame create_analysis_study com um UUID de idempotência, a ferramenta alvo e seus argumentos. O recibo secreto é exibido apenas ao cliente.
  2. 2. Acompanhar Chame get_analysis_study após o atraso indicado. Um job interrompido pode ser retomado sem duplicar o estudo.
  3. 3. Relatar Para um PPA concluído, get_analysis_report retorna o Markdown e uma URL de PDF privada válida por dois minutos.

O recibo é uma autorização limitada a um único estudo. O Boncourant mantém apenas uma impressão digital criptográfica e uma cópia criptografada para retomadas idempotentes. A entrada bruta é apagada assim que o processamento termina; o resultado e o recibo expiram em 24 horas.

A2A e OpenAPI: os mesmos cálculos públicos

O mapa do agente A2A descreve a interface JSON-RPC 1.0 em /api/a2a. Ele aceita uma Message estruturada e responde imediatamente com uma Message; não retém tarefa, documento ou contexto do cliente. O protocolo MCP 2026-07-28 e seu transporte streamable-http permanecem disponíveis separadamente em /mcp.

Os esquemas de entrada e saída das rotas /api/simulate, /api/audit, /api/trv-gap e /api/commissions são publicados no OpenAPI 3.1. /api/audit avalia prospectivamente uma fatura residencial já estruturada; as verificações históricas e os PDFs passam pelas ferramentas MCP documentadas. Resultados individuais nunca são armazenados em cache. Limite local: trinta cálculos por minuto e por endereço IP, corpo JSON de no máximo dezesseis kilobytes.

Exemplo A2A: POST JSON para /api/a2a, com o cabeçalho 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"
            }
          }
        }
      ]
    }
  }
}

Os exemplos descrevem perfis ilustrativos, não seus dados. Os valores vêm do motor versionado, com escopo, confiança e proveniência. Dados insuficientes retornam grounded: false sem economia inventada. Texto livre não é interpretado por regras de palavras-chave nesta interface.

Integração

Uma URL, depois uma capacidade de negócio

Adicione a URL como servidor MCP remoto. A primeira chamada abaixo permite que um agente escolha a análise adequada antes de solicitar dados ao cliente.

Configuração do cliente

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

Descoberta direcionada

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

Chamadas comuns aceitam 32 Kio. assess_ppa aceita até 4 Mio para um ano de curvas alinhadas. extract_energy_document aceita um PDF limitado ou um arquivo temporário enviado pelo ChatGPT. Erros de limite retornam um status explícito e convidam a tentar novamente.

Catálogo 2026-09-09

Capacidades e evidências esperadas

A disponibilidade descreve o nível de evidência necessário. Ela não transforma informação ausente em suposição.

Otimização tarifária residencial

available

Calcula a opção e a oferta adequadas ao consumo real de uma residência na França.

Evidências

  • código postal
  • potência contratada
  • consumo anual
  • distribuição temporal quando disponível
  • horários de horas fora de ponta documentados quando a reforma os altera

Ferramentas MCP

simulate · analyze_bill · hc_schedule_change_impact

Ler o escopo →

Auditoria de fatura e contrato

available

Lê uma fatura ou contrato de eletricidade, estrutura as evidências e verifica os itens calculáveis.

Evidências

  • PDF ou texto do documento
  • data de avaliação
  • anexos tarifários e contratuais aplicáveis

Ferramentas MCP

extract_energy_document · decompose_invoice · annualize_invoice

Ler o escopo →

Potência, estrutura e TURPE

evidence_dependent

Verifica se a potência e a estrutura tarifária correspondem ao perfil medido do local.

Evidências

  • segmento de conexão
  • potências contratadas
  • picos oficiais ou curva de carga
  • período de medição

Ferramentas MCP

check_subscribed_power · run_method

Ler o escopo →

Compra e renovação de eletricidade

evidence_dependent

Relaciona aviso prévio, vencimento, preço travado, mercado datado e ofertas comparáveis para preparar uma decisão de compra.

Evidências

  • contrato e aviso prévio
  • preço sem impostos do fornecimento
  • consumo
  • orçamentos de mesmo escopo

Ferramentas MCP

analyze_renewal_terms · renewal_advisor · assess_historical_optimality · eex_connector · pro_catalog

Ler o escopo →

Análise e apoio à decisão PPA

evidence_dependent

Extrai as cláusulas de um PPA e avalia, para um comprador, produtor ou autoconsumidor, os efeitos econômicos, contratuais, fiscais, administrativos e ambientais.

Evidências

  • minuta do contrato e anexos
  • papel e estruturação
  • preço, duração e volumes
  • consumo ou produção
  • cenários de preço
  • taxas, garantias e alternativas comparáveis

Ferramentas MCP

extract_energy_document · assess_ppa

Ler o escopo →

Produção e flexibilidade

limited

Estuda separadamente produção, autoconsumo, injeção e usos deslocáveis antes de valorizar um cenário.

Evidências

  • curvas alinhadas
  • escopo do local
  • contratos de compra e venda
  • restrições operacionais

Ferramentas MCP

assess_ppa · run_method

Ler o escopo →

Portfólio multissite

evidence_dependent

Relaciona evidências e análises site a site em um estudo profissional comum.

Evidências

  • identificadores de sites
  • faturas e contratos por período
  • curvas e potências por ponto de entrega

Ferramentas MCP

extract_energy_document · run_method

Ler o escopo →

Regras de uso

  • As ferramentas não exigem autenticação e não executam nenhuma ação junto a um fornecedor ou conta de cliente. Apenas um estudo temporário isolado pode ser criado.
  • PDFs e textos enviados diretamente a extract_energy_document são processados em memória. Em um estudo assíncrono, a entrada criptografada em repouso é excluída assim que o job termina e o resultado expira em 24 horas.
  • Uma conclusão calculada deve manter seu identificador de método, versão, hipóteses e dados ausentes.
  • O Boncourant otimiza e audita. Ele não publica um ranking genérico de ofertas e não se apresenta como comparador.