Gasolineras MCP

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:

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.