Skip to main content
Glama
gregoriofraile

gasolineras-mcp

by gregoriofraile
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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

Tools

Functions exposed to the LLM to take actions

NameDescription
buscar_municipioA

Busca municipios españoles por nombre para obtener su ID.

El ID de municipio hace falta para llamar a precios_carburantes. La búsqueda es por tokens (no requiere escribir el nombre exacto ni en el orden exacto): "El Bonillo" encuentra "Bonillo (El)", "Kanpezu" encuentra el municipio bilingüe "Campezo/Kanpezu". Devuelve siempre la provincia porque hay nombres de municipio repetidos entre provincias (p. ej. tres municipios llamados "Boadilla").

Args: nombre: nombre o parte del nombre del municipio a buscar.

Returns: Lista de coincidencias, cada una con id, municipio y provincia. Lista vacía si no hay ninguna coincidencia.

precios_carburantesA

Precios de un carburante en las gasolineras de un municipio.

Usa el ID de municipio que devuelve buscar_municipio. El resultado viene ordenado de más barata a más cara. Las gasolineras que no venden el producto pedido no aparecen en el resultado (se indica cuántas se excluyeron). Los precios se actualizan en la API del MINETUR cada ~30 minutos; la respuesta incluye la fecha de esos precios.

Args: municipio_id: ID de municipio MINETUR (lo da buscar_municipio). producto: nombre del carburante en lenguaje natural. Admite alias como "diesel", "glp", "gasolina 95", "gasolina 98", o el nombre exacto de la API (p. ej. "Gasoleo A"). Por defecto gasolina 95 E5. limite: número máximo de gasolineras a devolver, ordenadas por precio ascendente. Por defecto 20 (algunos municipios grandes, como Madrid capital, tienen más de 240 gasolineras).

Returns: Un diccionario con estado: "ok", "sin_gasolineras", "municipio_invalido", "error_conexion" (no se pudo contactar con la API), "error_respuesta" (la API respondió algo que no es JSON), "limite_invalido" (limite no es un entero >= 1), o "producto_no_reconocido" si producto no se pudo resolver. En estado "ok" incluye fecha, producto, total_excluidas, y gasolineras (lista con rotulo, direccion, localidad, horario, precios de todos los productos que vende esa estación como diccionario producto→precio, y coordenadas). En los demás estados incluye mensaje explicando qué pasó y qué hacer.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.7/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have completely distinct purposes: one searches for municipalities by name to obtain an ID, and the other retrieves fuel prices using that ID. There is no overlap or ambiguity.

Naming Consistency5/5

Both tool names follow a consistent verb_noun pattern in Spanish (buscar_municipio, precios_carburantes), which is predictable and clear.

Tool Count4/5

With only 2 tools, the server is slightly under the typical range for a focused domain, but it effectively covers the essential workflow of searching municipalities and retrieving prices. It earns its place without being too thin.

Completeness4/5

The tools cover the core functionality: municipality lookup and price retrieval. Minor gaps exist, such as lack of geolocation-based search or historical price data, but the set is sufficient for the intended use case.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources