Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CNMC_BDNoPath to the SQLite database used by the server.
CNMC_MCP_TOKENNoIf defined, the HTTP server requires this value as a Bearer token.
CNMC_MCP_HOSTS_PERMITIDOSNoComma-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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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. nombres_anteriores son los nombres con que el portal ha publicado antes ese mismo código.

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 (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.

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).

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.

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.

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 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» = «(*)».

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.

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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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