GET/v1/prices?fuel=diesel

// Ejemplo ilustrativo
{
  "data": { "fuels": [{
    "fuel": "diesel",
    "average": 1.481 }] },
  "meta": {
    "last_updated": "2026-10-07T06:12:00Z",
    "next_update": "2026-10-07T18:10:00Z",
    "license": "CC BY 4.0",
    "web_url": "https://preciosgasolina.es/…"
  }
}

Precios de carburantes de España para tus apps y agentes de IA

Una API REST y un servidor MCP gratuitos, sin clave y de solo lectura con los precios oficiales de unas 11.500 gasolineras, del Ministerio para la Transición Ecológica y el Reto Demográfico.

Empieza en 5 minutos Conectar el servidor MCP

Gasolina hoy (preciosgasolina.es) publica los precios que las gasolineras comunican al Ministerio para la Transición Ecológica y el Reto Demográfico. Esta documentación explica cómo usarlos desde tu código con la API REST (https://api.preciosgasolina.es/v1) o desde un asistente de IA con el servidor MCP (https://mcp.preciosgasolina.es/mcp).

Gratissin registro ni clave de API
Solo lecturaGET (y un POST para rutas propias)
2 veces al díahacia las 8:00 y las 20:00, hora peninsular
CC BY 4.0con atribución a Gasolina hoy y al Ministerio
~11.500gasolineras de venta al público

Qué puedes hacer

API REST

30 endpoints en JSON: precio medio por territorio, gasolineras más baratas y cercanas, ficha de cada gasolinera, histórico de 90 días, carreteras, rutas, contenido y calculadoras. Sobre { data, meta } y errores RFC 9457.

Referencia de la API

Servidor MCP

21 herramientas de solo lectura para agentes de IA, con transporte Streamable HTTP, sin estado y sin inicio de sesión. Funciona en Claude, ChatGPT, Cursor, VS Code y Claude Code.

Herramientas del MCP

Asistentes de IA

¿No programas? Añade el conector en Claude o ChatGPT y pregunta por el diésel más barato de tu provincia o por el coste de un viaje, con datos oficiales.

Cómo se conecta

Datos abiertos

¿Necesitas todas las gasolineras o series completas? Descarga las medias diarias de 90 días y todas las gasolineras con los precios de hoy en CSV y JSON, con la misma licencia.

Descargar los datos

Por dónde empezar

Primeros pasosTu primera petición con curl, cómo leer la respuesta y tu primera conexión MCP.

Conceptos básicosCarburantes, niveles territoriales, códigos INE y cómo obtener cada identificador.

Gasolinera más barata cercaGuía completa con curl, JavaScript y Python.

Atribución y licenciaQué texto mostrar junto a los datos y cómo enlazar la fuente.

Límites de usoPeticiones por minuto, topes de parámetros y cómo reintentar.

Frescura de los datosCuándo se actualizan los precios y cómo saber su antigüedad.

Para agentes y LLM

Cada página tiene una versión en Markdown en <ruta>/index.md (por ejemplo, /empezar/primeros-pasos/index.md). El índice para modelos de lenguaje está en /llms.txt, la documentación completa en /llms-full.txt y la especificación de la API en openapi.json (OpenAPI 3.1).

Fuente de los datos: Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras). Datos de la API y del servidor MCP con licencia CC BY 4.0: cita Gasolina hoy y la fuente.