Solarnetwork

Read-only MCP server for SolarNetwork — query solar generation, consumption, and other DER telemetry over the SolarQuery API. Zero config against a public demo node. Public (/pub) mode only; authenticated (sec) mode is not implemented.

Setup

npm install
npm run build
npm test        # offline, against captured fixtures
npm run smoke   # live check against demo node 108

MCP client config (stdio):

{
  "mcpServers": {
    "solarnetwork": {
      "command": "node",
      "args": ["/path/to/solarnetwork-mcp/dist/index.js"]
    }
  }
}

Tools

Tool	Answers
get_reportable_interval	What date range has data? (call first)
list_sources	Which source IDs exist?
get_latest	Most recent datum per source
query_datum	Time series between two node-local dates (Day/Hour/Month; raw guarded)
get_meter_reading	Energy used/generated over a period

Responses are compact { data, meta } JSON; meta reports count, truncated, and paging. Day aggregation by default, 500-row cap, raw queries over 7 days require allowRaw.

Demo node

Node 108 — public, posting since 2013, time zone Pacific/Auckland. Sources: DB (bidirectional meter, richest stream), Main (intermittent), A/B/C (phase watts), OfficeTemp (dormant). A complete month to query: June 2026.

Environment

Variable	Default
SN_HOST	https://data.solarnetwork.net
SN_TOKEN, SN_SECRET	unset; sec mode is unimplemented and the server fails fast if they are set