naftiko: 1.0.0-alpha2
info:
  label: dLocal KYC Verifications API — Verifications
  description: dLocal KYC Verifications capability — create and inspect KYC verifications
    across remittance, payouts on hold, payins on hold, and standalone flows.
  tags:
  - dLocal
  - KYC
  - Compliance
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    DLOCAL_LOGIN: DLOCAL_LOGIN
    DLOCAL_TRANS_KEY: DLOCAL_TRANS_KEY
    DLOCAL_SECRET: DLOCAL_SECRET
capability:
  consumes:
  - type: http
    namespace: kyc-verifications
    baseUri: https://api.dlocal.com
    description: dLocal KYC Verifications business capability.
    resources:
    - name: verifications
      path: /verifications
      operations:
      - name: createverification
        method: POST
        description: dLocal Create A Verification
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: verification-by-id
      path: /verifications/{verification_id}
      operations:
      - name: getverification
        method: GET
        description: dLocal Get A Verification
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: verification_id
          in: path
          type: string
          required: true
    authentication:
      type: apikey
      key: X-Trans-Key
      value: '{{env.DLOCAL_TRANS_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: kyc-verifications-mcp
    port: 9090
    transport: http
    description: MCP adapter for dLocal KYC Verifications.
    tools:
    - name: dlocal-create-verification
      description: dLocal Create A Verification
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: kyc-verifications.createverification
      with: { body: tools.body }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-verification
      description: dLocal Get A Verification
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: kyc-verifications.getverification
      with: { verification_id: tools.verification_id }
      outputParameters:
      - type: object
        mapping: $.