Tazama Fraud Detection

naftiko: "1.0.0-alpha1"

info:
  label: "Tazama Fraud Detection"
  description: >-
    Workflow capability for real-time financial transaction fraud detection and
    AML compliance monitoring using the Tazama platform. Enables financial service
    providers to submit ISO 20022 transaction messages for immediate evaluation
    against configurable fraud detection rules and typology scoring.
  tags:
    - Tazama
    - Financial Technology
    - Fraud Detection
    - Anti-Money Laundering
    - ISO 20022
    - Transaction Monitoring
    - Compliance
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      TAZAMA_API_KEY: TAZAMA_API_KEY

capability:
  consumes:
    - import: tazama-tms
      location: ./shared/transaction-monitoring.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: tazama-fraud-detection-api
      description: "Unified REST API for Tazama real-time fraud detection and AML monitoring."
      resources:
        - path: /v1/health
          name: health
          description: "Service health monitoring"
          operations:
            - method: GET
              name: get-health
              description: "Check Tazama platform health status"
              call: "tazama-tms.get-health-status"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/transactions/credit-transfers
          name: credit-transfers
          description: "Customer credit transfer transaction evaluation"
          operations:
            - method: POST
              name: evaluate-credit-transfer
              description: "Submit credit transfer initiation (pain.001) for fraud and AML evaluation"
              call: "tazama-tms.evaluate-pain001-transaction"
              with:
                transaction: "rest.body"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/transactions/payment-activations
          name: payment-activations
          description: "Creditor payment activation request evaluation"
          operations:
            - method: POST
              name: evaluate-payment-activation
              description: "Submit creditor payment activation request (pain.013) for evaluation"
              call: "tazama-tms.evaluate-pain013-transaction"
              with:
                transaction: "rest.body"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/transactions/interbank-transfers
          name: interbank-transfers
          description: "FI-to-FI interbank transfer evaluation"
          operations:
            - method: POST
              name: evaluate-interbank-transfer
              description: "Submit FI-to-FI customer credit transfer (pacs.008) for fraud evaluation"
              call: "tazama-tms.evaluate-pacs008-transaction"
              with:
                transaction: "rest.body"
              outputParameters:
                - type: object
                  mapping: "$."

        - path: /v1/transactions/payment-status
          name: payment-status
          description: "Payment status report evaluation"
          operations:
            - method: POST
              name: evaluate-payment-status
              description: "Submit payment status report (pacs.002) for evaluation"
              call: "tazama-tms.evaluate-pacs002-transaction"
              with:
                transaction: "rest.body"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9090
      namespace: tazama-fraud-detection-mcp
      transport: http
      description: "MCP server for AI-assisted fraud detection and AML compliance monitoring."
      tools:
        - name: check-tazama-health
          description: "Check the operational status of the Tazama fraud detection platform"
          hints:
            readOnly: true
            openWorld: false
          call: "tazama-tms.get-health-status"
          outputParameters:
            - type: object
              mapping: "$."

        - name: evaluate-credit-transfer
          description: >-
            Submit an ISO 20022 pain.001.001.11 customer credit transfer initiation
            message for real-time fraud detection and AML screening. Returns evaluation
            results from configured rule processors and typology scoring.
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "tazama-tms.evaluate-pain001-transaction"
          with:
            transaction: "tools.transaction"
          outputParameters:
            - type: object
              mapping: "$."

        - name: evaluate-payment-activation
          description: >-
            Submit an ISO 20022 pain.013.001.09 creditor payment activation request
            for fraud and AML evaluation. Returns rule results and typology scores.
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "tazama-tms.evaluate-pain013-transaction"
          with:
            transaction: "tools.transaction"
          outputParameters:
            - type: object
              mapping: "$."

        - name: evaluate-interbank-transfer
          description: >-
            Submit an ISO 20022 pacs.008.001.10 FI-to-FI customer credit transfer
            for real-time fraud detection. Evaluates the transfer against all active
            typologies and returns risk assessment results.
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "tazama-tms.evaluate-pacs008-transaction"
          with:
            transaction: "tools.transaction"
          outputParameters:
            - type: object
              mapping: "$."

        - name: evaluate-payment-status
          description: >-
            Submit an ISO 20022 pacs.002.001.12 payment status report for AML
            compliance evaluation and fraud pattern analysis.
          hints:
            readOnly: false
            destructive: false
            idempotent: false
          call: "tazama-tms.evaluate-pacs002-transaction"
          with:
            transaction: "tools.transaction"
          outputParameters:
            - type: object
              mapping: "$."