naftiko: 1.0.0-alpha2
info:
  label: Fintecture AIS API — Accounts
  description: 'Fintecture AIS API — Accounts. 3 operations. Lead operation: Get All Accounts.'
  tags: [Fintecture, AIS, Accounts, Open Banking]
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      FINTECTURE_AIS_TOKEN: FINTECTURE_AIS_TOKEN
capability:
  consumes:
    - type: http
      namespace: ais-accounts
      baseUri: https://api.fintecture.com
      description: Retrieve PSU bank accounts and holders post-authentication.
      resources:
        - name: ais-v1-accounts
          path: /ais/v1/customer/{customer_id}/accounts
          operations:
            - name: getaisv1customeraccounts
              method: GET
              description: Get All Accounts
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: customer_id
                  in: path
                  required: true
        - name: ais-v1-account
          path: /ais/v1/customer/{customer_id}/account/{account_id}
          operations:
            - name: getaisv1customeraccount
              method: GET
              description: Get Specific Account
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: customer_id
                  in: path
                  required: true
                - name: account_id
                  in: path
                  required: true
        - name: ais-v1-holders
          path: /ais/v1/customer/{customer_id}/account/{account_id}/holders
          operations:
            - name: getaisv1customeraccountholders
              method: GET
              description: Get Account Holders
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: customer_id
                  in: path
                  required: true
                - name: account_id
                  in: path
                  required: true
      authentication:
        type: bearer
        value: '{{env.FINTECTURE_AIS_TOKEN}}'
        placement: header
  exposes:
    - type: rest
      namespace: ais-accounts-rest
      port: 8080
      resources:
        - path: /v1/ais/v1/customer/{customer_id}/accounts
          name: ais-v1-accounts
          operations:
            - method: GET
              name: getaisv1customeraccounts
              call: ais-accounts.getaisv1customeraccounts
              with:
                customer_id: rest.customer_id
    - type: mcp
      namespace: ais-accounts-mcp
      port: 9090
      transport: http
      tools:
        - name: fintecture-get-customer-accounts
          description: Get All Accounts
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: ais-accounts.getaisv1customeraccounts
          with:
            customer_id: tools.customer_id
        - name: fintecture-get-customer-account
          description: Get Specific Account
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: ais-accounts.getaisv1customeraccount
          with:
            customer_id: tools.customer_id
            account_id: tools.account_id
        - name: fintecture-get-account-holders
          description: Get Account Holders
          hints: { readOnly: true, destructive: false, idempotent: true }
          call: ais-accounts.getaisv1customeraccountholders
          with:
            customer_id: tools.customer_id
            account_id: tools.account_id