ionluz MCP server

Remote MCP server that lets an AI agent quote solar energy systems for Brazilian installers, using the installer's own pricing and catalog.

• Endpoint (Streamable HTTP): https://app.ionluz.com.br/api/mcp
• Auth: Authorization: Bearer <ionluz API key> (keys start with ilz_; created in the ionluz dashboard, plan Total + API)
• Docs: https://app.ionluz.com.br/docs/api#mcp
• Product: https://ionluz.com.br/

Tools

Tool	What it does
quote_solar	Takes monthly consumption in kWh (required) and optional UF, connection type (mono/bi/tri), desired kWp, tariff, roof type and lead data. Returns system size, price (installer's pricing), payback and savings under Law 14.300. Simulates by default; persist=true (requires consent=true) saves the proposal and returns the PDF and interactive-page links.
check_coverage	Returns the power ranges the account can quote with kit and price, so the agent knows what it can offer before promising.

Client configuration

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

Limits

• 300 requests/min per IP before authentication (anti-flood, REST and MCP).
• 120 JSON-RPC messages/min per key on the MCP transport.
• Saving a proposal creates a lead with personal data: persist=true requires explicit consent (consent=true, LGPD). An optional idempotencyKey prevents duplicate leads on retries.

About

ionluz is a proposal generator for solar installers in Brazil: from the customer's consumption to a premium PDF and interactive proposal in seconds, with honest payback under Law 14.300. This repository holds only the MCP registry metadata; the server itself is hosted.

Guide (Portuguese): https://ionluz.com.br/guias/cotacao-solar-por-agente-de-ia-mcp/