ionluz — solar quotes (Brazil)
RemoteAbout ionluz — solar quotes (Brazil)
ionluz is a remote MCP server for Brazilian solar installers, generating quotes from each installer's own catalog and pricing. It calculates system size, payback, and savings under Law 14.300, and can save a proposal and provide a PDF with consent.
Key features
- 01Size systems from energy use
- 02Use installer catalog and pricing
- 03Calculate payback and savings
- 04Check available quote capacity
- 05Save proposals and generate PDFs with consent
Use cases
- 01Quote a system from monthly customer consumption
- 02Check an account's offerable system range before quoting
- 03Save and share a proposal PDF with customer consent
MCP support
The remote MCP server exposes `quote_solar` and `check_coverage` tools to agents. It connects over Streamable HTTP and uses Bearer-key authentication.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://app.ionluz.com.br/api/mcpclaude mcp add --transport http surfer42069-ionluz https://app.ionluz.com.br/api/mcp{"mcpServers":{"surfer42069-ionluz":{"type":"http","url":"https://app.ionluz.com.br/api/mcp"}}}Open in Cursor{"servers":{"surfer42069-ionluz":{"type":"http","url":"https://app.ionluz.com.br/api/mcp"}}}Open in VS Code{"mcpServers":{"surfer42069-ionluz":{"type":"http","url":"https://app.ionluz.com.br/api/mcp"}}}{"mcpServers":{"surfer42069-ionluz":{"serverUrl":"https://app.ionluz.com.br/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://app.ionluz.com.br/api/mcpAuth requiredTools
Details
From the project READMEionluz 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 withilz_; 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=truerequires explicit consent (consent=true, LGPD). An optionalidempotencyKeyprevents 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/
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.