Solematica MCP Server

io.github.hanickerPublished by GitHub account hanickerv1.0.2Updated Oct 24, 2026

Solar estimates, provider comparison, energy prices and blog for Italy

The publisher's own server: Proofite

VerifiedSTDIODesktop onlyLocation & Lifestyle Data & Analytics Business & Commerce

Server details

Identifier: io.github.hanicker/solematica-mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account hanicker for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.hanicker%2Fsolematica-mcp.svg)](https://sourceweft.com/mcp/io.github.hanicker%2Fsolematica-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Lets an assistant produce Italian solar estimates, compare photovoltaic providers, check energy prices, and search energy articles.

What you can do: Provides six tools for the Italian solar market: stima_solare generates a full estimate for an address (production, savings, ROI, panel sizing), info_tetto analyses a roof from satellite data, confronta_provider and dettaglio_provider compare and detail 11 Italian solar providers, prezzi_energia returns current PUN/ARERA energy prices, and cerca_articoli searches the Solematica blog.
When to use it: Useful when answering questions about photovoltaic potential for an Italian address, comparing solar installer offers, checking Italian energy prices, or finding Italian energy articles. Most tools are free and public, so it can be added just for reference data.
Requirements: Runs locally via npx as the npm package @solematica/mcp-server over stdio; Node.js is needed. The SOLEMATICA_API_KEY environment variable is required only for stima_solare; SOLEMATICA_API_URL optionally overrides the API base URL. Network access to the Solematica API is required.

Before you install

stima_solare consumes credits per estimate and needs SOLEMATICA_API_KEY, obtained by registering as a partner. Addresses and coordinates submitted to the tools are sent to the Solematica API and, for roof analysis, to Google Solar API. No write, delete, or payment actions are described.

Installation

In SourceWeft

Open Solematica MCP Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

json

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

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

Claude Code

Cursor

Add to your .cursor/mcp.json:

json

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

{  "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"      }    }  }}

{  "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:

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"

License

MIT — see LICENSE file.

Author

Solematica — Soloweb SRL

Source: README.md at commit 3e93504

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

Other Proofite integrations

Proofite

com.proofiteOfficial publisher

Lets an assistant read a Proofite AI-written daily news briefing and retune the feeds, topics and settings behind it.

Streamable HTTPWeb executableAuth

Productivity & Workflow40 toolsOct 24, 2026

Solematica MCP Server

Overview

Installation

In SourceWeft

Other MCP clients

README

@solematica/mcp-server

Tools

Quick Start

Claude Desktop

Claude Code

Cursor

Windsurf

Other MCP Clients

Authentication

Environment Variables

Tool Details

`stima_solare`

`info_tetto`

`confronta_provider`

`dettaglio_provider`

`prezzi_energia`

`cerca_articoli`

Examples

Links

Related

License

Author

Tools

Version history

Score

Other Proofite integrations

Proofite