Skip to main content
Glama

logistica-hidrocarburos-cnmc

CI

Pipeline de ingeniería de datos que convierte la información pública de logística de hidrocarburos de la CNMC en un dataset histórico, verificado y actualizado cada mes.

Extracción (HTML y PDF) · Modelo con historial SCD2 · Capas bronze/silver/gold · Publicación mensual en CSV, Parquet y SQLite · API REST y servidor MCP

Aviso legal. Proyecto no oficial, no afiliado a la CNMC ni a ningún operador. Los datos son públicos y los publica la CNMC en hidrocarburos.cnmc.es. Este repositorio los copia y los estructura tal cual, sin garantía de exactitud ni de actualización. Para cualquier decisión, consulte la fuente original.

Cómo usarlo

Hay dos formas de uso: descargar los datos de la última Release datos-*, o clonar el repositorio y consultarlos con un cliente MCP o con la API REST local.

1. Descargar los datos

Cada mes se publica una Release datos-AAAA-MM-DD con la capa gold y la capa silver completa. Su uso no requiere instalar el proyecto. Contiene seis ficheros:

Fichero

Contenido

csv.zip

26 ficheros CSV con las filas vigentes: 4 tablas planas (precios_completos, condiciones_completas, origen_destino_completo, capacidades_completas) con operador, instalación, comunidad, producto, categoría, valor, unidad, fecha y enlace a la página de la CNMC; y las 22 tablas normalizadas. UTF-8 con BOM, separador ; y coma decimal (formato de Excel en español)

parquet.zip

Las mismas 26 tablas en Parquet, con tipos de columna

historial_parquet.zip

20 ficheros Parquet, uno por tabla con historial, con todas las versiones de cada fila y una columna vigente. El portal de la CNMC solo publica el estado actual

cnmc_logistica.db

Base SQLite completa: historial, vistas <tabla>_vigentes y registro de ejecuciones

cnmc_logistica.db.sha256

Huella sha256 de la base

DICCIONARIO.md

Descripción de cada tabla y columna, unidades y lectura del historial

import pandas as pd

precios = pd.read_parquet("historial/precios.parquet")
cambios = precios[precios.vigente == 0]  # versiones anteriores y precios retirados

2. Consultarlos clonando el repositorio

Requiere uv, que instala Python 3.12. El repositorio incluye la base cargada (data/cnmc_logistica.db). El servidor solo lee esa base; no hace peticiones al portal de la CNMC.

git clone https://github.com/mariogmg/logistica-hidrocarburos-cnmc
cd logistica-hidrocarburos-cnmc
uv sync
uv run cnmc-logistica info

Cliente MCP. El servidor usa el transporte stdio por defecto. Para Claude Desktop, añadir este bloque a su fichero de configuración con la ruta del repositorio y reiniciar la aplicación. El bloque está también en ejemplos/claude_desktop_config.json; las rutas del fichero de configuración y el transporte HTTP están en ejemplos/LEEME.md.

{
  "mcpServers": {
    "logistica-hidrocarburos-cnmc": {
      "command": "uv",
      "args": ["run", "--directory", "/RUTA/A/logistica-hidrocarburos-cnmc", "cnmc-logistica", "servir"]
    }
  }
}

API REST local. Con el transporte HTTP, la misma aplicación sirve el MCP en /mcp, la API REST en /api/v1 (14 rutas GET, paginadas con limit y offset), la comprobación /salud y la documentación OpenAPI en http://localhost:8000/docs:

uv run cnmc-logistica servir --transporte http
curl "http://localhost:8000/api/v1/precios?categoria=almacenamiento&limit=5"

El despliegue en un servidor (MCP y API detrás de Caddy con HTTPS) es opcional y está documentado en despliegue/LEEME.md. No hay ninguna instancia pública.

Related MCP server: gasolineras-mcp

Qué es

La CNMC publica las condiciones de acceso a las instalaciones de almacenamiento y transporte de productos petrolíferos de todos los operadores: precios, mermas, servicios incluidos, rutas origen-destino y capacidades. El portal solo muestra el estado actual, y cada operador describe sus servicios con sus propios términos.

