naftiko: 1.0.0-alpha2
info:
  label: Offenders.io API
  description: Industry-leading database of National Registered Sex Offenders for the United States. Supports criteria-based
    search by name, date of birth, city, zip, state, and geospatial radius queries. Returns rich JSON records including identity,
    photo, address, GPS coordinates, crimes, and risk level.
  tags:
  - Offenders
  - Io
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: offenders-io
    baseUri: https://api.offenders.io
    description: Offenders.io API HTTP API.
    authentication:
      type: apikey
      in: query
      name: key
      value: '{{OFFENDERS_IO_TOKEN}}'
    resources:
    - name: sexoffender
      path: /sexoffender
      operations:
      - name: searchsexoffenders
        method: GET
        description: Search sex offender registry
        inputParameters:
        - name: firstName
          in: query
          type: string
          description: Offender first name (structured search).
        - name: lastName
          in: query
          type: string
          description: Offender last name (structured search).
        - name: zipcode
          in: query
          type: string
          description: ZIP code for location-based filtering.
        - name: lat
          in: query
          type: number
          description: Latitude for geospatial search.
        - name: lng
          in: query
          type: number
          description: Longitude for geospatial search.
        - name: radius
          in: query
          type: number
          description: Search radius in miles (used with lat/lng).
        - name: fuzzy
          in: query
          type: boolean
          description: Enable typo-tolerant fuzzy matching.
        - name: key
          in: query
          type: string
          required: true
          description: API key for authentication.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: offenders-io-rest
    description: REST adapter for Offenders.io API.
    resources:
    - path: /sexoffender
      name: searchsexoffenders
      operations:
      - method: GET
        name: searchsexoffenders
        description: Search sex offender registry
        call: offenders-io.searchsexoffenders
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: offenders-io-mcp
    transport: http
    description: MCP adapter for Offenders.io API for AI agent use.
    tools:
    - name: searchsexoffenders
      description: Search sex offender registry
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: offenders-io.searchsexoffenders
      with:
        firstName: tools.firstName
        lastName: tools.lastName
        zipcode: tools.zipcode
        lat: tools.lat
        lng: tools.lng
        radius: tools.radius
        fuzzy: tools.fuzzy
        key: tools.key
      inputParameters:
      - name: firstName
        type: string
        description: Offender first name (structured search).
      - name: lastName
        type: string
        description: Offender last name (structured search).
      - name: zipcode
        type: string
        description: ZIP code for location-based filtering.
      - name: lat
        type: number
        description: Latitude for geospatial search.
      - name: lng
        type: number
        description: Longitude for geospatial search.
      - name: radius
        type: number
        description: Search radius in miles (used with lat/lng).
      - name: fuzzy
        type: boolean
        description: Enable typo-tolerant fuzzy matching.
      - name: key
        type: string
        description: API key for authentication.
        required: true
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    OFFENDERS_IO_TOKEN: OFFENDERS_IO_TOKEN