naftiko: 1.0.0-alpha2
info:
  label: Agify.io API
  description: Predict the age of a person based on their first name. Returns estimated age, prediction confidence (count),
    and supports country localization and batch requests of up to 10 names. Generated from documentation.
  tags:
  - Agify
  - Io
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: agify-io
    baseUri: https://api.agify.io
    description: Agify.io API HTTP API.
    resources:
    - name: resource
      path: /
      operations:
      - name: predictage
        method: GET
        description: Agify.io Predict Age from Name
        inputParameters:
        - name: name
          in: query
          type: string
          description: First name to predict age for. For batch requests use name[] array syntax.
        - name: country_id
          in: query
          type: string
          description: ISO 3166-1 alpha-2 country code for country-localized age prediction.
        - name: apikey
          in: query
          type: string
          description: API key for authenticated requests beyond the free tier (100 req/day).
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: agify-io-rest
    description: REST adapter for Agify.io API.
    resources:
    - path: /
      name: predictage
      operations:
      - method: GET
        name: predictage
        description: Agify.io Predict Age from Name
        call: agify-io.predictage
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: agify-io-mcp
    transport: http
    description: MCP adapter for Agify.io API for AI agent use.
    tools:
    - name: predictage
      description: Agify.io Predict Age from Name
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: agify-io.predictage
      with:
        name: tools.name
        country_id: tools.country_id
        apikey: tools.apikey
      inputParameters:
      - name: name
        type: string
        description: First name to predict age for. For batch requests use name[] array syntax.
      - name: country_id
        type: string
        description: ISO 3166-1 alpha-2 country code for country-localized age prediction.
      - name: apikey
        type: string
        description: API key for authenticated requests beyond the free tier (100 req/day).
      outputParameters:
      - type: object
        mapping: $.