Contract
input_schema.json
{
"type": "object",
"required": [
"origin",
"destination",
"type",
"date",
"country"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Departure date in YYYY-MM-DD format."
},
"type": {
"enum": [
"OW",
"RT"
],
"type": "string",
"description": "Trip type: 'OW' one-way or 'RT' round-trip."
},
"origin": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Origin airport IATA code, e.g. 'JFK'."
},
"country": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Two-letter Google region code, e.g. 'us' (default 'us')."
},
"returnDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Return date in YYYY-MM-DD format; required for round-trip searches."
},
"destination": {
"type": "string",
"pattern": "^[A-Za-z]{3}$",
"description": "Destination airport IATA code, e.g. 'SIN'."
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"fare": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "Currency code of the quoted prices, e.g. 'IDR'."
}
},
"additionalProperties": true
},
"flights": {
"type": "object",
"properties": {
"city": {
"type": "string",
"description": "Human-readable origin city name as returned, e.g. 'Kota New York'."
},
"code": {
"type": "string",
"description": "Origin IATA code."
},
"date": {
"type": "string",
"description": "The search departure date, YYYY-MM-DD."
},
"flights": {
"type": "array",
"items": {
"type": "object",
"properties": {
"price": {
"type": "string",
"description": "Quoted fare formatted for the region's currency. May be an empty string on options the upstream did not quote a fare for (as observed on a nonstop)."
},
"stops": {
"type": "integer",
"description": "Number of stops: 0 for a nonstop, 1 for a single connection, etc."
},
"airline": {
"type": "string",
"description": "Carrier name, e.g. 'Singapore Airlines'."
},
"duration": {
"type": "string",
"description": "Total travel time as a human-readable string, e.g. '27 j 15 mnt'."
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Segment departure date, YYYY-MM-DD."
},
"origin": {
"type": "string",
"description": "Segment origin airport code."
},
"airline": {
"type": "string",
"description": "Carrier name operating this leg."
},
"flightNo": {
"type": "string",
"description": "Flight number for this leg."
},
"destination": {
"type": "string",
"description": "Segment destination airport code."
}
},
"additionalProperties": true
},
"description": "Per-leg breakdown of the itinerary when the option has connections."
},
"price_raw": {
"type": "string",
"description": "Fare as a raw numeric string in words for the region. May be an empty string when no fare was quoted."
},
"trip_type": {
"type": "string",
"description": "Ticket class or trip label returned for the option."
},
"booking_url": {
"type": [
"string",
"null"
],
"description": "A lead-out URL for booking this option; not populated in the returned quote."
},
"airline_code": {
"type": "string",
"description": "Carrier IATA code, e.g. 'SQ'."
},
"airline_logo": {
"type": [
"string",
"null"
],
"description": "Square logo URL for the carrier; not populated in the returned quote."
},
"arrival_time": {
"type": "string",
"description": "Arrival time in HH.MM form as returned."
},
"flight_class": {
"type": "string",
"description": "Cabin class, e.g. 'economy'."
},
"stops_detail": {
"type": "string",
"description": "Human-readable connection detail, e.g. '1 transit'."
},
"co2_emissions": {
"type": "string",
"description": "Estimated carbon footprint per traveler as a string."
},
"flight_number": {
"type": "string",
"description": "Full flight number, e.g. 'SQ 23'."
},
"departure_time": {
"type": "string",
"description": "Departure time in HH.MM form as returned."
},
"origin_airport": {
"type": "string",
"description": "Origin airport code."
},
"destination_airport": {
"type": "string",
"description": "Destination airport code."
}
},
"additionalProperties": true
},
"description": "Bookable flight options for the route and date. Empty when no bookable flights match, as observed for a past departure date."
},
"total_results": {
"type": "integer",
"description": "Number of bookable options Google Flights returned. 0 when none match."
}
},
"additionalProperties": true
},
"platform": {
"type": "string",
"description": "Fixed upstream source label, e.g. 'google_flights'."
},
"passengers": {
"type": "object",
"properties": {
"adults": {
"type": "integer",
"description": "Number of adult travelers the search was run for."
},
"infants": {
"type": "integer",
"description": "Number of infant travelers (0 when none)."
},
"children": {
"type": "integer",
"description": "Number of child travelers (0 when none)."
}
},
"additionalProperties": true
},
"scraped_at": {
"type": "string",
"description": "ISO 8601 timestamp of when the quote was retrieved."
},
"source_url": {
"type": [
"string",
"null"
],
"description": "The upstream search results page URL; not populated in the returned quote."
},
"flight_class": {
"type": "string",
"description": "Cabin class the search was run in, e.g. 'economy'."
},
"search_params": {
"type": "object",
"properties": {
"origin": {
"type": "string"
},
"trip_type": {
"type": "string",
"description": "Either 'one_way' or 'round_trip'."
},
"depart_date": {
"type": "string",
"description": "Departure date, YYYY-MM-DD, as requested."
},
"destination": {
"type": "string"
},
"origin_code": {
"type": "string",
"description": "Origin IATA code echoed back."
},
"return_date": {
"type": [
"string",
"null"
],
"description": "Return date, YYYY-MM-DD, when a round-trip search is run; null on a one-way search (as observed)."
},
"destination_code": {
"type": "string",
"description": "Destination IATA code echoed back."
}
},
"additionalProperties": true
},
"total_flights_found": {
"type": "integer",
"description": "Total matching flights surface: a duplicate of the count under flights."
}
},
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.01365 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 25, 2026