solematica-mcp▌

# @solematica/mcp-server [](https://www.npmjs.com/package/@solematica/mcp-server) [](https://opensource.org/licenses/MIT) [](https://modelcontextprotocol.io) [](https://nodejs.org) [](https://www.solematica.it) [MCP](https://modelcontextprotocol.io) (Model Context Protocol) server for [Solematica](https://www.solematica.it) — solar estimates, provider comparison and energy data for Italy. This server enables AI assistants like [Claude](https://claude.ai), [Cursor](https://cursor.com), [Windsurf](https://codeium.com/windsurf), [Kiro](https://kiro.dev) and other [MCP-compatible clients](https://modelcontextprotocol.io/clients) to analyze solar potential, compare photovoltaic providers, check energy prices and search energy-related articles for the Italian market. ## Tools | Tool | Description | Auth | |------|-------------|------| | `stima_solare` | Generate a full solar estimate for an Italian address — production, savings, ROI, panel sizing | API key | | `info_tetto` | Satellite roof analysis via [Google Solar API](https://developers.google.com/maps/documentation/solar) — surface, orientation, segments, panel potential | Free | | `confronta_provider` | Compare 11 Italian solar providers — prices, components, warranties, transparency index | Free | | `dettaglio_provider` | Full provider detail — accessories (heat pumps, EV chargers, boilers), contacts, financing | Free | | `prezzi_energia` | Current Italian energy prices ([PUN](https://it.wikipedia.org/wiki/Prezzo_unico_nazionale)/[ARERA](https://www.arera.it)) with update date | Free | | `cerca_articoli` | Search [Solematica blog](https://www.solematica.it/blog) articles by category or keyword | Free | ## Quick Start ### Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "solematica": { "command": "npx", "args": ["@solematica/mcp-server"], "env": { "SOLEMATICA_API_KEY": "your-api-key" } } } } ``` ### Claude Code ```bash claude mcp add solematica npx @solematica/mcp-server ``` ### Cursor Add to your `.cursor/mcp.json`: ```json { "mcpServers": { "solematica": { "command": "npx", "args": ["@solematica/mcp-server"], "env": { "SOLEMATICA_API_KEY": "your-api-key" } } } } ``` ### Windsurf Add to your `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { "solematica": { "command": "npx", "args": ["@solematica/mcp-server"], "env": { "SOLEMATICA_API_KEY": "your-api-key" } } } } ``` ### Other MCP Clients Any [MCP-compatible client](https://modelcontextprotocol.io/clients) can use this server via stdio transport: ```bash npx @solematica/mcp-server ``` ## Authentication - **API key** is only required for `stima_solare` (consumes credits per estimate) - All other tools are **free and public** — no API key needed - Get an API key by registering as a partner at [solematica.it/partner](https://www.solematica.it/partner) ## Environment Variables | Variable | Required | Default | Description | |----------|----------|---------|-------------| | `SOLEMATICA_API_KEY` | Only for `stima_solare` | — | Your API key for authenticated endpoints | | `SOLEMATICA_API_URL` | No | `https://api.solematica.it/api/v1` | API base URL (for self-hosted or testing) | ## Tool Details ### `stima_solare` Generates a complete solar estimate for an Italian address using [Google Solar API](https://developers.google.com/maps/documentation/solar) + [PVGIS](https://re.jrc.ec.europa.eu/pvg_tools/en/) data. **Input:** - `indirizzo` (required) — Full Italian address (e.g. "Via Roma 1, 20100 Milano MI") - `consumo_annuo_kwh` — Annual electricity consumption in kWh (default: 3500) - `tipo_abitazione` — Building type: `indipendente`, `bifamiliare`, `schiera`, `condominio` - `superficie_tetto_mq` — Roof surface in sqm (auto-calculated from satellite if omitted) - `orientamento` — Roof orientation: `nord`, `sud`, `est`, `ovest` **Returns:** kWp sizing, panel count, annual production, monthly distribution, savings, ROI, CO2 avoided, cost estimate. ### `info_tetto` Analyzes a roof using [Google Solar API](https://developers.google.com/maps/documentation/solar) satellite data. **Input:** - `lat` (required) — Latitude - `lng` (required) — Longitude **Returns:** Roof surface, usable area, orientation, roof segments, max panel count, sunshine hours. ### `confronta_provider` Lists all active Italian solar providers with comparison data. See the full [provider comparison](https://www.solematica.it/confronto-offerte) on Solematica. **Returns:** Array of providers with name, price (3 kWp), panel brand, inverter brand, warranty, transparency index (1-3), and accessory services availability (heat pump, EV charger, boiler). ### `dettaglio_provider` Full detail for a specific provider. **Input:** - `slug` (required) — Provider slug: `enel`, `iren`, `plenitude`, `otovo`, `eon`, `hera`, `a2a`, `edison`, `engie`, `sorgenia`, `bluenergy` **Returns:** All comparison data plus: description, phone, headquarters, founding year, financing details, accessory service details with URLs. ### `prezzi_energia` Current Italian energy prices from the [Solematica](https://www.solematica.it) database, updated monthly from [ARERA](https://www.arera.it) and [GME](https://www.mercatoelettrico.org). **Returns:** Self-consumption price (EUR/kWh), SSP price, cost per kWp range, battery cost per kWh, last update date. ### `cerca_articoli` Search the [Solematica blog](https://www.solematica.it/blog) for energy-related articles. **Input:** - `categoria` — Filter by category (e.g. `fotovoltaico`, `incentivi`, `risparmio`) - `limit` — Max results (default: 10, max: 50) **Returns:** Article list with title, slug, category, date, description, and full URL. ## Examples Ask Claude: - *"Quanto produrrebbe un impianto fotovoltaico in Via Garibaldi 15, Torino?"* - *"Confronta le offerte fotovoltaico di Enel e Iren"* - *"Quali provider offrono anche la pompa di calore?"* - *"Qual e il prezzo corrente dell'energia in Italia?"* - *"Cerca articoli sugli incentivi fotovoltaico 2026"* ## Links - [Solematica](https://www.solematica.it) — Main platform - [Provider Comparison](https://www.solematica.it/confronto-offerte) — Compare 11 Italian solar providers - [Solar Estimate](https://www.solematica.it/stima) — Free solar estimate tool - [Energy Guide](https://www.solematica.it/guida) — Complete energy guide - [API Documentation](https://www.solematica.it/sviluppatori) — REST API docs - [Blog](https://www.solematica.it/blog) — Energy articles and news - [npm Package](https://www.npmjs.com/package/@solematica/mcp-server) — npm registry page - [Model Context Protocol](https://modelcontextprotocol.io) — MCP specification - [MCP Servers](https://modelcontextprotocol.io/examples) — More MCP servers ## Related - [Google Solar API](https://developers.google.com/maps/documentation/solar) — Satellite-based solar potential - [PVGIS](https://re.jrc.ec.europa.eu/pvg_tools/en/) — EU photovoltaic estimation tool - [ARERA](https://www.arera.it) — Italian energy regulator - [Superbonus & Incentivi](https://www.solematica.it/fotovoltaico) — Italian solar incentives info ## License MIT — see [LICENSE](LICENSE) file. ## Author [Solematica](https://www.solematica.it) — [Soloweb SRL](https://www.solematica.it/chi-siamo)