MCP Server

a2bflight fares

com.a2bflight/fares
Maps & Location Travel & Hospitality Public & reachable MCP 2025-11-25

What this MCP does

Looks up airports and provides cached one-way and round-trip fares for airport routes.

cheapest_routes
Cheapest routes
The cheapest cached fare on every route we hold from an origin (or into a destination), cheapest one-way first, each with its cheapest round trip of a 3 to 21 day stay in `return` when we hold one. Filter by a maximum price and a departure month here rather than by reading the list; both apply to the one-way. Prices are one adult, economy, as last seen on the date in `checked` — observations, not quotes.
Read only
Input schema
{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'destination IATA airport or city code'}, 'from': {'type': 'string', 'description': 'origin IATA airport or city code (NYC covers JFK, LGA and EWR); give from, to or both'}, 'limit': {'type': 'integer', 'description': 'how many routes to return, 1 to 20; 10 when omitted'}, 'month': {'type': 'string', 'description': 'YYYY-MM: the cheapest fare departing in that month; needs from'}, 'max_price': {'type': 'number', 'description': 'keep only fares at or under this amount, in the currency the results carry'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['routes'], 'properties': {'note': {'type': 'string'}, 'routes': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'return': {'type': ['null', 'object'], 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'description': "the route's cheapest round trip of a 3 to 21 day stay; absent when we hold none, and the route's page_url then offers a live return search", 'additionalProperties': False}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}}, 'currency': {'type': 'string'}}, 'additionalProperties': False}
find_airports
Find airports
Look up airports and city codes by name, or list the airports near a code or a lat,lon point. Use it to turn a city name into the IATA code the other tools take.
Read only
Input schema
{'type': 'object', 'properties': {'near': {'type': 'string', 'description': 'an IATA code, or lat,lon, to list the airports near it; give this or query'}, 'query': {'type': 'string', 'description': 'a city or airport name or the start of one; give this or near'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['places'], 'properties': {'places': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['code', 'city', 'country'], 'properties': {'city': {'type': 'string'}, 'code': {'type': 'string'}, 'metro': {'type': 'boolean', 'description': 'true for a city code that covers several airports'}, 'country': {'type': 'string'}, 'airports': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'distance_km': {'type': ['null', 'integer']}}, 'additionalProperties': False}}}, 'additionalProperties': False}
route_fares
Route fares
Everything we hold for one airport pair: the cheapest one-way, the cheapest round trip of a 3 to 21 day stay, the cheapest one-way by departure date and by month, and the cheapest round trips. If we hold nothing yet, it starts pricing the route and says so; ask again a minute later.
Read only Open world
Input schema
{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': 'destination IATA airport code'}, 'from': {'type': 'string', 'description': 'origin IATA airport code (an airport, not a city code)'}, 'month': {'type': 'string', 'description': 'YYYY-MM: keep only departure dates in that month'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['from', 'to', 'status', 'page_url'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'dates': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'the cheapest one-way fares by departure date, cheapest first'}, 'months': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'the cheapest one-way fare in each month'}, 'status': {'type': 'string', 'description': 'held: fares below; pricing: we just started pricing this route, ask again in a minute; none: we hold no fare for it'}, 'returns': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'additionalProperties': False}, 'description': 'the cheapest round trips held, any stay, cheapest first'}, 'cheapest': {'type': ['null', 'object'], 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'description': 'the cheapest one-way', 'additionalProperties': False}, 'currency': {'type': 'string'}, 'page_url': {'type': 'string'}, 'cheapest_return': {'type': ['null', 'object'], 'required': ['from', 'to', 'trip', 'price', 'currency', 'travellers', 'cabin', 'checked', 'page_url'], 'properties': {'to': {'type': 'string'}, 'ref': {'type': 'string'}, 'from': {'type': 'string'}, 'trip': {'type': 'string', 'description': 'one-way or return'}, 'cabin': {'type': 'string'}, 'lands': {'type': 'string', 'description': "local arrival time with the airport's offset"}, 'month': {'type': 'string', 'description': 'YYYY-MM, on a per-month row that has no single date'}, 'price': {'type': 'number'}, 'stops': {'type': ['null', 'integer'], 'description': 'connections; on a return, both directions together'}, 'flight': {'type': 'string'}, 'carrier': {'type': 'string'}, 'checked': {'type': 'string', 'description': 'the day this price was last seen'}, 'departs': {'type': 'string', 'description': "local departure time with the airport's offset"}, 'book_url': {'type': 'string', 'description': "opens the seller's booking page for this fare"}, 'currency': {'type': 'string'}, 'duration': {'type': 'string', 'description': 'flying time; on a return, both directions together'}, 'page_url': {'type': 'string', 'description': "the route's page on a2bflight.com — give the user this link first"}, 'travellers': {'type': 'integer'}, 'depart_date': {'type': 'string'}, 'return_date': {'type': 'string'}, 'carrier_name': {'type': 'string'}}, 'description': 'the cheapest round trip of a 3 to 21 day stay; absent when we hold none, and page_url then offers a live return search', 'additionalProperties': False}}, 'additionalProperties': False}
Added
route_fares
Oct. 4, 2026, 2:40 a.m.
Added
find_airports
Oct. 4, 2026, 2:40 a.m.
Added
cheapest_routes
Oct. 4, 2026, 2:40 a.m.