naftiko: 1.0.0-alpha2
info:
  label: dLocal Payouts V3 API — Payouts
  description: dLocal Payouts V3 capability — request, retrieve, release, and cancel
    payouts to beneficiaries in 60+ emerging-market countries. Uses OAuth2 bearer auth.
  tags:
  - dLocal
  - Payouts
  - Disbursements
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    DLOCAL_PAYOUTS_BEARER: DLOCAL_PAYOUTS_BEARER
capability:
  consumes:
  - type: http
    namespace: payouts-v3-payouts
    baseUri: https://api.dlocal.com
    description: dLocal Payouts V3 business capability.
    resources:
    - name: payouts
      path: /payouts/v3
      operations:
      - name: requestpayout
        method: POST
        description: dLocal Request A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: payout-by-id
      path: /payouts/v3/{payout_id}
      operations:
      - name: getpayout
        method: GET
        description: dLocal Get A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: payout_id
          in: path
          type: string
          required: true
      - name: cancelpayout
        method: POST
        path: /payouts/v3/{payout_id}/cancel
        description: dLocal Cancel A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: payout_id
          in: path
          type: string
          required: true
      - name: releasepayout
        method: POST
        path: /payouts/v3/{payout_id}/release
        description: dLocal Release A Payout
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: payout_id
          in: path
          type: string
          required: true
    - name: balance
      path: /payouts/v3/balance
      operations:
      - name: getbalance
        method: GET
        description: dLocal Get Payouts Balance
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      value: '{{env.DLOCAL_PAYOUTS_BEARER}}'
      placement: header
  exposes:
  - type: mcp
    namespace: payouts-v3-payouts-mcp
    port: 9090
    transport: http
    description: MCP adapter for dLocal Payouts V3.
    tools:
    - name: dlocal-request-payout
      description: dLocal Request A Payout
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: payouts-v3-payouts.requestpayout
      with: { body: tools.body }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-payout
      description: dLocal Get A Payout
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: payouts-v3-payouts.getpayout
      with: { payout_id: tools.payout_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-cancel-payout
      description: dLocal Cancel A Payout
      hints: { readOnly: false, destructive: true, idempotent: true }
      call: payouts-v3-payouts.cancelpayout
      with: { payout_id: tools.payout_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-release-payout
      description: dLocal Release A Payout
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: payouts-v3-payouts.releasepayout
      with: { payout_id: tools.payout_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-payouts-balance
      description: dLocal Get Payouts Balance
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: payouts-v3-payouts.getbalance
      outputParameters:
      - type: object
        mapping: $.