Para desenvolvedores e integradores

Preço solar por API e MCP — único no Brasil

O seu site, CRM ou agente de IA pedem uma cotação e recebem potência, valor, payback e proposta prontos — com a sua formação de preço. É o único preço solar transparente por API e MCP do Brasil.

Gerar minha chaveDocumentação completa

O que a integração entrega

API REST pública v1

POST com o consumo em kWh → kWp, valor, payback, economia e PDF/proposta prontos. Com idempotência, erros estruturados, rate-limit e proteção por IP.

Modo preview (cota sem gravar)

Uma calculadora no seu site ou um agente de IA cotam à vontade, sem criar registro. Capture o lead só quando ele quiser falar.

Servidor MCP nativo

Pluga o seu agente de IA (Claude e outros) no /api/mcp e ele cota solar sozinho — a integração é colar um bloco de configuração com a sua chave, sem escrever código.

Documentação aberta

Manual público com exemplos curl/JS/Python, catálogo de erros, idempotência e limites. Dá pra integrar numa tarde.

Uma chamada, a proposta pronta

Autentique com a sua chave ilz_. Em preview, calcula sem gravar. Sem preview, grava a proposta e devolve o link do PDF e da página interativa.

Ver todos os endpoints →

# Cotação (preview: sem gravar)
curl -X POST https://app.ionluz.com.br/api/v1/quote \
  -H "Authorization: Bearer ilz_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{ "consumoKwhMes": 650, "uf": "SP", "fases": "bi", "preview": true }'

# Resposta
{ "ok": true,
  "orcamento": { "potenciaKwp": 5.4, "valorFinal": 28500,
    "paybackAnos": 6.3, "economiaMes1": 336, "economia25Anos": 216247 },
  "assumptions": { "uf": "SP", "tarifaBrlKwh": 0.95 },
  "requestId": "req_..." }

Experimente a API ao vivo

Esta é a mesma POST /api/v1/quote em modo preview, chamada de verdade no seu navegador — respondendo com a formação de preço de uma empresa real que usa a ionluz. Nada é gravado.

// clique em "Chamar a API" para ver a resposta real

MCP: o seu agente de IA cota solar

Configure o cliente MCP com a sua chave e o agente ganha as ferramentas quote_solar e check_coverage.

{
  "mcpServers": {
    "ionluz": {
      "url": "https://app.ionluz.com.br/api/mcp",
      "headers": { "Authorization": "Bearer ilz_sua_chave" }
    }
  }
}

Comece a cotar por API hoje

Teste ao vivo aqui na página, sem conta. Para cotar no seu site, a API faz parte do plano Total + API — R$97/mês: gere a chave no painel e leia a documentação aberta.

Criar conta e gerar chave