Cheapest fuel near a location
cheapest_fuelFind the cheapest fuel for a location and grade: station-level prices in Spain, France, Italy; regional averages in the US. Smart mode weighs pump price against detour cost to reveal the truly cheapest tank.
Instructions
Cheapest fuel for a location and grade. Station-level pricing where governments publish open data (Spain, France, Italy); official regional averages for the US via EIA. With smart=true the ranking weighs the pump price against the fuel and time spent on the detour, so the cheapest sign is not always the cheapest tank.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"country": "<country>"
},
"name": "cheapest_fuel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | No | Latitude in decimal degrees. Required for station-level countries (ES/FR/IT). | |
| lon | No | Longitude in decimal degrees. Required for station-level countries. | |
| grade | No | Fuel grade. | |
| smart | No | Rank by all-in cost (pump price plus the fuel and time of the detour) rather than pump price alone. | |
| region | No | US state code, e.g. CA. Used instead of lat/lon when country=US. | |
| country | Yes | ISO-3166 alpha-2 country code. ES/FR/IT give station-level prices; US gives a regional average. |