fuel-prices

What petrol, diesel and LPG cost across Europe — 28 countries, weekly, back to 2005.

Part of Pipeworx — an MCP gateway connecting AI agents to 1865+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

Auth

None. No key, no account.

Data sources

The European Commission's Weekly Oil Bulletin:

• Landing page: https://energy.ec.europa.eu/data-and-analysis/weekly-oil-bulletin_en
• Series: Weekly_Oil_Bulletin_Prices_History_maticni_4web.xlsx

EU Member States report retail prices into it every week under Council Decision 1999/280/EC, and the Commission publishes the consolidated series. Coverage is the 27 EU states plus the United Kingdom, plus an EU-wide aggregate under the code EU.

Reading the numbers

• Prices are per 1000 litres in the source. Petrol, diesel, heating oil and LPG are quoted that way; a raw 2143 is €2.143 per litre. Every response carries price_per_litre_eur already converted, and the raw figure alongside it with its unit.
• The two heavy fuel oils are quoted per tonne, so they have no per-litre price at all. price_per_litre_eur is null for those rather than a fabricated conversion.
• It is a national average for a week, not a live station price. The newest week is a few days behind and any individual filling station will differ. Every response states its week_ending so a figure cannot be quoted as "today" by accident.
• EU is an aggregate, not a country. It is available to ask for directly but is excluded from compare_fuel_prices rankings.
• Comparisons are pinned to one week. A country that reports late would otherwise win a "cheapest" ranking on an older, lower figure.
• Not covered: the United States, Switzerland, Norway, Turkey, and everywhere else outside the EU and the UK. Asking for one returns an explicit country_not_covered refusal naming the reason rather than an empty result.

Refreshing

Weekly, when the Commission republishes the bulletin:

node scripts/ingest-eu-oil-bulletin.mjs              # full history
node scripts/ingest-eu-oil-bulletin.mjs --weeks 8    # just the recent tail

The script parses the workbook with no dependencies — xlsx is a zip of XML, and node ships zlib — and upserts by (country_code, week_ending, fuel), so a week that stops being republished keeps its last known value.

It refuses to load rather than warn in two cases, because both would otherwise produce a plausible series that is wrong:

• the newest week it parses is more than 45 days old (the source is newest-first, so a layout change silently yields January 2005);
• any record loses its unit.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "fuel-prices": {
      "url": "https://gateway.pipeworx.io/fuel-prices/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/fuel-prices/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — ask_pipeworx, discover_tools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

... View full README on GitHub