Este proyecto:

  1. Descarga el portal una vez al mes (569 recursos entre páginas HTML y PDF en la primera ejecución, el 11/11/2026), con un intervalo mínimo de 1 s entre peticiones, reintentos con espera exponencial y un User-Agent que identifica el proyecto. Consulta robots.txt en cada ejecución.

  2. Bronze: guarda el crudo sin modificar en raw/AAAA-MM-DD/, con el sha256 de cada fichero y un manifiesto al que solo se añaden líneas.

  3. Silver: carga un modelo normalizado con historial en SQLite. No se borra ni se sobrescribe ninguna fila: cada cambio de un precio o de una condición es una versión nueva. La normalización se limita a lo necesario para comparar: categoría de servicio, tipo de precio, unidad y servicios incluidos.

  4. Gold: publica las vistas vigentes y cuatro tablas planas en CSV y Parquet, en una Release mensual.

  5. Sirve los datos con una API REST y un servidor MCP que solo leen la base SQLite.

Cifras de la foto del 11/11/2026: 115 instalaciones (71 de almacenamiento y 44 aeroportuarias), 258 detalles (un producto en una instalación), 44 operadores en el buscador de la CNMC (31 con instalaciones), 1.579 precios de las páginas, 2.163 rutas origen-destino y 27 PDF (66 precios de tarifas, 2.495 celdas de matrices, 18 bonificaciones, 21 condiciones con cantidad y 365 capacidades). Las 3.237 cifras de esos PDF están en la base o en la lista de descartes justificados.

Arquitectura

Arquitectura del proyecto

Bronze: crudo inmutable de cada ejecución. Silver: modelo normalizado con historial. Gold: vistas vigentes y tablas planas para consumo.

  • ETL y servidor están separados. El servidor, la API y la capa de consultas no importan el descargador ni los parsers. Tres tests lo comprueban.

  • La capa bronze es la fuente de verdad. reconstruir regenera la capa silver completa a partir de raw/, sin red. Un error de interpretación se corrige sin volver a descargar.

  • El contenido inesperado no detiene la carga. Un bloque o un PDF que no se puede interpretar se registra en la tabla incidencias (recurso, operador y texto), su crudo se conserva y la carga continúa. Si hubo errores, la orden termina con código distinto de cero y el workflow queda marcado como fallido.

Uso

La consulta de los datos se describe en Cómo usarlo. La descarga del portal y la carga de la base requieren las dependencias del ETL: uv sync --extra etl. exportar requiere además --extra exportar para generar Parquet.

Órdenes de la CLI

Orden

Qué hace

¿Usa la red?

descubrir

Recorre los mapas y el buscador y escribe config/inventario.json, con control cruzado entre ambos

Sí

actualizar

Descarga el inventario a raw/ (bronze) y carga la foto en la base (silver)

Sí

reconstruir

Crea una base nueva a partir de todas las fotos de raw/

No

exportar

Genera los ficheros de la Release datos-*: base, sha256, CSV, Parquet y diccionario

No

descargar-releases

Descarga a raw/ el crudo publicado en las Releases raw-*

Solo GitHub

servir

Arranca el MCP (--transporte stdio) o el MCP y la API REST (--transporte http)

No

info

Versión, fotos disponibles y filas de cada tabla

No

uv run cnmc-logistica descubrir
uv run cnmc-logistica actualizar     # al menos 1 s por recurso
uv run cnmc-logistica reconstruir --salida /tmp/nueva.db
uv run cnmc-logistica exportar --salida exportacion
uv run cnmc-logistica servir --transporte http --puerto 8000

Variables de entorno del servidor:

Variable

Efecto

CNMC_BD

Ruta de la base que se sirve. Por defecto, data/cnmc_logistica.db

CNMC_MCP_TOKEN

Si se define, /mcp exige ese token Bearer. No afecta a la API REST

CNMC_MCP_HOSTS_PERMITIDOS

Cabeceras Host admitidas en /mcp, separadas por comas. Por defecto, solo las locales

Docker

