Shift4 Fraud and Dispute Operations

naftiko: 1.0.0-alpha2
info:
  label: Shift4 Fraud and Dispute Operations
  description: Fraud-prevention and dispute-management workflows on Shift4. Combines blacklist rules, fraud warnings, and
    chargeback disputes for risk and operations teams.
  tags:
  - Shift4
  - Fraud
  - Disputes
  - Risk
  - Operations
  created: '2026-05-05'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    SHIFT4_API_KEY: SHIFT4_API_KEY
capability:
  consumes:
  - type: http
    namespace: shift4-disputes
    baseUri: https://api.shift4.com
    authentication:
      type: basic
      username: '{{SHIFT4_API_KEY}}'
      password: ''
    resources:
    - name: disputes
      path: /disputes
      operations:
      - name: list-disputes
        method: GET
        description: List disputes.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: dispute
      path: /disputes/{dispute}
      operations:
      - name: get-dispute
        method: GET
        description: Retrieve a dispute by ID.
        inputParameters:
        - name: dispute
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: fraud-warnings
      path: /fraud-warnings
      operations:
      - name: list-fraud-warnings
        method: GET
        description: List fraud warnings.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: mcp
    port: 9082
    namespace: shift4-fraud-disputes-mcp
    transport: http
    description: MCP surface for Shift4 fraud and dispute workflows.
    tools:
    - name: list-disputes
      description: List Shift4 disputes (chargebacks).
      hints:
        readOnly: true
      call: shift4-disputes.list-disputes
      outputParameters:
      - type: object
        mapping: $.
    - name: get-dispute
      description: Retrieve a Shift4 dispute by ID.
      hints:
        readOnly: true
      call: shift4-disputes.get-dispute
      with:
        dispute: tools.dispute
      outputParameters:
      - type: object
        mapping: $.
    - name: list-fraud-warnings
      description: List Shift4 fraud warnings.
      hints:
        readOnly: true
      call: shift4-disputes.list-fraud-warnings
      outputParameters:
      - type: object
        mapping: $.