{"success":true,"version":"v1","request":{"tool":"get_calculator_schema","calculator_id":"fuel-cost"},"result":{"entity_type":"calculator","id":"fuel-cost","calculator_id":"fuel-cost","canonical_url":"https://tttkmbb.com/everyday/fuel-cost","name":"Fuel Cost Calculator","title":"Fuel Cost Calculator – Trip Fuel Use and Cost from Distance, L/100 km and Price","category":"everyday","category_name":"Everyday Life","tool_name":"calculate_fuel_cost","featured_mcp_tool":false,"description":"Estimates the fuel needed for a trip and its cost from distance, fuel consumption in litres per 100 km and the price per litre, with the cost per person when it is shared.","use_when":"You want to budget a road trip or commute, or split fuel money between passengers, and know the car's consumption in L/100 km.","do_not_use_when":"Your consumption is in mpg or km/L (convert it first with fuel-economy), or you need total ownership costs such as tolls, wear or depreciation.","inputs":[{"name":"distance_km","label":"Distance","type":"number","unit":"km","required":true,"max":100000,"exclusive_min":0,"description":"Trip distance in kilometres (enter the round-trip distance for a return journey).","example":350},{"name":"fuel_consumption_l_per_100km","label":"Fuel consumption","type":"number","unit":"L/100 km","required":true,"max":100,"exclusive_min":0,"description":"Average consumption in litres per 100 km.","example":7.5},{"name":"fuel_price_per_liter","label":"Fuel price","type":"number","unit":"per L","required":true,"min":0,"max":100,"description":"Price per litre in your currency.","example":1.85},{"name":"passengers","label":"People sharing the cost","type":"integer","required":false,"default":1,"min":1,"max":100,"description":"Number of people sharing the fuel cost, driver included.","example":2}],"outputs":[{"name":"fuel_liters","label":"Fuel needed","type":"number","unit":"L","decimals":2,"description":"distance × consumption / 100."},{"name":"total_cost","label":"Total fuel cost","type":"number","decimals":2,"description":"fuel_liters × price per litre."},{"name":"cost_per_person","label":"Cost per person","type":"number","decimals":2,"description":"total_cost / passengers."},{"name":"cost_per_km","label":"Cost per km","type":"number","unit":"per km","decimals":3,"description":"total_cost / distance_km."},{"name":"equivalent_mpg_us","label":"Consumption in US mpg","type":"number","unit":"mpg (US)","decimals":1,"description":"235.215 / (L/100 km), for reference."}],"input_schema":{"type":"object","properties":{"distance_km":{"description":"Trip distance in kilometres (enter the round-trip distance for a return journey). Unit: km.","type":"number","maximum":100000,"exclusiveMinimum":0,"examples":[350],"x-unit":"km"},"fuel_consumption_l_per_100km":{"description":"Average consumption in litres per 100 km. Unit: L/100 km.","type":"number","maximum":100,"exclusiveMinimum":0,"examples":[7.5],"x-unit":"L/100 km"},"fuel_price_per_liter":{"description":"Price per litre in your currency. Unit: per L.","type":"number","minimum":0,"maximum":100,"examples":[1.85],"x-unit":"per L"},"passengers":{"description":"Number of people sharing the fuel cost, driver included.","type":"integer","minimum":1,"maximum":100,"default":1,"examples":[2]}},"additionalProperties":false,"required":["distance_km","fuel_consumption_l_per_100km","fuel_price_per_liter"]},"output_schema":{"type":"object","properties":{"fuel_liters":{"description":"distance × consumption / 100. Unit: L.","type":"number","x-unit":"L"},"total_cost":{"description":"fuel_liters × price per litre.","type":"number"},"cost_per_person":{"description":"total_cost / passengers.","type":"number"},"cost_per_km":{"description":"total_cost / distance_km. Unit: per km.","type":"number","x-unit":"per km"},"equivalent_mpg_us":{"description":"235.215 / (L/100 km), for reference. Unit: mpg (US).","type":"number","x-unit":"mpg (US)"}}},"formula":"fuel_liters = distance_km × fuel_consumption_l_per_100km / 100; total_cost = fuel_liters × fuel_price_per_liter; cost_per_person = total_cost / passengers; cost_per_km = total_cost / distance_km; mpg_us = 235.215 / L_per_100km","sources":[{"name":"US DOE / EPA – fueleconomy.gov Trip Calculator","url":"https://www.fueleconomy.gov/trip/","type":"government","retrieved_at":"2026-09-23"},{"name":"Fuel economy in automobiles – unit conversions (Wikipedia)","url":"https://en.wikipedia.org/wiki/Fuel_economy_in_automobiles","type":"reference","retrieved_at":"2026-09-23"}],"freshness":{"type":"static","max_age_seconds":null,"note":"Deterministic formula with fixed constants; results never go stale. Inputs supplied by the caller determine the output."},"examples":[{"name":"350 km at 7.5 L/100 km, 1.85 per litre, 2 people","inputs":{"distance_km":350,"fuel_consumption_l_per_100km":7.5,"fuel_price_per_liter":1.85,"passengers":2},"expected":{"fuel_liters":26.25,"total_cost":48.56,"cost_per_person":24.28,"cost_per_km":0.139,"equivalent_mpg_us":31.4},"url":"https://tttkmbb.com/api/v1/calculate/fuel-cost?distance_km=350&fuel_consumption_l_per_100km=7.5&fuel_price_per_liter=1.85&passengers=2"},{"name":"1200 km at 6.2 L/100 km, 1.60 per litre","inputs":{"distance_km":1200,"fuel_consumption_l_per_100km":6.2,"fuel_price_per_liter":1.6},"expected":{"fuel_liters":74.4,"total_cost":119.04,"cost_per_person":119.04,"cost_per_km":0.0992,"equivalent_mpg_us":37.9},"url":"https://tttkmbb.com/api/v1/calculate/fuel-cost?distance_km=1200&fuel_consumption_l_per_100km=6.2&fuel_price_per_liter=1.6"}],"faq":[{"q":"I know my car's mpg, not L/100 km. What do I enter?","a":"L/100 km = 235.215 / mpg (US gallons) or 282.481 / mpg (UK imperial gallons). 30 US mpg is about 7.84 L/100 km."},{"q":"Does real consumption match the manufacturer figure?","a":"Usually not; highway driving, load, speed and air conditioning change consumption by 10–30%. Use a measured average from recent fill-ups if you have one."}],"tags":["fuel cost","trip cost","gas cost","petrol cost","road trip budget"],"related":[{"calculator_id":"fuel-economy","reason":"Convert mpg or km/L to L/100 km first."},{"calculator_id":"bill-split","reason":"Split any shared cost, with an optional tip."}],"links":{"html":"https://tttkmbb.com/everyday/fuel-cost","markdown":"https://tttkmbb.com/everyday/fuel-cost.md","json":"https://tttkmbb.com/everyday/fuel-cost.json","api":"https://tttkmbb.com/api/v1/calculate/fuel-cost","schema":"https://tttkmbb.com/api/v1/calculators/fuel-cost","openapi":"https://tttkmbb.com/openapi.json","mcp":"https://tttkmbb.com/mcp"},"version":"v1","updated_at":"2026-09-23"},"timestamp":"2026-09-23T23:31:10Z"}