docker build -t cnmc-logistica .
docker run --rm -p 8000:8000 cnmc-logistica      # MCP en /mcp y API REST en /api/v1

Herramientas MCP

El servidor MCP expone 12 herramientas de solo lectura. La API REST usa la misma capa de consultas (consultas.py), por lo que ambas devuelven los mismos datos. El SQL libre solo está disponible en el MCP.

Herramienta

Función

estado

Última foto, volumen de datos, incidencias y esquema de tablas

listar_operadores

Operadores con su nº de instalaciones por tipo y nombres anteriores

listar_instalaciones

Filtros por operador, tipo, comunidad y producto

ver_instalacion

Ficha completa: detalles, precios, condiciones y capacidad

buscar_precios

Precios vigentes (de la página y de los PDF, con su fuente) por operador, categoría, producto, comunidad o texto

comparar_servicio

Compara una categoría entre instalaciones y operadores, solo entre comparables

historial_precio

Todas las versiones de los precios de un detalle

precios_origen_destino

Coste de llevar producto de un origen a una instalación

capacidades

Capacidad (miles de m³) por compañía, instalación y producto

reconsignaciones

Matrices de los PDF: reconsignación entre instalaciones, consignación de éster y origen-destino

bonificaciones

Bonificaciones y compensaciones de los contratos a largo plazo

consulta_sql

Una sentencia SELECT, con cuatro protecciones: base abierta en solo lectura, query_only, autorizador que solo admite lectura y límite de trabajo y de filas

Ejemplos de preguntas para un cliente MCP

  • ¿Cuántos operadores hay y cuántas instalaciones tiene cada uno?

  • ¿Qué cuota de instalaciones tiene Exolum por tipo?

  • Compara el precio de almacenamiento de queroseno en aeropuertos, separando «almacenamiento» de «servicios aeroportuarios».

  • ¿Qué operadores ofrecen almacenamiento en Canarias y a qué precio?

  • ¿Qué mermas aplican los distintos operadores al gasóleo?

  • ¿Cuánto cuesta llevar producto desde Huelva hasta Cartagena?

  • ¿Ha cambiado el precio de las transferencias de Exolum en Puxeiros?

  • ¿Cuánto cuesta reconsignar gasóleo de Huelva a Zaragoza?

  • ¿Qué bonificaciones tienen los contratos a largo plazo de queroseno?

  • ¿Cuánto cobra DISA por los servicios logísticos de gasolinas en cada isla?

Modelo de datos

La capa silver tiene 22 tablas: 20 con historial y 2 de registro (ejecuciones e incidencias). Usa los dos niveles de identificador del portal: instalación (id_tanque) y detalle (id_tanque_instalacion, un producto dentro de una instalación). Los precios pertenecen al detalle, y cada detalle tiene su titular.

Tabla

Contenido

operadores, operadores_nombres

Código estable del buscador e historial de sus nombres

instalaciones

Tipo (almacenamiento / aeroportuaria) y comunidad

detalles, detalle_productos

Titular, conexión a oleoducto y productos normalizados

precios

Un valor por fila, con categoria_servicio, tipo_precio, tipo_valor y unidad

condiciones

Mermas y demás condiciones (valor numérico si lo hay, y texto)

servicios_incluidos

Lista «Incluye:» de cada servicio principal

precios_origen_destino, notas_origen_destino

Rutas (ofrecida / no_ofrecida) y notas al pie

capacidades

PDF global de capacidades, enlazado a id_tanque

documentos, filas_documento

Metadatos y tablas genéricas de cada PDF

enlaces_documento

Qué línea de precios de qué detalle remite a qué PDF

precios_pdf

Tarifas de los PDF (concepto → precio), con categoría, unidad y año

matrices_pdf

Matrices origen × destino de los PDF (vista reconsignaciones)

bonificaciones

Bonificaciones y compensaciones: tramo, condición, valor y unidad

condiciones_pdf

Cantidades con unidad dentro de las notas (plazos en días, mínimos en toneladas…)

notas_pdf

Texto íntegro de las notas solo explicativas de cada PDF

cobertura_pdf

