naftiko: 1.0.0-alpha2
info:
  label: dLocal For Platforms API — Accounts
  description: dLocal for Platforms (marketplace) accounts capability — onboard sub-merchants,
    manage KYC, bank accounts, and transfers between accounts.
  tags:
  - dLocal
  - Platforms
  - Marketplace
  - Accounts
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    DLOCAL_PLATFORMS_BEARER: DLOCAL_PLATFORMS_BEARER
capability:
  consumes:
  - type: http
    namespace: platforms-accounts
    baseUri: https://marketplace-api.dlocal.com
    description: dLocal for Platforms business capability.
    resources:
    - name: accounts
      path: /v2/accounts
      operations:
      - name: createaccount
        method: POST
        description: dLocal Create An Account
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          required: true
    - name: account-by-id
      path: /v2/accounts/{account_id}
      operations:
      - name: getaccount
        method: GET
        description: dLocal Get An Account
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
      - name: blockaccount
        method: POST
        path: /v2/accounts/{account_id}/block
        description: dLocal Block An Account
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
      - name: getbalance
        method: GET
        path: /v2/accounts/{account_id}/balance
        description: dLocal Get Account Balance
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: account_id
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      value: '{{env.DLOCAL_PLATFORMS_BEARER}}'
      placement: header
  exposes:
  - type: mcp
    namespace: platforms-accounts-mcp
    port: 9090
    transport: http
    description: MCP adapter for dLocal for Platforms accounts.
    tools:
    - name: dlocal-create-account
      description: dLocal Create An Account
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: platforms-accounts.createaccount
      with: { body: tools.body }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-account
      description: dLocal Get An Account
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: platforms-accounts.getaccount
      with: { account_id: tools.account_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-block-account
      description: dLocal Block An Account
      hints: { readOnly: false, destructive: true, idempotent: true }
      call: platforms-accounts.blockaccount
      with: { account_id: tools.account_id }
      outputParameters:
      - type: object
        mapping: $.
    - name: dlocal-get-account-balance
      description: dLocal Get Account Balance
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: platforms-accounts.getbalance
      with: { account_id: tools.account_id }
      outputParameters:
      - type: object
        mapping: $.