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 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/