cnmc-logistica
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CNMC_BD | No | Path to the SQLite database used by the server. | |
| CNMC_MCP_TOKEN | No | If defined, the HTTP server requires this value as a Bearer token. | |
| CNMC_MCP_HOSTS_PERMITIDOS | No | Comma-separated list of allowed Host headers for the HTTP server. By default, only local hosts are allowed. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Histórico de la logística de productos petrolíferos que publica la CNMC (instalaciones de almacenamiento y aeroportuarias, precios, condiciones, rutas origen-destino y capacidades). Solo lectura. Proyecto no oficial, no afiliado a la CNMC ni a ningún operador. Datos públicos publicados por la CNMC; consulte la fuente original antes de tomar decisiones.
Cómo leer los datos:
Hay dos niveles: instalación (id_tanque) y detalle = un producto en una instalación (id_tanque_instalacion). Los precios cuelgan del detalle.
No compares precios de servicios distintos: usa
comparar_servicio, que agrupa por categoria_servicio, indicadores de lo que incluye el servicio y unidad.En rutas origen-destino, estado «no_ofrecida» significa que la ruta no existe, no que sea gratis.
Cada fila tiene primera_vez_visto / ultima_vez_visto; las herramientas devuelven lo vigente salvo
historial_precio.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| estadoA | Estado de la base: última foto del portal, volumen de datos, incidencias y tablas. |
| 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. |
| 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. |
| ver_instalacionB | Ficha completa de una instalación: detalles, precios, condiciones y capacidad. De cada detalle se dan los precios de su página ( |
| buscar_preciosB | Precios vigentes con filtros. No agrupa: para comparar usa Cada precio dice su 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). |
| 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 |
| 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). |
| 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. |
| 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. |
| 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 |
| 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; |
| 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 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.