MeteoSource Air Quality Data API

naftiko: 1.0.0-alpha2
info:
  label: MeteoSource Air Quality Data API
  description: MeteoSource provides an Air Quality API delivering hour-by-hour pollution data for any location on Earth, with
    forecasts up to 5 days ahead. The API also offers weather forecast data, location lookup, weather maps, and historical
    Time Machine data.
  tags:
  - Meteosource
  - Air
  - Quality
  - Data
  - Api
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: meteosource-air-quality-data-api
    baseUri: https://www.meteosource.com/api/v1
    description: MeteoSource Air Quality Data API HTTP API.
    authentication:
      type: apikey
      in: query
      name: key
      value: '{{METEOSOURCE_AIR_QUALITY_DATA_API_TOKEN}}'
    resources:
    - name: free-point
      path: /free/point
      operations:
      - name: getfreepointweather
        method: GET
        description: Get point weather forecast (free tier)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: flexi-point
      path: /flexi/point
      operations:
      - name: getflexipointweather
        method: GET
        description: Get point weather forecast (flexi tier)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: flexi-air-quality
      path: /flexi/air_quality
      operations:
      - name: getairquality
        method: GET
        description: Get point air quality forecast
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: free-find-places
      path: /free/find_places
      operations:
      - name: findplaces
        method: GET
        description: Find places by name or ZIP
        inputParameters:
        - name: text
          in: query
          type: string
          required: true
        - name: language
          in: query
          type: string
        - name: area
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: free-find-places-prefix
      path: /free/find_places_prefix
      operations:
      - name: findplacesbyprefix
        method: GET
        description: Find places by prefix
        inputParameters:
        - name: text
          in: query
          type: string
          required: true
        - name: language
          in: query
          type: string
        - name: area
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: free-nearest-place
      path: /free/nearest_place
      operations:
      - name: findnearestplace
        method: GET
        description: Find nearest place to coordinates
        inputParameters:
        - name: language
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: flexi-map
      path: /flexi/map
      operations:
      - name: getmap
        method: GET
        description: Get weather or pollution map
        inputParameters:
        - name: tile_x
          in: query
          type: integer
        - name: tile_y
          in: query
          type: integer
        - name: tile_zoom
          in: query
          type: integer
        - name: min_lat
          in: query
          type: number
        - name: min_lon
          in: query
          type: number
        - name: max_lat
          in: query
          type: number
        - name: max_lon
          in: query
          type: number
        - name: variable
          in: query
          type: string
          required: true
        - name: datetime
          in: query
          type: string
        - name: format
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: flexi-time-machine
      path: /flexi/time_machine
      operations:
      - name: gettimemachine
        method: GET
        description: Get historical Time Machine data
        inputParameters:
        - name: date
          in: query
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: meteosource-air-quality-data-api-rest
    description: REST adapter for MeteoSource Air Quality Data API.
    resources:
    - path: /free/point
      name: getfreepointweather
      operations:
      - method: GET
        name: getfreepointweather
        description: Get point weather forecast (free tier)
        call: meteosource-air-quality-data-api.getfreepointweather
        outputParameters:
        - type: object
          mapping: $.
    - path: /flexi/point
      name: getflexipointweather
      operations:
      - method: GET
        name: getflexipointweather
        description: Get point weather forecast (flexi tier)
        call: meteosource-air-quality-data-api.getflexipointweather
        outputParameters:
        - type: object
          mapping: $.
    - path: /flexi/air_quality
      name: getairquality
      operations:
      - method: GET
        name: getairquality
        description: Get point air quality forecast
        call: meteosource-air-quality-data-api.getairquality
        outputParameters:
        - type: object
          mapping: $.
    - path: /free/find_places
      name: findplaces
      operations:
      - method: GET
        name: findplaces
        description: Find places by name or ZIP
        call: meteosource-air-quality-data-api.findplaces
        outputParameters:
        - type: object
          mapping: $.
    - path: /free/find_places_prefix
      name: findplacesbyprefix
      operations:
      - method: GET
        name: findplacesbyprefix
        description: Find places by prefix
        call: meteosource-air-quality-data-api.findplacesbyprefix
        outputParameters:
        - type: object
          mapping: $.
    - path: /free/nearest_place
      name: findnearestplace
      operations:
      - method: GET
        name: findnearestplace
        description: Find nearest place to coordinates
        call: meteosource-air-quality-data-api.findnearestplace
        outputParameters:
        - type: object
          mapping: $.
    - path: /flexi/map
      name: getmap
      operations:
      - method: GET
        name: getmap
        description: Get weather or pollution map
        call: meteosource-air-quality-data-api.getmap
        outputParameters:
        - type: object
          mapping: $.
    - path: /flexi/time_machine
      name: gettimemachine
      operations:
      - method: GET
        name: gettimemachine
        description: Get historical Time Machine data
        call: meteosource-air-quality-data-api.gettimemachine
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: meteosource-air-quality-data-api-mcp
    transport: http
    description: MCP adapter for MeteoSource Air Quality Data API for AI agent use.
    tools:
    - name: getfreepointweather
      description: Get point weather forecast (free tier)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.getfreepointweather
      outputParameters:
      - type: object
        mapping: $.
    - name: getflexipointweather
      description: Get point weather forecast (flexi tier)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.getflexipointweather
      outputParameters:
      - type: object
        mapping: $.
    - name: getairquality
      description: Get point air quality forecast
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.getairquality
      outputParameters:
      - type: object
        mapping: $.
    - name: findplaces
      description: Find places by name or ZIP
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.findplaces
      with:
        text: tools.text
        language: tools.language
        area: tools.area
      inputParameters:
      - name: text
        type: string
        description: text
        required: true
      - name: language
        type: string
        description: language
      - name: area
        type: string
        description: area
      outputParameters:
      - type: object
        mapping: $.
    - name: findplacesbyprefix
      description: Find places by prefix
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.findplacesbyprefix
      with:
        text: tools.text
        language: tools.language
        area: tools.area
      inputParameters:
      - name: text
        type: string
        description: text
        required: true
      - name: language
        type: string
        description: language
      - name: area
        type: string
        description: area
      outputParameters:
      - type: object
        mapping: $.
    - name: findnearestplace
      description: Find nearest place to coordinates
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.findnearestplace
      with:
        language: tools.language
      inputParameters:
      - name: language
        type: string
        description: language
      outputParameters:
      - type: object
        mapping: $.
    - name: getmap
      description: Get weather or pollution map
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.getmap
      with:
        tile_x: tools.tile_x
        tile_y: tools.tile_y
        tile_zoom: tools.tile_zoom
        min_lat: tools.min_lat
        min_lon: tools.min_lon
        max_lat: tools.max_lat
        max_lon: tools.max_lon
        variable: tools.variable
        datetime: tools.datetime
        format: tools.format
      inputParameters:
      - name: tile_x
        type: integer
        description: tile_x
      - name: tile_y
        type: integer
        description: tile_y
      - name: tile_zoom
        type: integer
        description: tile_zoom
      - name: min_lat
        type: number
        description: min_lat
      - name: min_lon
        type: number
        description: min_lon
      - name: max_lat
        type: number
        description: max_lat
      - name: max_lon
        type: number
        description: max_lon
      - name: variable
        type: string
        description: variable
        required: true
      - name: datetime
        type: string
        description: datetime
      - name: format
        type: string
        description: format
      outputParameters:
      - type: object
        mapping: $.
    - name: gettimemachine
      description: Get historical Time Machine data
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: meteosource-air-quality-data-api.gettimemachine
      with:
        date: tools.date
      inputParameters:
      - name: date
        type: string
        description: date
        required: true
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    METEOSOURCE_AIR_QUALITY_DATA_API_TOKEN: METEOSOURCE_AIR_QUALITY_DATA_API_TOKEN