# UK Fuel Price Finder

> Cheapest diesel and petrol near any UK postcode — live retailer prices, fleet depot reports and savings per fill.

Remote MCP server (Streamable HTTP): https://uk-fuel-prices-mcp.donniertf.workers.dev/mcp
Free tier: `cheapest_fuel` — no key, no sign-up, 20 calls/day per IP.
Pro: £9/month, cancel anytime — all tools, unlimited.

## Tools
- cheapest_fuel (free): FREE. Cheapest 3 UK fuel stations within 5 miles of a postcode for a fuel type (pence per litre).
- fuel_search (Pro): PRO. All stations within a radius (up to 30 miles) of a postcode, cheapest first, with all fuel prices and saving vs local average.
- depot_report (Pro): PRO. Fleet report: for up to 20 depot/site postcodes, the cheapest nearby station and estimated saving per fill vs local average.
- area_benchmark (Pro): PRO. Min/average/max price per fuel type within a radius of a postcode, plus cheapest brand — for pricing, expenses and mileage rates.

## Buying (agents)
1. POST https://uk-fuel-prices-mcp.donniertf.workers.dev/checkout -> {checkout_url, session_id}. A human (or a payment-capable agent) completes Stripe Checkout at checkout_url.
2. GET https://uk-fuel-prices-mcp.donniertf.workers.dev/token?session_id=... -> {access_token}.
3. Send Authorization: Bearer <access_token> to https://uk-fuel-prices-mcp.donniertf.workers.dev/mcp (or pass access_token in tool arguments).

## Pay per call (x402, USDC on Base)
No account: POST JSON args to https://uk-fuel-prices-mcp.donniertf.workers.dev/x402/<tool> -> HTTP 402 with payment requirements ($0.02 USDC per call, payTo 0x02226D28e0c85AE4AdDB7fe7043Dd2b1Ff710D41). Retry with an X-PAYMENT header (x402 v1, scheme exact, network base). Manifest: https://uk-fuel-prices-mcp.donniertf.workers.dev/.well-known/x402. MCP clients may also send X-PAYMENT on tools/call.
Machine-readable pricing: https://uk-fuel-prices-mcp.donniertf.workers.dev/pricing.json · Server card: https://uk-fuel-prices-mcp.donniertf.workers.dev/.well-known/mcp

## Sources
- Retailer open fuel price feeds under the CMA road fuel pricing scheme (Asda, MFG, Rontec, Moto, Morrisons, Applegreen)
- postcodes.io (ONS Postcode Directory, OGL)

## Notes
Prices come from retailers' public feeds (pence per litre) and can be hours old; not every brand publishes a working feed yet (e.g. Tesco, Sainsbury's, BP-owned sites may be missing). Check the pump price.
Contact: dmorrisonwebdesign@gmail.com. More UK data MCPs: https://github.com/donniertf-hub/uk-mcp-fleet