Por PDF: cifras totales, guardadas, descartadas y sin cubrir

ejecuciones, incidencias

Registro de cada carga: altas, cambios, desapariciones y avisos

La capa gold son las vistas <tabla>_vigentes y las cuatro tablas planas de la Release (precios_completos, condiciones_completas, origen_destino_completo y capacidades_completas), descritas en DICCIONARIO.md.

Cada actualizar escribe su resumen (fecha y hora, versión, cifras e incidencias) en raw/AAAA-MM-DD/ejecuciones.jsonl. reconstruir recupera de ahí las ejecuciones originales (origen = 'registro') y se registra a sí misma con tipo = 'reconstruccion'.

Historial (SCD tipo 2)

Cada fila lleva primera_vez_visto y ultima_vez_visto (fechas de foto). Si el dato sigue igual solo avanza ultima_vez_visto; si cambia, la fila antigua se conserva y se inserta otra. Los triggers de la base rechazan cualquier DELETE y cualquier UPDATE que no sea avanzar ultima_vez_visto. Las vistas <tabla>_vigentes muestran lo visto en la última foto. fecha_precio es la vigencia que publica la CNMC (puede faltar) y anio_tabla el año cuando la fuente solo da el año.

Cómo se evita comparar servicios distintos

  • tipo_precio: numerico, regla («según contrato», «coste real + 3 %»…), texto o pdf (remite a un documento). Si no es numérico, valor es nulo y se guarda el texto original.

  • tipo_valor: unico, max o min, cada uno con su fecha.

  • categoria_servicio: sale de config/categorias_servicio.yaml (etiqueta + tipo de instalación → categoría). No se infiere con expresiones regulares: una etiqueta que no está en el fichero queda como sin_categoria y genera un aviso.

  • Indicadores incluye_transporte, incluye_almacenamiento, incluye_expedicion e incluye_puesta_a_bordo, derivados de la lista «Incluye:» mediante config/indicadores_incluye.yaml.

  • comparar_servicio solo agrupa precios con la misma categoría, los mismos indicadores y la misma unidad, y avisa cuando hay más de un grupo.

Extracción de los PDF

Parte de los precios no está en la página: el detalle remite a un PDF. Cada tipo de PDF tiene un parser, elegido por el título del documento, que trabaja sobre palabras con coordenadas. Cada valor guarda página, posición y texto original para su auditoría.

  • Todas las remisiones a PDF se resuelven. La vista lineas_pdf_sin_resolver lista las líneas con tipo_precio = 'pdf' cuyo documento no tiene datos estructurados; debe estar vacía, y si no lo está la carga registra un error.

  • La cobertura se comprueba en cada carga. Cada palabra con cifras de cada PDF debe estar en la base (como valor, dentro de una etiqueta o en una nota guardada) o en la lista de descartes justificados de config/descartes_pdf.yaml. Una cifra sin cubrir es un error cifra_pdf_sin_cubrir y la ejecución termina como fallida. El resultado se guarda en la tabla cobertura_pdf. En la foto del 11/11/2026: 3.237 cifras, 97 descartadas con justificación, 1 ilegible y 0 sin cubrir.

  • No se infieren valores. Una cifra que no se puede interpretar con certeza (p. ej. «01021», sin coma) se guarda con valor nulo, su texto original y un aviso.

  • El OCR es un respaldo. Una página sin capa de texto se lee con Tesseract (uv sync --extra ocr). Esos valores llevan metodo = 'ocr' y generan un aviso de revisión. El OCR no se aplica a páginas con capa de texto.

  • Las tarifas compartidas no se repiten en las consultas. Una tarifa en PDF se aplica a todos los detalles que remiten a ella. buscar_precios y comparar_servicio la devuelven una vez, con aplica_a (nº de detalles e instalaciones, y la lista con detallar_aplicacion=true). En la tabla plana precios_completos aparece una vez por detalle.

  • El enlace se hace por datos, no por nombres. Cada fila de las tablas origen-destino del PDF se une al detalle cuyos precios en la página web son exactamente los mismos; las matrices de reconsignación heredan esa identificación por nombre exacto.

