get_flight_options

Instructions

Get flight options from the previously performed search. This tool allows you to filter the found flight options by price, departure and arrival times, and airlines. It returns a paginated list of flight options that match the specified filters and sorting option.IMPORTANT: This is very cheap operation, so you can call it as many times as needed to find the best flight options.

Input Schema

Name	Required	Description
`filters`	Yes
`page`	No	Page number for pagination. Default is 0.
`page_size`	No	Number of results per page. Default is 10.
`search_id`	Yes

Input Schema (JSON Schema)

{
  "$defs": {
    "FiltersModel": {
      "description": "Model for filtering flight proposals",
      "properties": {
        "allowed_airlines": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "List of allowed airline IATA codes",
          "title": "Allowed Airlines"
        },
        "max_price": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Maximum price filter",
          "title": "Max Price"
        },
        "max_stops": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Maximum number of stops allowed",
          "title": "Max Stops"
        },
        "max_total_duration": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Maximum total duration of whole trip in minutes",
          "title": "Max Total Duration"
        },
        "segment_time_filters": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/SegmentTimeFilter"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Time filters for each segment",
          "title": "Segment Time Filters"
        },
        "sorting": {
          "anyOf": [
            {
              "$ref": "#/$defs/SortingMethod"
            },
            {
              "type": "null"
            }
          ],
          "default": "cheap_first",
          "description": "Sorting method"
        }
      },
      "title": "FiltersModel",
      "type": "object"
    },
    "SegmentTimeFilter": {
      "description": "Time filters for a specific segment",
      "properties": {
        "arrival_time_range": {
          "anyOf": [
            {
              "$ref": "#/$defs/TimeRange"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "departure_time_range": {
          "anyOf": [
            {
              "$ref": "#/$defs/TimeRange"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "title": "SegmentTimeFilter",
      "type": "object"
    },
    "SortingMethod": {
      "enum": [
        "cheap_first",
        "early_departure_first",
        "early_arrival_first",
        "minimal_duration_first"
      ],
      "title": "SortingMethod",
      "type": "string"
    },
    "TimeRange": {
      "description": "Time range for filtering departure/arrival times",
      "properties": {
        "end_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "End time in HH:MM format (e.g., '22:00')",
          "title": "End Time"
        },
        "start_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Start time in HH:MM format (e.g., '08:00')",
          "title": "Start Time"
        }
      },
      "title": "TimeRange",
      "type": "object"
    }
  },
  "properties": {
    "filters": {
      "$ref": "#/$defs/FiltersModel",
      "title": "Filters"
    },
    "page": {
      "default": 0,
      "description": "Page number for pagination. Default is 0.",
      "title": "Page",
      "type": "integer"
    },
    "page_size": {
      "default": 10,
      "description": "Number of results per page. Default is 10.",
      "title": "Page Size",
      "type": "integer"
    },
    "search_id": {
      "title": "Search Id",
      "type": "string"
    }
  },
  "required": [
    "search_id",
    "filters"
  ],
  "type": "object"
}

Flights MCP

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Flights MCP

Related Tools

MCP directory API