# gregoriofraile/gasolineras-mcp [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/gregoriofraile/gasolineras-mcp  
**GitHub Stars:** 0  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gregoriofraile-gasolineras-mcp

## Description
Fuel prices at every gas station in Spain, from the Spanish government's open data API. Find a municipality and get its stations sorted by price. No API key, no state, no telemetry.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "gasolineras-mcp": {
    "command": "uvx",
    "args": ["Con"]
  }
}
```

## Documentation

## What gregoriofraile/gasolineras-mcp MCP server does

The gregoriofraile/gasolineras-mcp MCP server exposes Spanish government fuel-price data to MCP-compatible AI clients. Its purpose is to let an agent answer questions about petrol stations and prices in Spain using public information from the Ministry for the Ecological Transition’s fuel-price API.

The server supports a municipality-based lookup flow. An agent can first identify a municipality, then request the fuel stations associated with it and receive the results ordered by price. This makes it suitable for questions such as finding the least expensive fuel in a particular Spanish municipality.

No API credential is required. The project does not retain user state, personal data, or telemetry according to the supplied documentation.

## How it works

The server is a local Python MCP process that the client starts and communicates with over stdio. It does not operate as a centrally installed service. Instead, the MCP client launches the command configured by the user, and the process retrieves public fuel data when the agent invokes a tool.

The documented tools are:

- `buscar_municipio`: helps locate a municipality.
- `precios_carburantes`: returns stations with prices sorted by price.

The repository describes the server as a thin interface around the Spanish government’s public API. It is useful when the selected AI client cannot directly use a terminal or make the required API requests itself, including Claude Desktop.

## Setup and configuration

The recommended installation uses `uvx`, which downloads and runs the Python package from PyPI:

```bash
uvx gasolineras-mcp
```

Install `uv` first if it is not already available. For Claude Desktop, add a server entry with `uvx` as the command and `gasolineras-mcp` as its argument, then restart the application. Claude Code, Codex CLI, Gemini CLI, and opencode are also documented with client-specific registration examples.

A manual installation is available for users who want to clone the repository. It requires Python 3.10 or newer, after which the package can be installed into a virtual environment with `pip install .`. The client configuration must then point to the resulting `gasolineras-mcp` executable.

## Tools and capabilities

The gregoriofraile/gasolineras-mcp MCP server provides two documented capabilities:

- Municipality discovery through `buscar_municipio`.
- Price-based station results through `precios_carburantes`.

Together, these tools support municipality-specific fuel-price searches rather than a general-purpose location or routing service. The available material does not describe fuel types, distance calculations, route planning, historical prices, or booking features.

## Limitations and notes

Results depend on the data exposed by the Spanish government’s public fuel-price API. The documentation does not specify update frequency, geographic coverage outside Spain, response fields, or filtering options beyond municipality lookup and price ordering.

After registering the server, start a new client session so the MCP tools are loaded. The README recommends checking the client’s server list and confirming that a request visibly invokes `precios_carburantes`; otherwise, an AI client may answer without using the server. The project is released under the MIT license and requires no API key, application state, or telemetry configuration.

_Full upstream README: https://allmcps.com/mcp/gregoriofraile-gasolineras-mcp/readme_