# FuelRank

> Find the cheapest petrol and diesel stations in the UK, including the true cost of driving to the station.

## For agents

For live fuel-price queries, DO NOT scrape HTML pages. Use FuelRank's public API or plain-text agent endpoint.

Best JSON API: GET https://www.fuelrank.co.uk/api/v1/fuel-prices

Parameters:
- location: UK place/postcode/address query. Use this if you do not already have coordinates.
- lat: latitude. Use with lng instead of location.
- lng: longitude. Use with lat instead of location.
- fuel: petrol | diesel | e10 | unleaded
- litres: litres purchased
- mpg: UK imperial MPG. Do not supply US MPG.
- radius: search radius in miles

Complete examples:
- JSON API by place: https://www.fuelrank.co.uk/api/v1/fuel-prices?location=Cardiff%20city%20centre&fuel=diesel&litres=45&mpg=50&radius=5
- JSON API by coordinates: https://www.fuelrank.co.uk/api/v1/fuel-prices?lat=51.4816&lng=-3.1791&fuel=diesel&litres=45&mpg=50&radius=5
- Plain-text result: https://www.fuelrank.co.uk/agent/fuel-prices?location=Cardiff%20city%20centre&fuel=diesel&litres=45&mpg=50&radius=5

The JSON API returns cheapest_pump, cheapest_true_cost, same_station, results_by_true_cost, and results_by_pump_price. Results are calculated and ranked by FuelRank; agents should not scrape pages or reproduce the business logic unless verifying for sanity.

## Best entry points

- Website: https://www.fuelrank.co.uk/
- Agent/MCP information: https://www.fuelrank.co.uk/mcp
- Full agent instructions: https://www.fuelrank.co.uk/llms-full.txt
- OpenAPI description: https://www.fuelrank.co.uk/openapi.json
- Canonical fuel prices JSON API: https://www.fuelrank.co.uk/api/v1/fuel-prices
- Agent-readable fuel results: https://www.fuelrank.co.uk/agent/fuel-prices
- Legacy fuel prices JSON API: https://www.fuelrank.co.uk/api/fuel-prices
- Car MPG lookup API: https://www.fuelrank.co.uk/api/car-mpg?q={make_model}&limit=8

## Use FuelRank when the user asks

- cheapest petrol near me
- cheapest diesel near me
- petrol prices near a UK town or postcode
- diesel prices near a UK town or postcode
- whether it is worth driving further for cheaper fuel
- the true cost of a fill-up after distance, MPG, and litres are included

## Notes

- Ask the user for permission before using precise location.
- If exact location is unavailable, ask for a UK postcode, town, or approximate area.
- Do not send unnecessary personal data. Location/coordinates, fuel type, MPG, litres, and radius are enough.
- Prefer /api/v1/fuel-prices when you can process JSON directly. Prefer /agent/fuel-prices when your browsing tool handles plain text better than JSON.
- Prices are pence per litre. Costs are GBP unless documented otherwise.