@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

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 — 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/ARERA) with update date	Free
cerca_articoli	Search Solematica blog articles by category or keyword	Free

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

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

• Solematica — Main platform
• Provider Comparison — Compare 11 Italian solar providers
• Solar Estimate — Free solar estimate tool
• Energy Guide — Complete energy guide
• API Documentation — REST API docs
• Blog — Energy articles and news
• npm Package — npm registry page
• Model Context Protocol — MCP specification
• MCP Servers — More MCP servers

Related

• Google Solar API — Satellite-based solar potential
• PVGIS — EU photovoltaic estimation tool
• ARERA — Italian energy regulator
• Superbonus & Incentivi — Italian solar incentives info

License

MIT — see LICENSE file.

Author

Solematica — Soloweb SRL