cnmc-logistica
Read-only access to the CNMC hydrocarbon logistics dataset through 12 MCP tools.
Check database status, latest snapshot, data volumes, incidents and table schema.
List operators and installations, filtered by operator, type, region or product, and view full installation records with prices, conditions and capacity.
Search current prices from HTML pages or PDFs by operator, product, category, region, installation type or text.
Compare comparable service prices across installations and operators, with warnings when groups are not comparable.
Trace price history for a product/detail, including previous versions and whether still current.
Query origin-destination transport prices, storage capacities, reconsignment/consignment matrices and long-term contract bonuses.
Run one protected read-only SELECT/WITH query for custom analysis using tables, current-data views and helper functions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@cnmc-logistica Compara los precios de almacenamiento de Repsol y Cepsa en 2025"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
logistica-hidrocarburos-cnmc
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 |
| 26 ficheros CSV con las filas vigentes: 4 tablas planas ( |
| Las mismas 26 tablas en Parquet, con tipos de columna |
| 20 ficheros Parquet, uno por tabla con historial, con todas las versiones de cada fila y una columna |
| Base SQLite completa: historial, vistas |
| Huella sha256 de la base |
| 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 retirados2. 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 infoCliente 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:
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.txten cada ejecución.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.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.
Gold: publica las vistas vigentes y cuatro tablas planas en CSV y Parquet, en una Release mensual.
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

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.
reconstruirregenera la capa silver completa a partir deraw/, 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? |
| Recorre los mapas y el buscador y escribe | Sí |
| Descarga el inventario a | Sí |
| Crea una base nueva a partir de todas las fotos de | No |
| Genera los ficheros de la Release | No |
| Descarga a | Solo GitHub |
| Arranca el MCP ( | No |
| 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 8000Variables de entorno del servidor:
Variable | Efecto |
| Ruta de la base que se sirve. Por defecto, |
| Si se define, |
| Cabeceras |
Docker
docker build -t cnmc-logistica .
docker run --rm -p 8000:8000 cnmc-logistica # MCP en /mcp y API REST en /api/v1Herramientas 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 |
| Última foto, volumen de datos, incidencias y esquema de tablas |
| Operadores con su nº de instalaciones por tipo y nombres anteriores |
| Filtros por operador, tipo, comunidad y producto |
| Ficha completa: detalles, precios, condiciones y capacidad |
| Precios vigentes (de la página y de los PDF, con su |
| Compara una categoría entre instalaciones y operadores, solo entre comparables |
| Todas las versiones de los precios de un detalle |
| Coste de llevar producto de un origen a una instalación |
| Capacidad (miles de m³) por compañía, instalación y producto |
| Matrices de los PDF: reconsignación entre instalaciones, consignación de éster y origen-destino |
| Bonificaciones y compensaciones de los contratos a largo plazo |
| Una sentencia |
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 |
| Código estable del buscador e historial de sus nombres |
| Tipo (almacenamiento / aeroportuaria) y comunidad |
| Titular, conexión a oleoducto y productos normalizados |
| Un valor por fila, con |
| Mermas y demás condiciones (valor numérico si lo hay, y texto) |
| Lista «Incluye:» de cada servicio principal |
| Rutas ( |
| PDF global de capacidades, enlazado a |
| Metadatos y tablas genéricas de cada PDF |
| Qué línea de precios de qué detalle remite a qué PDF |
| Tarifas de los PDF (concepto → precio), con categoría, unidad y año |
| Matrices origen × destino de los PDF (vista |
| Bonificaciones y compensaciones: tramo, condición, valor y unidad |
| Cantidades con unidad dentro de las notas (plazos en días, mínimos en toneladas…) |
| Texto íntegro de las notas solo explicativas de cada PDF |
| Por PDF: cifras totales, guardadas, descartadas y sin cubrir |
| 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 %»…),textoopdf(remite a un documento). Si no es numérico,valores nulo y se guarda el texto original.tipo_valor:unico,maxomin, 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 comosin_categoriay genera un aviso.Indicadores
incluye_transporte,incluye_almacenamiento,incluye_expedicioneincluye_puesta_a_bordo, derivados de la lista «Incluye:» mediante config/indicadores_incluye.yaml.comparar_serviciosolo 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_resolverlista las líneas contipo_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_cubriry la ejecución termina como fallida. El resultado se guarda en la tablacobertura_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 llevanmetodo = '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_preciosycomparar_serviciola devuelven una vez, conaplica_a(nº de detalles e instalaciones, y la lista condetallar_aplicacion=true). En la tabla planaprecios_completosaparece 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 |
| En origen-destino un cero no es un precio; se guarda |
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 condocker 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
descubriryactualizar, publica el crudo en una Releaseraw-AAAA-MM-DD(bronze), publica la Releasedatos-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 --reemplazardescargar-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 Releasedatos-2026-11-11se generó conexportary 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 pytestLos hooks del repositorio se activan una vez por copia:
git config core.hooksPath .githooksEl 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 toolsbonificacionesA
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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Cheapest fuel in Spain: live prices at ~12,000 petrol stations, near a place or along a route.
Live official fuel station prices for France, Spain, Italy and Western Australia in one schema.
Search open Spanish public-sector tenders, updated daily, and estimate an offer. Read-only.
Your Nenpi car log: ask about costs, fuel use and reminders, add fill-ups. Free account at nenpi.app
Related MCP Servers
AlicenseAqualityBmaintenanceReal-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.32146 npm4MIT- AlicenseAqualityBmaintenanceProvides real-time fuel prices at gas stations in Spain using the government's public API. Enables users to find the cheapest fuel in a municipality or list stations sorted by price.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables querying current and historical retail petrol, diesel, and LPG prices across European countries, comparing prices by week, and checking data coverage.85 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables read-only, natural-language queries of official Brazilian ANP installation records through any MCP-compatible client, with usage billed via prepaid credits.MIT