# Pvpc Mcp Server

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-rfdez-pvpc-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [rfdez](https://agentstack.voostack.com/s/rfdez)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 3.2.3
- **License:** MIT
- **Upstream author:** [rfdez](https://github.com/rfdez)
- **Source:** https://github.com/rfdez/pvpc-mcp-server
- **Website:** https://www.esios.ree.es/en/pvpc

## Install

```sh
agentstack add mcp-rfdez-pvpc-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Voluntary Price for the Small Consumer (PVPC) MCP Server

[](https://opensource.org/licenses/MIT)
[](https://www.npmjs.com/package/@rfdez/pvpc-mcp-server)

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](https://www.esios.ree.es/es/pagina/api) to access the Esios Red Eléctrica de España API.

You will find the API documentation at [API e·sios Documentation](https://api.esios.ree.es/).

### 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](https://modelcontextprotocol.io/quickstart/user) 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 `: Transport to use (`stdio` by default).
- `--port `: Port to listen on when using `http` transport (default `8080`).
- `--api-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](LICENSE) file for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [rfdez](https://github.com/rfdez)
- **Source:** [rfdez/pvpc-mcp-server](https://github.com/rfdez/pvpc-mcp-server)
- **License:** MIT
- **Homepage:** https://www.esios.ree.es/en/pvpc

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v3.2.3 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **3.2.3** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-rfdez-pvpc-mcp-server
- Seller: https://agentstack.voostack.com/s/rfdez
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.