# Gasolina hoy (preciosgasolina.es) · API y MCP

> API REST y servidor MCP gratuitos, sin clave y de solo lectura con los precios oficiales de los carburantes de unas 11.500 gasolineras de España.

- Fuente de los datos: Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras). Son los precios que las gasolineras comunican al Ministerio.
- Frecuencia: dos actualizaciones al día (hacia las 8:00 y las 20:00, hora peninsular). No es tiempo real: cada respuesta lleva `meta.last_updated`, `meta.next_update` y `meta.data_age_seconds`.
- Licencia: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Atribución obligatoria: «Fuente: Gasolina hoy (preciosgasolina.es), con datos del Ministerio para la Transición Ecológica y el Reto Demográfico (Geoportal de Gasolineras).» Enlaza `meta.web_url`.
- API REST: https://api.preciosgasolina.es/v1 (sobre `{ data, meta }`, errores RFC 9457). OpenAPI 3.1: https://api.preciosgasolina.es/v1/openapi.json
- Servidor MCP: https://mcp.preciosgasolina.es/mcp (Streamable HTTP, sin estado, sin inicio de sesión, 21 herramientas de solo lectura).
- Límites por IP: 120 peticiones/min (y 20 cada 10 s); consultas pesadas, 30/min; MCP, 60 mensajes/min y 30 llamadas a herramientas/min.
- Cada página de esta documentación tiene versión en Markdown en `<ruta>/index.md` (por ejemplo, https://docs.preciosgasolina.es/empezar/primeros-pasos/index.md).

Páginas clave:

- [Primeros pasos](https://docs.preciosgasolina.es/empezar/primeros-pasos/index.md): primera petición, sobre de respuesta y primera conexión MCP.
- [Conceptos básicos](https://docs.preciosgasolina.es/empezar/conceptos-basicos/index.md): identificadores de carburantes, niveles, códigos INE, municipios y gasolineras.
- [Atribución y licencia](https://docs.preciosgasolina.es/empezar/atribucion-y-licencia/index.md)
- [Referencia de la API REST](https://docs.preciosgasolina.es/referencia/index.md)
- [Herramientas del servidor MCP](https://docs.preciosgasolina.es/mcp/herramientas/index.md)
- [Conectar el servidor MCP](https://docs.preciosgasolina.es/mcp/conectar/index.md)
- [Límites de uso](https://docs.preciosgasolina.es/conceptos/limites/index.md)
- [Errores](https://docs.preciosgasolina.es/conceptos/errores/index.md)
- [Frescura de los datos](https://docs.preciosgasolina.es/conceptos/frescura/index.md)

## Documentation Sets

- [Abridged documentation](https://docs.preciosgasolina.es/llms-small.txt): a compact version of the documentation for Gasolina hoy (preciosgasolina.es) · API y MCP, with non-essential content removed
- [Complete documentation](https://docs.preciosgasolina.es/llms-full.txt): the full documentation for Gasolina hoy (preciosgasolina.es) · API y MCP
- [Servidor MCP](https://docs.preciosgasolina.es/_llms-txt/servidor-mcp.txt): qué es, cómo conectarlo, las 21 herramientas, recursos, prompts y buenas prácticas
- [Guías de la API REST](https://docs.preciosgasolina.es/_llms-txt/gu%C3%ADas-de-la-api-rest.txt): casos de uso completos con ejemplos en curl, JavaScript y Python

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [OpenAPI 3.1 de la API REST](https://api.preciosgasolina.es/v1/openapi.json): especificación completa de los 30 endpoints
- [llms.txt de preciosgasolina.es](https://preciosgasolina.es/llms.txt): la web con los precios de hoy, guías, rutas y herramientas
- [Desarrolladores en preciosgasolina.es](https://preciosgasolina.es/desarrolladores/): API, servidor MCP, datos abiertos y widget
- [Datos abiertos](https://preciosgasolina.es/datos/): descargas completas en CSV y JSON