Is this trip worth it?
grade_ride_offerGrade one trip offer for ride-hail drivers (Uber, inDrive, DiDi, Cabify, Yango) in Colombia, Peru and Bolivia, the way the Drivaron app does: pay per km and per hour with the pickup included, an A+/A/B/C grade against the driver's hourly target, and the minimum fare to ask for (inDrive counteroffer floor). Use it when a driver asks whether an offer is worth taking or what to charge.
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": {
"fare": "<fare>",
"trip_km": "<trip_km>"
},
"name": "grade_ride_offer"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Tip or bonus included with the offer. | |
| city | No | City, which sets currency, starting hourly target and average speed. One of: Bogotá, Medellín, Cali, Barranquilla, Lima, Arequipa, Trujillo, Santa Cruz de la Sierra, La Paz, Cochabamba. | |
| fare | Yes | Fare shown in the offer, in local currency (e.g. 14000 COP, 14 PEN, 28 BOB). | |
| lang | No | Language of the summary: es (default) or en. | |
| country | No | Country when the city is unknown: Colombia (CO, COP), Peru (PE, PEN) or Bolivia (BO, BOB). | |
| trip_km | Yes | Trip distance in km (pickup point to destination). | |
| currency | No | Currency, when neither city nor country is known. | |
| trip_min | No | Trip duration in minutes, if the offer shows it. Otherwise estimated from speed. | |
| pickup_km | No | Distance to the passenger in km. Unpaid, so it lowers real pay per km. | |
| speed_kmh | No | Average city speed in km/h. Defaults to the city's value. | |
| pickup_min | No | Minutes to reach the passenger, if shown. Otherwise estimated from speed. | |
| commission_pct | No | Platform commission in % taken from the fare, if the fare shown is before commission (e.g. 10 for inDrive). Default 0. | |
| target_per_hour | No | Driver's hourly earnings goal in local currency. Defaults to the city's starting target. | |
| fuel_cost_per_km | No | Fuel cost per km, to show profit after fuel. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | Yes | The Drivaron app and its Play download link. | |
| tool | Yes | ||
| color | No | green, yellow or red for offers. | |
| notes | No | Assumptions made for missing inputs. | |
| result | Yes | All numbers, raw and formatted in local currency. | |
| summary | Yes | One-paragraph answer in the requested language, ready to show the driver. | |
| result_page | No | Shareable page with this result. |