Decisiones de diseño

Decisión

Motivo

Capa bronze inmutable y capa silver reconstruible

Un error de un parser se corrige sin perder datos y sin volver a descargar

Parsers guiados por etiquetas de texto («PRODUCTOS:», «Incluye:»…)

El texto visible cambia menos que las clases CSS

Correspondencias en ficheros YAML

Las reglas de negocio se revisan sin leer código

Operador = código del buscador

Los nombres cambian (Cepsa → Moeve); el código no

Control cruzado fichas ↔ buscador y HTML ↔ PDF

Detecta descargas incompletas; detectó un error de paginación durante el desarrollo

Peticiones sin cookies

El buscador guarda la paginación en la sesión, lo que alteraba la búsqueda siguiente

Decodificación cabecera → UTF-8 → ISO-8859-1

El portal declara ISO-8859-1 en el <meta> pero sirve UTF-8

0,00 = ruta no ofrecida

En origen-destino un cero no es un precio; se guarda NULL + estado

SQLite en el repositorio

La consulta solo requiere clonar; el historial se versiona con el código

Actualización automática y reconstrucción

  • CI en cada push a una rama: ruff, pytest, construcción del paquete, construcción de la imagen Docker y arranque del despliegue con docker compose. Los tests usan páginas y PDF del portal guardados como fixtures y no acceden a la red.

  • Actualización mensual (día 2 de cada mes, o manual): ejecuta descubrir y actualizar, publica el crudo en una Release raw-AAAA-MM-DD (bronze), publica la Release datos-AAAA-MM-DD (silver y gold) si la carga terminó sin errores, y hace commit de la base y del inventario. Si hubo errores, el trabajo queda como fallido después de conservar lo descargado.

La base se reconstruye desde cero con dos órdenes:

uv run cnmc-logistica descargar-releases     # baja a raw/ todo el crudo publicado
uv run cnmc-logistica reconstruir --reemplazar

descargar-releases baja todos los ficheros de todas las Releases raw-*, comprueba su sha256, deja cada foto en raw/AAAA-MM-DD/ (las descargas adicionales de un mismo día, en _ejecuciones/N/) y une sus ejecuciones.jsonl sin duplicar líneas. reconstruir recupera todas las actualizaciones registradas y añade la reconstrucción como una ejecución más.

Limitaciones conocidas

  • El historial empieza el 11/11/2026; no hay datos anteriores. Con una sola foto, el historial coincide con lo vigente.

  • El paso del workflow mensual que publica la Release datos-* no se ha ejecutado todavía en GitHub Actions: la Release datos-2026-11-11 se generó con exportar y se subió a mano.

  • La provincia no se publica de forma estructurada y no se guarda en esta versión.

  • El portal no fecha las rutas origen-destino: solo se conoce el año de la tabla (del PDF).

  • Los productos se separan por comas y por « y », sin fusionar variantes («Gasóleo marino» y «Gasóleos marinos» son dos valores).

  • Un PDF de un tipo nuevo no tiene parser: se registra el error pdf_sin_parser, sus cifras quedan sin cubrir y requiere un parser nuevo. No se infiere su estructura.

  • Los precios de los PDF solo tienen año (anio_tabla), no fecha de vigencia.

  • El PDF de búnker de Exolum no indica la unidad de sus precios; se guarda nula.

  • A 11/11/2026 ningún PDF del portal ha necesitado OCR. El respaldo se prueba con una página escaneada de prueba; esos tests se omiten si Tesseract no está instalado.

Desarrollo

uv sync --extra etl --extra ocr --extra exportar   # ETL, OCR y exportación
uv run ruff check . && uv run ruff format --check .
uv run pytest

Los hooks del repositorio se activan una vez por copia:

git config core.hooksPath .githooks

El hook commit-msg elimina de los mensajes de commit las líneas de coautoría añadidas por herramientas automáticas.

Licencia

Código bajo licencia MIT. Los datos son de la CNMC y de los operadores que los declaran.

Available Tools

12 tools
bonificacionesA

