Pvpc Mcp Server

io.github.rfdezPublished by GitHub account rfdezv3.2.3Updated Oct 24, 2026

Retrieve daily PVPC electricity tariffs for 2.0 TD consumers, published by Red Eléctrica.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Local MCP server that lets an assistant fetch Spain's daily PVPC regulated electricity prices from Red Eléctrica's ESIOS API, filtered by date and region.

What you can do
Fetch PVPC hourly electricity tariffs for a date range and geographical area, with Spanish or English locale output and JSON results.
When to use it
Useful when you want an assistant to look up Spanish regulated electricity prices for a given day or period, compare regions, or aggregate hourly tariffs by day, month or year.
Requirements
Runs locally via npx with Node.js. Requires an ESIOS (Red Eléctrica de España) API key, passed as the --api-key CLI flag or the X-API-Key header. Network access to the ESIOS API is needed.
Before you install
The ESIOS API key is a secret; it is passed on the command line, so it may appear in shell history or process listings. The server only reads published price data and does not modify anything.

Installation

In SourceWeft

  1. Open Pvpc Mcp Server 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

Voluntary Price for the Small Consumer (PVPC) MCP Server

[License: MIT] [NPM Version]

Fetch the Voluntary Price for the Small Consumer (PVPC) published daily by Red Eléctrica at 8:15 p.m. This includes the hourly electricity tariffs that will apply the following day for consumers billed under the 2.0 TD tariff.

🧩 Components

Tools

  • fetch_prices: Fetches the Voluntary Price for the Small Consumer (PVPC) prices for a given date range and geographical area.
    • Inputs:
      • locale: Get translations for sources. Accepted values: es, en. Defaults to es.
      • startDate: Beginning of the date range to filter indicator values in iso8601 format. E.g. 2025-06-29T00:00:00.000+02:00. Defaults to the start of today.
      • endDate: End of the date range to filter indicator values in iso8601 format. E.g. 2025-06-29T23:59:59.999+02:00. Defaults to the end of today.
      • timeAggregation: How to aggregate indicator values when grouping them by time. Accepted values: sum, average. Defaults to sum.
      • timeTruncation: Tells how to truncate data time series. Accepted values: hour, day, month, year. Optional parameter.
      • geographicalAggregation: How to aggregate indicator values when grouping them by geographical ID. Accepted values: sum, average. Defaults to sum.
      • geographicalIds: Tells the geographical IDs to filter indicator values. Accepted values: 3 (España), 8741 (Península), 8742 (Canarias), 8743 (Baleares), 8744 (Ceuta), 8745 (Melilla). Defaults to 8741, 8742, 8743, 8744, 8745.
      • geographicalTruncation: Tells how to group data at geographical level when the geographical aggregation is informed. Accepted values: country, electric_system. Optional parameter.
    • Returns: Text content with the PVPC prices in JSON format.

🔧 Configuration

Requirements

You need to register an API key from Esios Red Eléctrica de España to access the Esios Red Eléctrica de España API.

You will find the API documentation at API e·sios Documentation.

Claude Desktop

Remote Server Connection

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as PVPC and the remote MCP server URL like https://mcp.example.com/mcp.

Local Server Connection

Add this to your Claude Desktop claude_desktop_config.json file. See Claude Desktop MCP docs for more info.

json
{  "mcpServers": {    "pvpc": {      "command": "npx",      "args": ["-y", "@rfdez/pvpc-mcp-server@latest", "--api-key", "your_esios_api_key"]    }  }}

💻 Development

Clone this repository and install the dependencies:

bash
npm install

Build the project:

bash
npm run build

Run the server:

bash
node dist/index.js

CLI Arguments

pvpc-mcp-server accepts the following CLI flags:

  • --transport <stdio|http>: Transport to use (stdio by default).
  • --port <number>: Port to listen on when using http transport (default 8080).
  • --api-key <key>: Your e·sios API key for authentication.

Example with http transport and port 8080:

bash
node dist/index.js --transport http --port 8080

Example with stdio transport:

bash
node dist/index.js --transport stdio --api-key YOUR_ESIOS_API_KEY

Local Configuration Example

json
{  "mcpServers": {    "pvpc": {      "command": "npx",      "args": ["-y", "tsx", "/path/to/folder/pvpc-mcp-server/src/index.ts", "--api-key", "YOUR_ESIOS_API_KEY"]    }  }}

Testing with MCP Inspector

bash
npx -y @modelcontextprotocol/inspector npx -y @rfdez/pvpc-mcp-server

License

This project is licensed under the MIT License - see the LICENSE file for details.

Source: README.md at commit c145663

Tools

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

Version history

1
  1. v3.2.3LatestSep 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