EkoPump

Official4 tools

by edjacarmona-cmd

Real-time fuel prices, alerts, and cheapest gas stations across 38+ countries.

io.github.edjacarmona-cmd/ekopump-mcp MCP Server

The io.github.edjacarmona-cmd/ekopump-mcp server provides real-time fuel price data, including alerts and the cheapest gas stations. It operates across 38+ countries, making it suitable for developers building features that surface current fuel costs and notifications based on location.

🛠️ Key Features

Real-time fuel prices
Fuel price alerts
Cheapest gas stations lookup
Coverage across 38+ countries

🚀 Use Cases

Display current fuel prices to users
Notify users about fuel price changes via alerts
Help users find the cheapest nearby gas station

⚡ Developer Benefits

Location- and time-sensitive fuel pricing via real-time data
Streamlined access to cheapest-station information
Alert-focused workflows for fuel price monitoring

Captured live from the server via tools/list.

ekopump_get_fuel_prices

Devuelve el precio medio nacional de gasolina (G95), G98 y diésel por país, junto con el precio del petróleo Brent, agregados a partir de fuentes oficiales por EkoPump (ekopump.es). Datos de solo lectura, sin autenticación. Args: - country (string, opcional): código ISO 3166-1 alpha-2 (ej. "ES"). Si se omite, devuelve todos los países disponibles. Devuelve precios en euros por litro, salvo que la fuente original use otra moneda ya convertida por EkoPump.

Parameters1

country

string

optional

Código de país ISO 3166-1 alpha-2 (ej. 'ES', 'FR', 'DE'). Si se omite, se devuelven todos los países con datos de precio disponibles.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Código de país ISO 3166-1 alpha-2 (ej. 'ES', 'FR', 'DE'). Si se omite, se devuelven todos los países con datos de precio disponibles.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ekopump_get_active_alerts

Devuelve las alertas actualmente activas que EkoPump agrega de múltiples fuentes oficiales: tráfico DGT (España), incendios (EONET/EFFIS), meteorología severa (MeteoAlarm, National Weather Service), sismos y otras. Incluye desglose por fuente y severidad además de una muestra de alertas individuales. Args: - limit (number, opcional, 1-50, por defecto 15): cuántas alertas individuales devolver. El desglose por fuente/severidad siempre refleja el total real, no solo la muestra.

Parameters1

limit

integer

optional

Número máximo de alertas individuales a devolver (1-50, por defecto 15). El resumen por fuente y severidad siempre incluye el total real.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 15,
      "description": "Número máximo de alertas individuales a devolver (1-50, por defecto 15). El resumen por fuente y severidad siempre incluye el total real.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ekopump_get_country_coverage

Devuelve qué tipos de datos en vivo tiene EkoPump para un país (o para todos): combustible, transporte público, vehículos en vivo, bicis públicas, cargadores EV, alertas locales, vuelos y barcos. Útil para responder "¿EkoPump tiene datos de X país?" o "¿qué cubre EkoPump en Portugal?". Args: - country (string, opcional): código ISO 3166-1 alpha-2 (ej. "PT"). Si se omite, devuelve un resumen agregado de todos los países con al menos un dato en vivo.

Parameters1

country

string

optional

Código de país ISO 3166-1 alpha-2. Si se omite, se devuelve un resumen agregado de todos los países.

Raw schema

{
  "type": "object",
  "properties": {
    "country": {
      "description": "Código de país ISO 3166-1 alpha-2. Si se omite, se devuelve un resumen agregado de todos los países.",
      "type": "string",
      "minLength": 2,
      "maxLength": 2
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

ekopump_get_city_stations

Devuelve las gasolineras con mejor precio en una ciudad concreta cubierta por EkoPump, ordenadas de más barata a más cara, con precio de gasolina y diésel por estación. Args: - city (string, requerido): nombre o slug de la ciudad (ej. "Madrid", "paris"). Debe ser una de las ciudades cubiertas por EkoPump — si no se reconoce, el error incluye ejemplos válidos. - limit (number, opcional, 1-25, por defecto 10): cuántas estaciones devolver.

Parameters2

city	string	required	Nombre o slug de una ciudad cubierta por EkoPump (ej. "Madrid", "paris", "san-sebastian"). Ciudades disponibles: Madrid, Barcelona, Valencia, Sevilla, Bilbao, Zaragoza, Málaga, Alicante, Murcia, Palma, Valladolid, Córdoba, Granada, Santander, San Sebastián, y más.
limit	integer	optional	Número máximo de estaciones a devolver, ordenadas de más barata a más cara (1-25, por defecto 10).

Raw schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Nombre o slug de una ciudad cubierta por EkoPump (ej. \"Madrid\", \"paris\", \"san-sebastian\"). Ciudades disponibles: Madrid, Barcelona, Valencia, Sevilla, Bilbao, Zaragoza, Málaga, Alicante, Murcia, Palma, Valladolid, Córdoba, Granada, Santander, San Sebastián, y más."
    },
    "limit": {
      "default": 10,
      "description": "Número máximo de estaciones a devolver, ordenadas de más barata a más cara (1-25, por defecto 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "required": [
    "city"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (4)

ekopump_get_fuel_pricesekopump_get_active_alertsekopump_get_country_coverageekopump_get_city_stations

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://ekopump.es/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ekopump-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ekopump.es/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

EkoPump - agentage MCP Catalog