naftiko: 1.0.0-alpha2
info:
  label: Flutterwave Transfers API — Recipients
  description: Flutterwave Transfer Recipients lifecycle. 4 operations.
  tags: [Flutterwave, Transfers, Recipients]
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys: { FLUTTERWAVE_ACCESS_TOKEN: FLUTTERWAVE_ACCESS_TOKEN }
capability:
  consumes:
  - type: http
    namespace: transfers-recipients
    baseUri: https://api.flutterwave.cloud/f4b/production
    description: Flutterwave Transfer Recipients business capability.
    resources:
    - name: transfers-recipients
      path: /transfers/recipients
      operations:
      - { name: listrecipients, method: GET, description: Flutterwave List Transfer Recipients, outputRawFormat: json,
          outputParameters: [{ name: result, type: object, value: $. }] }
      - name: createrecipient
        method: POST
        description: Flutterwave Create A Transfer Recipient
        outputRawFormat: json
        outputParameters: [{ name: result, type: object, value: $. }]
        inputParameters: [{ name: body, in: body, type: object, required: true }]
    - name: transfers-recipients-id
      path: /transfers/recipients/{id}
      operations:
      - { name: getrecipient, method: GET, description: Flutterwave Retrieve A Transfer Recipient, outputRawFormat: json,
          outputParameters: [{ name: result, type: object, value: $. }] }
      - { name: deleterecipient, method: DELETE, description: Flutterwave Delete A Transfer Recipient,
          outputRawFormat: json, outputParameters: [{ name: result, type: object, value: $. }] }
    authentication: { type: bearer, value: '{{env.FLUTTERWAVE_ACCESS_TOKEN}}', placement: header }
  exposes:
  - type: rest
    namespace: transfers-recipients-rest
    port: 8080
    description: REST adapter for Flutterwave Transfer Recipients.
    resources:
    - path: /v4/transfers/recipients
      name: transfers-recipients
      operations:
      - { method: GET, name: listrecipients, description: Flutterwave List Transfer Recipients,
          call: transfers-recipients.listrecipients, outputParameters: [{ type: object, mapping: $. }] }
      - method: POST
        name: createrecipient
        description: Flutterwave Create A Transfer Recipient
        call: transfers-recipients.createrecipient
        with: { body: rest.body }
        outputParameters: [{ type: object, mapping: $. }]
    - path: /v4/transfers/recipients/{id}
      name: transfers-recipients-id
      operations:
      - { method: GET, name: getrecipient, description: Flutterwave Retrieve A Transfer Recipient,
          call: transfers-recipients.getrecipient, outputParameters: [{ type: object, mapping: $. }] }
      - { method: DELETE, name: deleterecipient, description: Flutterwave Delete A Transfer Recipient,
          call: transfers-recipients.deleterecipient, outputParameters: [{ type: object, mapping: $. }] }
  - type: mcp
    namespace: transfers-recipients-mcp
    port: 9090
    transport: http
    description: MCP adapter for Flutterwave Transfer Recipients.
    tools:
    - { name: flutterwave-list-recipients, description: Flutterwave List Transfer Recipients,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: transfers-recipients.listrecipients, outputParameters: [{ type: object, mapping: $. }] }
    - name: flutterwave-create-recipient
      description: Flutterwave Create A Transfer Recipient
      hints: { readOnly: false, destructive: false, idempotent: false }
      call: transfers-recipients.createrecipient
      with: { body: tools.body }
      outputParameters: [{ type: object, mapping: $. }]
    - { name: flutterwave-get-recipient, description: Flutterwave Retrieve A Transfer Recipient,
        hints: { readOnly: true, destructive: false, idempotent: true },
        call: transfers-recipients.getrecipient, outputParameters: [{ type: object, mapping: $. }] }
    - { name: flutterwave-delete-recipient, description: Flutterwave Delete A Transfer Recipient,
        hints: { readOnly: false, destructive: true, idempotent: true },
        call: transfers-recipients.deleterecipient, outputParameters: [{ type: object, mapping: $. }] }