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

> Versión Markdown de https://docs.preciosgasolina.es/ · Actualizado: 2026-10-07 · Índice para LLM: https://docs.preciosgasolina.es/llms.txt

Documentación de la API REST y del servidor MCP de Gasolina hoy. Precios oficiales de las gasolineras de España, gratis, sin clave y con CC BY 4.0.

**Gasolina hoy** ([preciosgasolina.es](https://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`).

- **Gratis**sin registro ni clave de API
- **Solo lectura**GET (y un POST para rutas propias)
- **2 veces al día**hacia las 8:00 y las 20:00, hora peninsular
- **CC BY 4.0**con atribución a Gasolina hoy y al Ministerio
- **\~11.500**gasolineras 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](https://docs.preciosgasolina.es/referencia/)

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](https://docs.preciosgasolina.es/mcp/herramientas/)

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](https://docs.preciosgasolina.es/mcp/conectar/)

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](https://preciosgasolina.es/datos/)

## Por dónde empezar

[Primeros pasos](https://docs.preciosgasolina.es/empezar/primeros-pasos/)Tu primera petición con curl, cómo leer la respuesta y tu primera conexión MCP.

[Conceptos básicos](https://docs.preciosgasolina.es/empezar/conceptos-basicos/)Carburantes, niveles territoriales, códigos INE y cómo obtener cada identificador.

[Gasolinera más barata cerca](https://docs.preciosgasolina.es/guias/gasolinera-mas-barata-cerca/)Guía completa con curl, JavaScript y Python.

[Atribución y licencia](https://docs.preciosgasolina.es/empezar/atribucion-y-licencia/)Qué texto mostrar junto a los datos y cómo enlazar la fuente.

[Límites de uso](https://docs.preciosgasolina.es/conceptos/limites/)Peticiones por minuto, topes de parámetros y cómo reintentar.

[Frescura de los datos](https://docs.preciosgasolina.es/conceptos/frescura/)Cuá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](https://docs.preciosgasolina.es/empezar/primeros-pasos/index.md)). El índice para modelos de lenguaje está en [/llms.txt](https://docs.preciosgasolina.es/llms.txt), la documentación completa en [/llms-full.txt](https://docs.preciosgasolina.es/llms-full.txt) y la especificación de la API en [openapi.json](https://api.preciosgasolina.es/v1/openapi.json) (OpenAPI 3.1).
