Search buses
mb_search_busesSearch intercity buses by origin, destination, and date to compare companies, terminals, departure times, seat prices, and available seats.
Instructions
Intercity buses on a date: company, terminal, times, price per seat, free seats, bus type, stops, refund penalties.
A city id covers all its terminals. price_toman is per seat. Top-level refund_penalties apply to every bus unless a bus lists its own (until_hours_before: step applies until then, null = up to departure). Next: mb_bus_seats with a bus_id; other days: mb_bus_price_calendar.
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": {
"origin": "<origin>",
"destination": "<destination>",
"date": "<date>"
},
"name": "mb_search_buses"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Departure date YYYY-MM-DD. | |
| sort | No | Order of the buses. | earliest |
| limit | No | Max buses. | |
| origin | Yes | Bus city or terminal id from mb_find_place(mode='bus'), e.g. 11320000 (Tehran). | |
| vip_only | No | Only VIP buses. | |
| companies | No | Only these company ids from `companies` of a result, e.g. [4, 16]. | |
| destination | Yes | Bus city or terminal id from mb_find_place(mode='bus'), e.g. 11320000 (Tehran). | |
| depart_after | No | Local time HH:MM, e.g. '18:00'. | |
| depart_before | No | Local time HH:MM, e.g. '18:00'. | |
| include_sold_out | No | Also list buses with no free seat. |