Solematica

Solar estimates, provider comparison, energy prices and blog for the Italian market. 6 tools, 5 free. Compare providers, analyze roofs via Google Solar API, check PUN/ARERA prices.

GitHub

@solematica/mcp-server

npm version License: MIT MCP Node.js Solematica

MCP (Model Context Protocol) server for Solematica — solar estimates, provider comparison and energy data for Italy.

This server enables AI assistants like Claude, Cursor, Windsurf, Kiro and other MCP-compatible clients to analyze solar potential, compare photovoltaic providers, check energy prices and search energy-related articles for the Italian market.

Tools

ToolDescriptionAuth
stima_solareGenerate a full solar estimate for an Italian address — production, savings, ROI, panel sizingAPI key
info_tettoSatellite roof analysis via Google Solar API — surface, orientation, segments, panel potentialFree
confronta_providerCompare 11 Italian solar providers — prices, components, warranties, transparency indexFree
dettaglio_providerFull provider detail — accessories (heat pumps, EV chargers, boilers), contacts, financingFree
prezzi_energiaCurrent Italian energy prices (PUN/ARERA) with update dateFree
cerca_articoliSearch Solematica blog articles by category or keywordFree

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add solematica npx @solematica/mcp-server

Cursor

Add to your .cursor/mcp.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:

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Other MCP Clients

Any MCP-compatible client can use this server via stdio transport:

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

Environment Variables

VariableRequiredDefaultDescription
SOLEMATICA_API_KEYOnly for stima_solare—Your API key for authenticated endpoints
SOLEMATICA_API_URLNohttps://api.solematica.it/api/v1API base URL (for self-hosted or testing)

Tool Details

stima_solare

Generates a complete solar estimate for an Italian address using Google Solar API + PVGIS 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 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 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 database, updated monthly from ARERA and GME.

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

Related

License

MIT — see LICENSE file.

Author

Solematica — Soloweb SRL

Related Servers