Bonificaciones y compensaciones de los contratos a largo plazo (PDF de Exolum).

Por cumplir (bonificación) o incumplir (compensación) las cantidades garantizadas. Hay un documento por familia de productos; aplica_a dice a qué productos e instalaciones corresponde. producto: filtra por parte del nombre («queroseno», «gasolinas»). Incluye los umbrales en % y las notas del documento.

Inputs: producto. Returns: object

buscar_preciosB

Precios vigentes con filtros. No agrupa: para comparar usa comparar_servicio.

Cada precio dice su fuente: «html» (la página del detalle) o «pdf» (una tarifa en PDF a la que remite el detalle; documentos es el PDF y pagina_pdf la página). Una línea «html» con tipo_precio «pdf» es solo el puntero al documento; resuelto_en dice en qué tablas están sus datos. Un precio de PDF que vale para varios detalles sale una sola vez, con aplica_a (nº de detalles e instalaciones); con detallar_aplicacion=true incluye la lista.

categoria: categoria_servicio exacta (p. ej. «almacenamiento»). texto: parte de la etiqueta o subetiqueta del servicio. tipo_precio puede ser numerico, regla (p. ej. «según contrato»), texto o pdf (remite a un documento; valor nulo).

Inputs: texto, limite, operador, producto, +5 more. Returns: object

capacidadesC

Capacidad de almacenamiento (miles de m3) por compañía, instalación y producto.

Fuente: PDF «Características de las instalaciones de almacenamiento» de la CNMC. producto = «TOTAL» es el total de la instalación. id_tanque es nulo cuando la instalación del PDF no tiene ficha en el portal. ambito: «almacenamiento» o «aeroportuaria». Una cifra nula significa que el PDF lista el producto sin desglose.

Inputs: ambito, limite, compania, producto, +3 more. Returns: object

comparar_servicioB

Compara el precio de una categoría de servicio entre instalaciones y operadores.

Solo son comparables los precios de un mismo grupo: misma categoría, mismos indicadores de lo que incluye el servicio (transporte, almacenamiento, expedición, puesta a bordo) y misma unidad. Si salen varios grupos, la respuesta lo avisa: no mezcles sus cifras. Incluye los precios de las tarifas en PDF (fuente «pdf», con su documento y página; solo tienen año, no fecha). Un precio de PDF común a varios detalles aparece una vez, con aplica_a (detallar_aplicacion=true añade la lista de detalles). Los servicios sin precio numérico se listan aparte con resuelto_en.

Inputs: categoria (required), operador, producto, comunidad, +2 more. Returns: object

consulta_sqlB

Ejecuta una única sentencia SELECT (o WITH … SELECT) sobre la base, en solo lectura.

Tablas principales: instalaciones, detalles, detalle_productos, operadores, operadores_nombres, precios, condiciones, servicios_incluidos, precios_origen_destino, notas_origen_destino, capacidades, documentos, filas_documento, enlaces_documento, precios_pdf, matrices_pdf, bonificaciones, notas_pdf, condiciones_pdf, cobertura_pdf, ejecuciones, incidencias. Vistas útiles: precios_pdf_por_detalle, reconsignaciones, lineas_pdf_sin_resolver. Cada tabla con historial tiene una vista _vigentes con lo visto en la última foto. La función plano(texto) quita tildes y mayúsculas. Usa estado para ver las columnas.

Inputs: sql (required), limite. Returns: object

estadoA

Estado de la base: última foto del portal, volumen de datos, incidencias y tablas.

Inputs: no named parameters. Returns: object

historial_precioB

Todas las versiones de los precios de un detalle, vigentes o no.

Cada fila dice entre qué fotos se vio (primera_vez_visto … ultima_vez_visto) y la fecha de vigencia que publica la CNMC (fecha_precio). vigente indica si sigue en la última foto. etiqueta/subetiqueta: parte del nombre del servicio.

Inputs: id_tanque_instalacion (required), etiqueta, subetiqueta. Returns: object

listar_instalacionesB

Instalaciones vigentes, con filtros opcionales.

