Trulioo Configuration API — Configuration

naftiko: 1.0.0-alpha2
info:
  label: Trulioo Configuration API — Configuration
  description: >-
    Discovery endpoints for the Trulioo GlobalGateway: packages, country codes,
    subdivisions, fields, datasources, consents, test entities, and document types.
  tags:
    - Trulioo
    - Configuration
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      TRULIOO_USERNAME: TRULIOO_USERNAME
      TRULIOO_PASSWORD: TRULIOO_PASSWORD
capability:
  consumes:
    - type: http
      namespace: configuration-configuration
      baseUri: https://api.trulioo.com
      description: Trulioo Configuration discovery endpoints.
      resources:
        - name: packages
          path: /v3/configuration/packages
          operations:
            - name: getPackages
              method: GET
              description: Get List Of Packages
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
        - name: countrycodes
          path: /v3/configuration/countrycodes/{configurationName}
          operations:
            - name: getCountryCodes
              method: GET
              description: Get Country Codes
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
              inputParameters:
                - name: configurationName
                  in: path
                  type: string
                  required: true
        - name: fields
          path: /v3/configuration/fields/{configurationName}/{countryCode}
          operations:
            - name: getFields
              method: GET
              description: Get Fields
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: configurationName
                  in: path
                  type: string
                  required: true
                - name: countryCode
                  in: path
                  type: string
                  required: true
        - name: datasources
          path: /v3/configuration/datasources/{configurationName}/{countryCode}
          operations:
            - name: getDatasources
              method: GET
              description: Get Datasources
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
              inputParameters:
                - name: configurationName
                  in: path
                  type: string
                  required: true
                - name: countryCode
                  in: path
                  type: string
                  required: true
        - name: consents
          path: /v3/configuration/consents/{configurationName}/{countryCode}
          operations:
            - name: getConsents
              method: GET
              description: Get Consents
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
              inputParameters:
                - name: configurationName
                  in: path
                  type: string
                  required: true
                - name: countryCode
                  in: path
                  type: string
                  required: true
        - name: testentities
          path: /v3/configuration/testentities/{configurationName}/{countryCode}
          operations:
            - name: getTestEntities
              method: GET
              description: Get Test Entities
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
              inputParameters:
                - name: configurationName
                  in: path
                  type: string
                  required: true
                - name: countryCode
                  in: path
                  type: string
                  required: true
      authentication:
        type: basic
        username: '{{env.TRULIOO_USERNAME}}'
        password: '{{env.TRULIOO_PASSWORD}}'
  exposes:
    - type: mcp
      namespace: configuration-configuration-mcp
      port: 9090
      transport: http
      description: MCP adapter for Trulioo Configuration discovery.
      tools:
        - name: trulioo-get-country-codes
          description: List country codes available for a Trulioo configuration
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: configuration-configuration.getCountryCodes
          with:
            configurationName: tools.configurationName
          outputParameters:
            - type: array
              mapping: $.
        - name: trulioo-get-fields
          description: List accepted fields for a Trulioo configuration / country
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: configuration-configuration.getFields
          with:
            configurationName: tools.configurationName
            countryCode: tools.countryCode
          outputParameters:
            - type: object
              mapping: $.
        - name: trulioo-get-datasources
          description: List datasources for a Trulioo configuration / country
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: configuration-configuration.getDatasources
          with:
            configurationName: tools.configurationName
            countryCode: tools.countryCode
          outputParameters:
            - type: array
              mapping: $.