Flight Inspiration Search — Flight Destinations

naftiko: "1.0.0-alpha2"
info:
  label: "Flight Inspiration Search — Flight Destinations"
  description: 'Flight Inspiration Search — Flight Destinations. 1 operation(s). Lead operation: Amadeus Find the Cheapest Destinations Where You Can Fly to.. Self-contained Naftiko capability covering one Amadeus business surface.'
  tags:
    - Amadeus
    - Travel
    - Flight Destinations
  created: "2026-05-29"
  modified: "2026-05-29"
binds:
  - namespace: env
    keys:
      AMADEUS_TOKEN: AMADEUS_TOKEN
capability:
  consumes:
    - type: http
      namespace: flight-inspiration-search-flight-destinations
      baseUri: https://test.api.amadeus.com/v1
      description: Flight Inspiration Search — Flight Destinations business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.AMADEUS_TOKEN}}'
      resources:
        - name: shopping-flight-destinations
          path: /shopping/flight-destinations
          operations:
            - name: getFlightDestinations
              method: GET
              description: Amadeus Find the Cheapest Destinations Where You Can Fly to.
              inputParameters:
                - name: origin
                  in: query
                  type: string
                  required: true
                  description: "IATA code of the city from which the flight will depart\n\n[IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx) - e.g. MAD for Madrid\n"
                - name: departureDate
                  in: query
                  type: string
                  required: false
                  description: "The date, or range of dates, on which the flight will depart from the origin. Dates are specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DD format, e.g. 2017-12-25. \n\nRanges"
                - name: oneWay
                  in: query
                  type: boolean
                  required: false
                  description: if this parameter is set to true, only one-way flights are considered. If this parameter is not set or set to false, only round-trip flights are considered
                - name: duration
                  in: query
                  type: string
                  required: false
                  description: "Exact duration or range of durations of the travel, in days.\n\nThis parameter must not be set if oneWay is true. \n\nRanges are specified with a comma and are inclusive, e.g. 2,8\n\nDuration can not be low"
                - name: nonStop
                  in: query
                  type: boolean
                  required: false
                  description: if this parameter is set to true, only flights going from the origin to the destination with no stop in-between are considered
                - name: maxPrice
                  in: query
                  type: integer
                  required: false
                  description: defines the price limit for each offer returned. The value should be a positive number, without decimals
                - name: viewBy
                  in: query
                  type: string
                  required: false
                  description: view the flight destinations by DATE, DESTINATION, DURATION, WEEK, or COUNTRY. View by DATE (default when oneWay is true) to get the cheapest flight destination for every departure date in the given r
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: flight-inspiration-search-flight-destinations-rest
      port: 8080
      description: REST adapter for Flight Inspiration Search — Flight Destinations. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/shopping/flight-destinations
          name: shopping-flight-destinations
          description: REST surface for shopping-flight-destinations.
          operations:
            - method: GET
              name: getFlightDestinations
              description: Amadeus Find the Cheapest Destinations Where You Can Fly to.
              call: flight-inspiration-search-flight-destinations.getFlightDestinations
              with:
                origin: rest.origin
                departureDate: rest.departureDate
                oneWay: rest.oneWay
                duration: rest.duration
                nonStop: rest.nonStop
                maxPrice: rest.maxPrice
                viewBy: rest.viewBy
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: flight-inspiration-search-flight-destinations-mcp
      port: 9090
      transport: http
      description: MCP adapter for Flight Inspiration Search — Flight Destinations. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: find-cheapest-destinations-where-you
          description: Amadeus Find the Cheapest Destinations Where You Can Fly to.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: flight-inspiration-search-flight-destinations.getFlightDestinations
          with:
            origin: tools.origin
            departureDate: tools.departureDate
            oneWay: tools.oneWay
            duration: tools.duration
            nonStop: tools.nonStop
            maxPrice: tools.maxPrice
            viewBy: tools.viewBy
          outputParameters:
            - type: object
              mapping: $.