PVPC

You can run the PVPC MCP Server to fetch the Voluntary Price for the Small Consumer (PVPC) prices published daily by Esios and expose the hourly tariffs to MCP clients. This server makes it easy to integrate Esios PVPC data into your own dashboards, automation, or energy-management workflows.

How to use

You can connect to the PVPC MCP Server either over HTTP as a remote MCP endpoint or locally as a stdio server. Use the HTTP URL to query prices remotely, or run the local server on your machine and connect via stdio. The server retrieves PVPC prices for a date range and geographic area and returns them in JSON format for your client to consume.

Common usage patterns include fetching daily PVPC prices for the next day to display or store tariffs, and aggregating prices by hour or by geographical region depending on your needs.

How to install

Prerequisites: install Node.js and npm on your machine.

Install dependencies and build the project.

npm install

npm run build

Run the server. You can run it in http mode or stdio mode.

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

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

Configuration and example configurations

Set up your MCP client to connect to PVPC. You can either provide a remote HTTP endpoint or run the server locally with stdio.

{
  "mcpServers": {
    "pvpc_http": {
      "type": "http",
      "name": "pvpc_http",
      "url": "https://mcp.example.com/mcp",
      "args": []
    }
  }
}

Additional usage notes

If you prefer a local runtime, you can start the server with NPX and pass your API key as shown in the example below. This keeps your API key out of persistent files while still enabling authentication with Esios.

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

Testing and examples

You can verify the server by starting it in stdio mode and using an MCP inspector or your MCP client to request PVPC data for a given date range and region.

Available tools

fetch_prices

Fetches PVPC prices for a given date range and geographical area. Supports locale, start/end dates, time aggregation, and geographical filters.