ionluz — solar quotes (Brazil)

io.github.surfer42069Published by GitHub account surfer42069v1.0.1Updated Oct 24, 2026

Solar quotes for Brazilian installers: kWp sizing, own pricing, payback under Law 14.300, PDF.

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote MCP server that lets an AI assistant size solar systems and produce quotes for Brazilian installers using the installer's own pricing and catalog.

What you can do
Quote solar systems from monthly kWh consumption, with optional state, connection type, desired kWp, tariff, roof type and lead data, returning system size, price, payback and savings under Law 14.300. Simulate a quote by default, or save it as a proposal with consent and get PDF and interactive-page links. Check which power ranges the account can quote, with kit and price, before promising an offer.
When to use it
Useful for Brazilian solar installers who want an assistant to draft customer quotes from consumption figures and their own pricing, or to check what the account can offer before committing to a range.
Requirements
Remote Streamable HTTP endpoint; no local package. Requires an ionluz API key (starts with ilz_) sent as an Authorization bearer header, created in the ionluz dashboard on the Total + API plan. Network access to the ionluz host.
Before you install
Saving a proposal with persist=true creates a lead containing personal data and requires consent=true under LGPD; use idempotencyKey to avoid duplicate leads on retries. The API key is a secret sent in the Authorization header. Quotes use the account's own pricing, so wrong pricing yields wrong proposals. Rate limits apply per IP and per key.

Installation

In SourceWeft

  1. Open ionluz — solar quotes (Brazil) in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.surfer42069%2Fionluz/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ionluz-solar-quotes-brazil": {
      "type": "http",
      "url": "https://app.ionluz.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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.

Tools

ToolWhat it does
quote_solarTakes 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_coverageReturns the power ranges the account can quote with kit and price, so the agent knows what it can offer before promising.

Client configuration

json
{  "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/

Source: README.md at commit 7f83212

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.