IPGeolocation.io — Timezone

naftiko: 1.0.0-alpha2
info:
  label: IPGeolocation.io — Timezone
  description: 'IPGeolocation.io Timezone. 2 operations. Lead operation: Timezone lookup. Self-contained Naftiko capability covering one IPGeolocation.io business surface.'
  tags:
  - IPGeolocation
  - IP Intelligence
  - Timezone
  created: '2026-05-29'
  modified: '2026-05-29'
binds:
- namespace: env
  keys:
    IPGEOLOCATION_API_KEY: IPGEOLOCATION_API_KEY
capability:
  consumes:
  - type: http
    namespace: timezone-timezone
    baseUri: https://api.ipgeolocation.io
    description: IPGeolocation.io — Timezone business capability. Self-contained, no shared references.
    authentication:
      type: apikey
      key: apiKey
      value: '{{env.IPGEOLOCATION_API_KEY}}'
      placement: query
    resources:
    - name: timezone
      path: /v3/timezone
      operations:
      - name: lookupTimezone
        method: GET
        description: Timezone lookup
        inputParameters:
        - name: tz
          in: query
          type: string
          required: false
          description: IANA timezone identifier to retrieve timezone information.
        - name: location
          in: query
          type: string
          required: false
          description: Address or location name used to determine the timezone.
        - name: lat
          in: query
          type: number
          required: false
          description: Latitude coordinate of the location used to determine the
        - name: long
          in: query
          type: number
          required: false
          description: Longitude coordinate of the location used to determine the
        - name: ip
          in: query
          type: string
          required: false
          description: An IPv4 address, IPv6 address, or domain name to look up. When omitted, the API
        - name: iata_code
          in: query
          type: string
          required: false
          description: Three-letter IATA airport code used to determine the timezone
        - name: icao_code
          in: query
          type: string
          required: false
          description: Four-letter ICAO airport code used to determine the timezone
        - name: lo_code
          in: query
          type: string
          required: false
          description: UN/LOCODE used to determine the timezone of a city or location.
        - name: lang
          in: query
          type: string
          required: false
          description: Language code for translated location names. Defaults to `en`. Non-English
        - name: output
          in: query
          type: string
          required: false
          description: Desired response format. Defaults to `json` if not specified. You can also
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: timezone-convert
      path: /v3/timezone/convert
      operations:
      - name: convertTimezone
        method: GET
        description: Timezone time conversion
        inputParameters:
        - name: tz_from
          in: query
          type: string
          required: false
          description: Source timezone identifier (IANA format) used for time conversion.
        - name: tz_to
          in: query
          type: string
          required: false
          description: Destination timezone identifier (IANA format) used for time conversion.
        - name: location_from
          in: query
          type: string
          required: false
          description: Source location address used to determine the source timezone.
        - name: location_to
          in: query
          type: string
          required: false
          description: Destination location address used to determine the target timezone.
        - name: lat_from
          in: query
          type: number
          required: false
        - name: lat_to
          in: query
          type: number
          required: false
        - name: long_from
          in: query
          type: number
          required: false
        - name: long_to
          in: query
          type: number
          required: false
        - name: iata_from
          in: query
          type: string
          required: false
        - name: iata_to
          in: query
          type: string
          required: false
        - name: icao_from
          in: query
          type: string
          required: false
        - name: icao_to
          in: query
          type: string
          required: false
        - name: locode_from
          in: query
          type: string
          required: false
        - name: locode_to
          in: query
          type: string
          required: false
        - name: time
          in: query
          type: string
          required: false
          description: Date and time to convert.
        - name: output
          in: query
          type: string
          required: false
          description: Desired response format. Defaults to `json` if not specified. You can also
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: timezone-timezone-rest
    port: 8080
    description: REST adapter for IPGeolocation.io — Timezone. One Spectral-compliant resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/timezone
      name: timezone
      description: REST surface for /v3/timezone.
      operations:
      - method: GET
        name: lookupTimezone
        description: Timezone lookup
        call: timezone-timezone.lookupTimezone
        with:
          tz: rest.tz
          location: rest.location
          lat: rest.lat
          long: rest.long
          ip: rest.ip
          iata_code: rest.iata_code
          icao_code: rest.icao_code
          lo_code: rest.lo_code
          lang: rest.lang
          output: rest.output
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/timezone/convert
      name: timezone-convert
      description: REST surface for /v3/timezone/convert.
      operations:
      - method: GET
        name: convertTimezone
        description: Timezone time conversion
        call: timezone-timezone.convertTimezone
        with:
          tz_from: rest.tz_from
          tz_to: rest.tz_to
          location_from: rest.location_from
          location_to: rest.location_to
          lat_from: rest.lat_from
          lat_to: rest.lat_to
          long_from: rest.long_from
          long_to: rest.long_to
          iata_from: rest.iata_from
          iata_to: rest.iata_to
          icao_from: rest.icao_from
          icao_to: rest.icao_to
          locode_from: rest.locode_from
          locode_to: rest.locode_to
          time: rest.time
          output: rest.output
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: timezone-timezone-mcp
    port: 9090
    transport: http
    description: MCP adapter for IPGeolocation.io — Timezone. One tool per consumed operation, routed inline through this capability's consumes block.
    tools:
    - name: timezone-lookup
      description: Timezone lookup
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: timezone-timezone.lookupTimezone
      with:
        tz: tools.tz
        location: tools.location
        lat: tools.lat
        long: tools.long
        ip: tools.ip
        iata_code: tools.iata_code
        icao_code: tools.icao_code
        lo_code: tools.lo_code
        lang: tools.lang
        output: tools.output
      outputParameters:
      - type: object
        mapping: $.
    - name: timezone-time-conversion
      description: Timezone time conversion
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: timezone-timezone.convertTimezone
      with:
        tz_from: tools.tz_from
        tz_to: tools.tz_to
        location_from: tools.location_from
        location_to: tools.location_to
        lat_from: tools.lat_from
        lat_to: tools.lat_to
        long_from: tools.long_from
        long_to: tools.long_to
        iata_from: tools.iata_from
        iata_to: tools.iata_to
        icao_from: tools.icao_from
        icao_to: tools.icao_to
        locode_from: tools.locode_from
        locode_to: tools.locode_to
        time: tools.time
        output: tools.output
      outputParameters:
      - type: object
        mapping: $.