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