Skip to main content
Glama
Jambozx

OnlineCyberTools MCP (280+ filterable tools)

math_fuel_consumption_calculator

Read-onlyIdempotent

Convert fuel economy between US mpg, UK mpg, L/100km, and km/L. Estimate trip fuel cost from distance, consumption, and price.

Instructions

Fuel Consumption Calculator. Convert a fuel-economy figure between US mpg, UK (Imperial) mpg, L/100km, and km/L, or estimate the fuel and money a trip will cost given distance, vehicle consumption, and a per-litre or per-gallon fuel price. Returns the converted value (convertConsumption) or litres needed plus total cost in the price's native currency (tripCost). Use this for fuel-economy and trip-cost math; use math_unit_converter instead for general length / volume / speed unit conversion, and math_running_pace_converter for pace and speed. Pure local arithmetic: read-only, non-destructive, deterministic, contacts no external service, and is rate-limited.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
operationYes"convertConsumption" converts one economy value between units (needs value, fromUnit, toUnit). "tripCost" estimates trip fuel and cost (needs distance, distanceUnit, consumption, consumptionUnit, pricePerUnit, priceUnit).convertConsumption
valueNoconvertConsumption only: the fuel-economy value to convert, expressed in fromUnit. Must be greater than zero for mpg_us, mpg_uk, and km_per_l.
fromUnitNoconvertConsumption only: unit of the input value. mpg_us=miles per US gallon, mpg_uk=miles per Imperial gallon, l_per_100km=litres per 100km, km_per_l=kilometres per litre.
toUnitNoconvertConsumption only: unit to convert the value into. Same four enum values as fromUnit.
distanceNotripCost only: trip distance, expressed in distanceUnit.
distanceUnitNotripCost only: unit of distance. km=kilometres, mi=miles.
consumptionNotripCost only: the vehicle fuel economy, expressed in consumptionUnit. Must be greater than zero.
consumptionUnitNotripCost only: unit of the consumption figure. Same four enum values as fromUnit.
pricePerUnitNotripCost only: fuel price per volume unit, expressed in priceUnit currency and volume.
priceUnitNotripCost only: currency + volume the price refers to. Determines the output currency (USD/EUR/GBP) and the volume (US gallon, UK gallon, or litre) pricePerUnit is multiplied by.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
operationNoEchoes the operation that was run (defaults to convertConsumption when omitted).
dataNoconvertConsumption returns fromUnit/toUnit/fromValue/toValue/formattedFrom/formattedTo. tripCost returns distance/consumption/fuelNeeded/totalCost/pricePerUnit/currency and formatted strings.
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds behavioral context beyond the annotations, stating it is 'read-only, non-destructive, deterministic, contacts no external service, and is rate-limited.' These details align with and supplement the annotation hints, providing full transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise with three sentences: first explaining core conversions, second specifying return values, third giving usage guidance and behavioral notes. It is front-loaded with the core purpose and every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the 10 parameters, 100% schema coverage, and presence of an output schema, the description provides sufficient context by explaining the two operations and their outputs. It is complete enough for an agent to understand the tool's capabilities.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% coverage, but the description adds value by summarizing the return values for each operation: 'Returns the converted value (convertConsumption) or litres needed plus total cost in the price's native currency (tripCost).' This helps the agent understand what to expect without reading the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool as a fuel consumption calculator with two specific operations: convertConsumption and tripCost. It distinguishes itself from sibling tools like math_unit_converter and math_running_pace_converter, making its purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly provides context for when to use this tool versus alternatives, stating 'Use this for fuel-economy and trip-cost math; use math_unit_converter instead for general length / volume / speed unit conversion, and math_running_pace_converter for pace and speed.' This gives clear guidance on tool selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Jambozx/onlinecybertools-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server