Wattprice

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 3, 2026

Fetch PVPC electricity prices from Spain's ESIOS API by date range and area.

VerifiedSTDIODesktop only

Overview

Wattprice's local MCP server; no sign-in required; STDIO.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Wattprice in the dashboard and add it to a workspace.
  2. 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

wattprice

What does electricity cost right now under Spain's regulated PVPC tariff? wattprice asks the ESIOS API — the data service run by Red Eléctrica de España — for the PVPC (Voluntary Price for the Small Consumer) indicator and returns the prices payload as JSON, for a date range and geographical area you choose.

Everything except the API key itself is optional, with the defaults the upstream documents:

  • locale — es (default) or en
  • startDate / endDate — ISO 8601 bounds; an absent range means today, start to end of day
  • timeAggregation — sum (default) or average
  • timeTruncation — hour, day, month, or year
  • geographicalAggregation — sum (default) or average
  • geographicalIds — string IDs: 3 España, 8741 Península, 8742 Canarias, 8743 Baleares, 8744 Ceuta, 8745 Melilla; defaults to the five system IDs 8741–8745
  • geographicalTruncation — country or electric_system

Configuration

You bring your own ESIOS API key (free registration at esios.ree.es):

bash
export ESIOS_API_KEY="your key"

Without it, wattprice does not guess: the call fails with an error naming ESIOS_API_KEY, and no prices are invented. ESIOS_API_BASE overrides the API base URL (https://api.esios.ree.es by default).

CLI

bash
ESIOS_API_KEY=... npx @reneturcios/wattprice pricesESIOS_API_KEY=... npx @reneturcios/wattprice prices --locale en --time-truncation day --geographical-ids 8741npx @reneturcios/wattprice --version

Output is the ESIOS prices payload as JSON. Exit codes: 0 on success, 1 on a runtime error (including a missing key or a non-200 upstream response), 2 on a usage error.

MCP server

bash
npx -y @reneturcios/wattprice mcp

MCP client config:

json
{  "mcpServers": {    "wattprice": {      "command": "npx",      "args": ["-y", "@reneturcios/wattprice", "mcp"],      "env": { "ESIOS_API_KEY": "your key" }    }  }}

Tools

  • fetch_prices — Fetch PVPC prices for a given date range and geographical area. All arguments are optional; see the defaults list above.

Docker

bash
docker run -i -e ESIOS_API_KEY="your key" ghcr.io/cloudcorprecords/wattpricedocker run --rm -e ESIOS_API_KEY="your key" ghcr.io/cloudcorprecords/wattprice prices --locale en

Development

bash
npm installnpm run build   # tsc -> dist/npm test        # tsx --test test/*.test.ts (fake fetch, no network)npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios

Source: README.md at commit f4477c0

Tools

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

Version history

1
  1. v0.1.0LatestNov 3, 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