Agent access

FuelRank for AI agents and MCP

FuelRank gives agents a simple way to answer “where is the cheapest petrol or diesel near me?” using UK fuel price rankings that include pump price, distance, vehicle MPG, litres to buy, and round-trip travel cost.

Connect over MCP View llms.txt View OpenAPI schema Try browser-agent search

Find cheap fuel

Rank nearby petrol, diesel, or E10 by effective price per litre.

Calculate true cost

Include the round-trip fuel used to drive to the station and back.

Send users to the site

Open a prefilled FuelRank URL when the user wants the map or directions.

Best URLs for agents

Short instructions

https://www.fuelrank.co.uk/llms.txt

Full instructions

https://www.fuelrank.co.uk/llms-full.txt

OpenAPI schema

https://www.fuelrank.co.uk/openapi.json

Browser-agent search form

https://www.fuelrank.co.uk/fuel-search

Browser-agent form example

Browser-capable agents can open the accessible GET form, fill location/fuel/litres/MPG/radius fields, submit it, and read server-rendered HTML results without constructing an API request.

https://www.fuelrank.co.uk/fuel-search?location=Cardiff%20city%20centre&fuel=diesel&litres=45&mpg=50&radius=5

Agent-readable result example

Browsing-based agents can open the plain-text result endpoint when they already have a user-approved location. It returns the evaluated candidate count, top ranked stations, and a pump-price-vs-true-cost comparison.

https://www.fuelrank.co.uk/agent/fuel-prices?location=Cardiff%20city%20centre&fuel=diesel&litres=45&mpg=50&radius=5

For privacy, agents should ask before using precise location and should not send unnecessary personal data.

Public JSON API example

Agents and apps that can process JSON should call the canonical public fuel price endpoint directly. The response includes cheapest_pump, cheapest_true_cost, same_station, results_by_true_cost, and results_by_pump_price.

https://www.fuelrank.co.uk/api/v1/fuel-prices?location=Cardiff%20city%20centre&fuel=diesel&litres=45&mpg=50&radius=5

Open the website with a prefilled search

If a user wants to inspect the map, compare all nearby stations, or open directions, send them to a prefilled FuelRank URL.

https://www.fuelrank.co.uk/?lat=51.4816&lng=-3.1791&fuel=diesel&litres=45&mpg=50&radius=5

Remote MCP server

MCP-compatible clients can connect to FuelRank directly. The server speaks JSON-RPC 2.0 over the stateless Streamable HTTP transport: POST a message, get a single JSON response. There is no SSE stream, no session id, and no authentication or payment required.

FuelRank speaks the 2026-07-28 stateless revision natively — per-request _meta, server/discover, and the Mcp-Method/Mcp-Name routing headers — and still supports 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05, and 2024-10-07 clients using the older handshake.

https://www.fuelrank.co.uk/api/mcp

Available tools

find_cheapest_fuel

Rank UK petrol, diesel, or E10 stations around a location by true cost.

Arguments: fuel_type (required), location or lat+lng, radius_miles, limit, vehicle_mpg, litres_to_buy

lookup_vehicle_mpg

Look up estimated UK MPG for a vehicle by make and model.

Arguments: query (required), fuel_type, limit

Client configuration

For MCP clients that connect to remote servers over stdio, bridge with mcp-remote. Clients with native remote-server support can use the URL directly.

{
  "mcpServers": {
    "fuelrank": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.fuelrank.co.uk/api/mcp"]
    }
  }
}

Example request

curl -X POST https://www.fuelrank.co.uk/api/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "find_cheapest_fuel",
      "arguments": {
        "location": "Cardiff city centre",
        "fuel_type": "diesel",
        "litres_to_buy": 45,
        "vehicle_mpg": 50,
        "radius_miles": 5
      }
    }
  }'

Errors, limits, and data freshness

Tool failures return a normal result with isError: true and a structured { code, message, retryable } error in _meta["uk.co.fuelrank/error"], repeated in the text block as CODE: message. Codes include INVALID_LOCATION, UNSUPPORTED_FUEL_TYPE, INVALID_PARAMETER, NO_STATIONS_FOUND, VEHICLE_NOT_FOUND, UPSTREAM_DATA_UNAVAILABLE, RATE_LIMITED, and INTERNAL_ERROR.
Requests are rate limited per client. Exceeding the limit returns HTTP 429 with a Retry-After header.
Rankings come from the same service that powers this website, so agent and human answers agree. Prices change frequently, so tell users to confirm at the pump.
Ask before using precise coordinates. A town, postcode, or address works just as well and shares less. FuelRank does not log raw location strings or registration plates.

Route-aware refuelling and stop/wait decisions are planned but not yet available. Only the two tools listed above are live.