cheaper-fuel v0.3.0

A remote MCP server for fuel prices at filling stations in mainland Portugal.

Endpoints

URL	What it is
https://cheaper-fuel.jorgon.workers.dev/	Web dashboard (installable PWA)
https://cheaper-fuel.jorgon.workers.dev/api	Read-only JSON API backing the dashboard
`https://cheaper-fuel.jorgon.workers.dev/mcp`	MCP endpoint — Streamable HTTP, stateless, no authentication

Connect a client

# Claude Code
claude mcp add --transport http cheaper-fuel https://cheaper-fuel.jorgon.workers.dev/mcp

# MCP Inspector
npx @modelcontextprotocol/inspector

For Codex or other clients, add a remote MCP server with the URL above.

Tools

Tool	What it does
`find_stations`	Cheapest stations near a place, postal code, coordinate or within a concelho/district. Widens the radius automatically to cover neighbouring concelhos and reports which ones were searched.
`get_station_details`	One station: every fuel price, opening hours, services, payment methods.
`get_market_overview`	Min / average / median / max and the price spread, nationally or per concelho.
`get_price_history`	Daily national average prices and the observed discount, with the change over the period.
`list_discount_programs`	The discount catalogue stored in D1: supplier, retail partners, mechanics, caps, validity and provenance. Activeness is derived from the validity dates, never stored.
`list_fuel_types`	Fuel catalogue: ids, names and units.
`list_locations`	Resolve concelhos, localities and postal codes.

Data freshness. Prices are cached for up to 24 hours. Every response includes data_fetched_at (when this server last read DGEG) and last_updated (when the operator published each price). Treat prices as published figures, not real-time quotes.

Discounts are advisory. find_stations accepts cards and services and reports an effective_price after the programmes the caller qualifies for. Offers that only run on certain days (for example the first Wednesday of the month) are reported with their schedule and next date rather than applied. Only high-confidence programmes are applied; anything still being verified is returned separately as possible_discounts. Terms belong to the operators — confirm at the pump.

Coverage. DGEG publishes station prices for mainland Portugal only (18 districts, 278 concelhos). The Azores and Madeira are not covered by this data source.

Data source

DGEG — Direção-Geral de Energia e Geologia (precoscombustiveis.dgeg.gov.pt). DGEG publishes this information free of charge for reuse, on condition that DGEG is identified as the source and each price carries its last-update date and time. Both are included in every tool response.

Prices are reported by station operators, not measured by DGEG. This service re-publishes them as-is and does not guarantee accuracy.