naftiko: "1.0.0-alpha2"
info:
  label: "On-Demand Flight Status — Flights"
  description: 'On-Demand Flight Status — Flights. 1 operation(s). Lead operation: Amadeus Retrieves a Unique Flight by Search Criteria.. Self-contained Naftiko capability covering one Amadeus business surface.'
  tags:
    - Amadeus
    - Travel
    - Flights
  created: "2026-05-29"
  modified: "2026-05-29"
binds:
  - namespace: env
    keys:
      AMADEUS_TOKEN: AMADEUS_TOKEN
capability:
  consumes:
    - type: http
      namespace: on-demand-flight-status-flights
      baseUri: https://test.api.amadeus.com/v2
      description: On-Demand Flight Status — Flights business capability. Self-contained, no shared references.
      authentication:
        type: bearer
        token: '{{env.AMADEUS_TOKEN}}'
      resources:
        - name: schedule-flights
          path: /schedule/flights
          operations:
            - name: getFlightsStatus
              method: GET
              description: Amadeus Retrieves a Unique Flight by Search Criteria.
              inputParameters:
                - name: carrierCode
                  in: query
                  type: string
                  required: true
                  description: "2 to 3-character IATA carrier code ([IATA table codes](http://www.iata.org/publications/Pages/code-search.aspx)).\n"
                - name: flightNumber
                  in: query
                  type: string
                  required: true
                  description: 1 to 4-digit number of the flight. e.g. 4537
                - name: scheduledDepartureDate
                  in: query
                  type: string
                  required: true
                  description: scheduled departure date of the flight, local to the departure airport, format YYYY-MM-DD.
                - name: operationalSuffix
                  in: query
                  type: string
                  required: false
                  description: "1-letter operational suffix assigned by the carrier to differentiate flight in case of delay changing the departure date e.g. A\n"
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
  exposes:
    - type: rest
      namespace: on-demand-flight-status-flights-rest
      port: 8080
      description: REST adapter for On-Demand Flight Status — Flights. One Spectral-compliant resource per consumed operation, prefixed with /v1.
      resources:
        - path: /v1/schedule/flights
          name: schedule-flights
          description: REST surface for schedule-flights.
          operations:
            - method: GET
              name: getFlightsStatus
              description: Amadeus Retrieves a Unique Flight by Search Criteria.
              call: on-demand-flight-status-flights.getFlightsStatus
              with:
                carrierCode: rest.carrierCode
                flightNumber: rest.flightNumber
                scheduledDepartureDate: rest.scheduledDepartureDate
                operationalSuffix: rest.operationalSuffix
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: on-demand-flight-status-flights-mcp
      port: 9090
      transport: http
      description: MCP adapter for On-Demand Flight Status — Flights. One tool per consumed operation, routed inline through this capability's consumes block.
      tools:
        - name: retrieves-unique-flight-search-criteria
          description: Amadeus Retrieves a Unique Flight by Search Criteria.
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: on-demand-flight-status-flights.getFlightsStatus
          with:
            carrierCode: tools.carrierCode
            flightNumber: tools.flightNumber
            scheduledDepartureDate: tools.scheduledDepartureDate
            operationalSuffix: tools.operationalSuffix
          outputParameters:
            - type: object
              mapping: $.