AviationStack API

naftiko: 1.0.0-alpha2
info:
  label: AviationStack API
  description: 'AviationStack API. 11 operations. Lead operation: Aircraft type classifications. Self-contained Naftiko capability
    covering one Aviationstack business surface.'
  tags:
  - Aviationstack
  - AviationStack API
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AVIATIONSTACK_API_KEY: AVIATIONSTACK_API_KEY
capability:
  consumes:
  - type: http
    namespace: aviationstack
    baseUri: https://aviationstack.com
    description: AviationStack API business capability. Self-contained, no shared references.
    resources:
    - name: v1-aircraft_types
      path: /v1/aircraft_types
      operations:
      - name: get
        method: GET
        description: Aircraft type classifications
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-airlines
      path: /v1/airlines
      operations:
      - name: get
        method: GET
        description: Airline data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-airplanes
      path: /v1/airplanes
      operations:
      - name: get
        method: GET
        description: Aircraft information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-airports
      path: /v1/airports
      operations:
      - name: get
        method: GET
        description: Global airport information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-cities
      path: /v1/cities
      operations:
      - name: get
        method: GET
        description: City destination data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-countries
      path: /v1/countries
      operations:
      - name: get
        method: GET
        description: Country information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-flights
      path: /v1/flights
      operations:
      - name: get
        method: GET
        description: Real-time and historical flights
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-flightsFuture
      path: /v1/flightsFuture
      operations:
      - name: get
        method: GET
        description: Future flight schedule data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-routes
      path: /v1/routes
      operations:
      - name: get
        method: GET
        description: Airline route data
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-taxes
      path: /v1/taxes
      operations:
      - name: get
        method: GET
        description: Aviation tax information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-timetable
      path: /v1/timetable
      operations:
      - name: get
        method: GET
        description: Real-time flight schedule for current day
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: aviationstack-rest
    port: 8080
    description: REST adapter for AviationStack API. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/v1/aircraft-types
      name: v1-aircraft-types
      description: REST surface for v1-aircraft_types.
      operations:
      - method: GET
        name: get
        description: Aircraft type classifications
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/airlines
      name: v1-airlines
      description: REST surface for v1-airlines.
      operations:
      - method: GET
        name: get
        description: Airline data
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/airplanes
      name: v1-airplanes
      description: REST surface for v1-airplanes.
      operations:
      - method: GET
        name: get
        description: Aircraft information
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/airports
      name: v1-airports
      description: REST surface for v1-airports.
      operations:
      - method: GET
        name: get
        description: Global airport information
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/cities
      name: v1-cities
      description: REST surface for v1-cities.
      operations:
      - method: GET
        name: get
        description: City destination data
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/countries
      name: v1-countries
      description: REST surface for v1-countries.
      operations:
      - method: GET
        name: get
        description: Country information
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/flights
      name: v1-flights
      description: REST surface for v1-flights.
      operations:
      - method: GET
        name: get
        description: Real-time and historical flights
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/flightsfuture
      name: v1-flightsfuture
      description: REST surface for v1-flightsFuture.
      operations:
      - method: GET
        name: get
        description: Future flight schedule data
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/routes
      name: v1-routes
      description: REST surface for v1-routes.
      operations:
      - method: GET
        name: get
        description: Airline route data
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/taxes
      name: v1-taxes
      description: REST surface for v1-taxes.
      operations:
      - method: GET
        name: get
        description: Aviation tax information
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/timetable
      name: v1-timetable
      description: REST surface for v1-timetable.
      operations:
      - method: GET
        name: get
        description: Real-time flight schedule for current day
        call: aviationstack.get
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: aviationstack-mcp
    port: 9090
    transport: http
    description: MCP adapter for AviationStack API. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: aircraft-type-classifications
      description: Aircraft type classifications
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: airline-data
      description: Airline data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: aircraft-information
      description: Aircraft information
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: global-airport-information
      description: Global airport information
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: city-destination-data
      description: City destination data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: country-information
      description: Country information
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: real-time-and-historical-flights
      description: Real-time and historical flights
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: future-flight-schedule-data
      description: Future flight schedule data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: airline-route-data
      description: Airline route data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: aviation-tax-information
      description: Aviation tax information
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.
    - name: real-time-flight-schedule-current
      description: Real-time flight schedule for current day
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: aviationstack.get
      outputParameters:
      - type: object
        mapping: $.