naftiko: 1.0.0-alpha2
info:
  label: Flutterwave Settlements API — Settlements
  description: Flutterwave Settlements inspection. 2 operations.
  tags: [Flutterwave, Settlements, Reconciliation]
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys: { FLUTTERWAVE_ACCESS_TOKEN: FLUTTERWAVE_ACCESS_TOKEN }
capability:
  consumes:
  - type: http
    namespace: settlements-settlements
    baseUri: https://api.flutterwave.cloud/f4b/production
    description: Flutterwave Settlements business capability.
    resources:
    - name: settlements
      path: /settlements
      operations:
      - { name: listsettlements, method: GET, description: Flutterwave List Settlements, outputRawFormat: json,
          outputParameters: [{ name: result, type: object, value: $. }] }
    - name: settlements-id
      path: /settlements/{id}
      operations:
      - { name: getsettlement, method: GET, description: Flutterwave Retrieve A Settlement, outputRawFormat: json,
          outputParameters: [{ name: result, type: object, value: $. }] }
    authentication: { type: bearer, value: '{{env.FLUTTERWAVE_ACCESS_TOKEN}}', placement: header }
  exposes:
  - type: rest
    namespace: settlements-settlements-rest
    port: 8080
    description: REST adapter for Flutterwave Settlements.
    resources:
    - path: /v4/settlements
      name: settlements
      operations:
      - { method: GET, name: listsettlements, description: Flutterwave List Settlements,
          call: settlements-settlements.listsettlements, outputParameters: [{ type: object, mapping: $. }] }
    - path: /v4/settlements/{id}
      name: settlements-id
      operations:
      - { method: GET, name: getsettlement, description: Flutterwave Retrieve A Settlement,
          call: settlements-settlements.getsettlement, outputParameters: [{ type: object, mapping: $. }] }
  - type: mcp
    namespace: settlements-settlements-mcp
    port: 9090
    transport: http
    description: MCP adapter for Flutterwave Settlements.
    tools:
    - { name: flutterwave-list-settlements, description: Flutterwave List Settlements,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: settlements-settlements.listsettlements, outputParameters: [{ type: object, mapping: $. }] }
    - { name: flutterwave-get-settlement, description: Flutterwave Retrieve A Settlement,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: settlements-settlements.getsettlement, outputParameters: [{ type: object, mapping: $. }] }