operador: código (CLH, DECAL…) o parte del nombre. tipo: «almacenamiento» o «aeroportuaria». comunidad: código (AND, CAN…) o nombre. producto: parte del nombre («queroseno», «gasóleo»…); no distingue mayúsculas ni tildes.

Inputs: tipo, limite, operador, producto, +1 more. Returns: object

listar_operadoresB

Operadores (almacenistas) con su nº de instalaciones y detalles, por tipo.

Una instalación con dos titulares (p. ej. Exolum Corporation y Exolum Aviation en un aeropuerto) cuenta para los dos. nombres_anteriores son los nombres con que el portal ha publicado antes ese mismo código.

Inputs: solo_con_instalaciones. Returns: object

precios_origen_destinoB

Precio de llevar producto desde un origen hasta una instalación de destino.

origen: «Huelva» encuentra HUELVA y REFINERÍA HUELVA, que son orígenes distintos (cada fila dice cuál). destino: nombre de la instalación o del destino. El mismo par origen-destino tiene un precio por modalidad de recepción y por producto. Las rutas «no_ofrecida» no existen (no son gratis); por defecto se omiten.

Inputs: limite, origen, destino, producto, +2 more. Returns: object

reconsignacionesA

Precios de las matrices de los PDF de Exolum entre dos instalaciones.

tipo «reconsignacion» (por defecto): cambiar la instalación de entrega de gasolinas y gasóleos, de la instalación ORIGEN a la de DESTINO. tipo «consignacion_ester»: consignación del éster metílico para mezcla en línea. tipo «origen_destino»: las tablas origen-destino tal como vienen en el PDF (para el día a día usa precios_origen_destino, que parte de la página web). origen/destino: parte del nombre («Huelva», «Rivabellosa»). Cada precio indica el PDF, la página y el año de la tabla. Estado «no_aplica» = «(*)».

Inputs: tipo, limite, origen, destino. Returns: object

ver_instalacionB

Ficha completa de una instalación: detalles, precios, condiciones y capacidad.

De cada detalle se dan los precios de su página (precios), los de las tarifas en PDF a las que remite (precios_pdf, con documento y página) y la lista de esos PDF (documentos_pdf). Las matrices se consultan con reconsignaciones y precios_origen_destino; las bonificaciones, con bonificaciones.

Inputs: id_tanque (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools target distinct entities (operators, facilities, capacity, bonuses, SQL), and descriptions explicitly steer apart the overlapping price tools (buscar_precios says use comparar_servicio to compare; reconsignaciones says use precios_origen_destino for day-to-day). The residual overlap between buscar_precios/comparar_servicio and reconsignaciones/precios_origen_destino is real but well signposted, so an agent can choose correctly.

    Naming Consistency3/5

    Names are readable Spanish but mix conventions: verb_noun forms (listar_operadores, ver_instalacion, buscar_precios, comparar_servicio) coexist with bare nouns (estado, capacidades, bonificaciones, reconsignaciones, historial_precio, consulta_sql). The Spanish convention is followed throughout, so it is understandable, but there is no single predictable pattern.

    Tool Count5/5

    Twelve tools is well within a comfortable range and each maps to a real facet of the CNMC fuel-data domain (status, operators, facilities, prices, comparison, history, origin-destination, capacities, matrices, bonuses, SQL). No tool feels redundant or like filler.

    Completeness4/5

    Read-only reference data, so CRUD is not expected; the surface covers listing, detail, price search/compare/history, origin-destination routing, capacities, matrices, and bonuses. Minor gap: document/PDF linkage (documentos, enlaces_documento) has no dedicated tool and must be reached via ver_instalacion or consulta_sql, which is a workable but less direct path.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Real-time and historical oil, gas, and commodity prices. 40+ energy commodities including Brent Crude, WTI, Natural Gas, LBMA Gold/Silver, EU Carbon, and refined products. Get current prices, compare commodities, view market overviews, and access historical data — all through natural language. Used by energy traders, fintech companies, and researchers worldwide.
      32
      146 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying current and historical retail petrol, diesel, and LPG prices across European countries, comparing prices by week, and checking data coverage.
      85 npm
      MIT