Truist Commercial Banking

naftiko: "1.0.0-alpha1"

info:
  label: "Truist Commercial Banking"
  description: >-
    Unified commercial banking capability combining commercial account management and
    transaction retrieval. Used by treasury teams, ERP integrations, and corporate
    finance applications to manage commercial deposit accounts, retrieve real-time
    balances, and access complete transaction history including ACH, wire transfers,
    and check payments for cash flow reconciliation and treasury management.
  tags:
    - Banking
    - Commercial Banking
    - Treasury
    - Accounts
    - Transactions
    - Payments
    - ACH
    - Wire Transfer
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      TRUIST_COMMERCIAL_OAUTH2_TOKEN: TRUIST_COMMERCIAL_OAUTH2_TOKEN

capability:
  consumes:
    - import: truist-commercial-accounts
      location: ./shared/commercial-accounts.yaml
    - import: truist-commercial-transactions
      location: ./shared/commercial-transactions.yaml

  exposes:
    - type: rest
      port: 8081
      namespace: truist-commercial-banking-api
      description: "Unified REST API for commercial banking account management and transaction reporting."
      resources:
        - path: /v1/commercial/accounts
          name: commercial-accounts
          description: "Commercial deposit accounts"
          operations:
            - method: GET
              name: list-commercial-accounts
              description: "List all commercial deposit accounts for the organization."
              call: "truist-commercial-accounts.list-commercial-accounts"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/commercial/accounts/summary
          name: commercial-account-summary
          description: "Consolidated commercial account balance summary"
          operations:
            - method: GET
              name: get-commercial-account-summary
              description: "Get consolidated balance summary across all commercial accounts."
              call: "truist-commercial-accounts.get-commercial-account-summary"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/commercial/accounts/{accountId}
          name: commercial-account
          description: "Individual commercial account"
          operations:
            - method: GET
              name: get-commercial-account
              description: "Get details for a specific commercial account."
              call: "truist-commercial-accounts.get-commercial-account"
              with:
                accountId: "rest.accountId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/commercial/accounts/{accountId}/balances
          name: commercial-account-balances
          description: "Commercial account balance data"
          operations:
            - method: GET
              name: get-commercial-account-balances
              description: "Get ledger, available, collected, and float balances for a commercial account."
              call: "truist-commercial-accounts.get-commercial-account-balances"
              with:
                accountId: "rest.accountId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/commercial/accounts/{accountId}/transactions
          name: commercial-transactions
          description: "Commercial account transaction history"
          operations:
            - method: GET
              name: list-commercial-transactions
              description: "List commercial transactions including ACH, wires, and checks."
              call: "truist-commercial-transactions.list-commercial-transactions"
              with:
                accountId: "rest.accountId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/commercial/accounts/{accountId}/transactions/{transactionId}
          name: commercial-transaction
          description: "Individual commercial transaction"
          operations:
            - method: GET
              name: get-commercial-transaction
              description: "Get details for a specific commercial transaction."
              call: "truist-commercial-transactions.get-commercial-transaction"
              with:
                accountId: "rest.accountId"
                transactionId: "rest.transactionId"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9081
      namespace: truist-commercial-banking-mcp
      transport: http
      description: "MCP server for AI-assisted commercial banking, treasury management, and cash flow analysis."
      tools:
        - name: list-commercial-accounts
          description: "List all commercial deposit accounts for the organization."
          hints:
            readOnly: true
            openWorld: false
          call: "truist-commercial-accounts.list-commercial-accounts"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-commercial-account
          description: "Get details for a specific commercial deposit account."
          hints:
            readOnly: true
            openWorld: false
          call: "truist-commercial-accounts.get-commercial-account"
          with:
            accountId: "tools.accountId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-commercial-account-balances
          description: "Get ledger, available, collected, and float balances for a commercial account. Used for daily balance reporting and intraday cash position monitoring."
          hints:
            readOnly: true
            openWorld: false
          call: "truist-commercial-accounts.get-commercial-account-balances"
          with:
            accountId: "tools.accountId"
            asOfDate: "tools.asOfDate"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-commercial-account-summary
          description: "Get a consolidated balance summary across all commercial accounts for the organization."
          hints:
            readOnly: true
            openWorld: false
          call: "truist-commercial-accounts.get-commercial-account-summary"
          with:
            customerId: "tools.customerId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-commercial-transactions
          description: "Retrieve commercial account transactions with filtering by date range and payment type (ACH, wire, check, book transfer)."
          hints:
            readOnly: true
            openWorld: false
          call: "truist-commercial-transactions.list-commercial-transactions"
          with:
            accountId: "tools.accountId"
            fromDate: "tools.fromDate"
            toDate: "tools.toDate"
            transactionType: "tools.transactionType"
            debitCreditIndicator: "tools.debitCreditIndicator"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-commercial-transaction
          description: "Get details for a specific commercial account transaction including ACH trace numbers, wire reference numbers, and check numbers."
          hints:
            readOnly: true
            openWorld: false
          call: "truist-commercial-transactions.get-commercial-transaction"
          with:
            accountId: "tools.accountId"
            transactionId: "tools.transactionId"
          outputParameters:
            - type: object
              mapping: "$."