naftiko: 1.0.0-alpha2
info:
  label: Remote Benefits API — Benefits
  description: 'Self-contained Naftiko capability for browsing localized benefit offers, applying them to employments, and responding to benefit-renewal requests.'
  tags:
  - Remote
  - Benefits
  - Renewals
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    REMOTE_ACCESS_TOKEN: REMOTE_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: benefits
    baseUri: https://gateway.remote.com
    description: Remote Benefits business capability.
    resources:
    - name: v1-benefit-offers
      path: /v1/benefit_offers
      operations:
      - name: listbenefitoffers
        method: GET
        description: List Benefit Offers
        inputParameters:
        - name: country_code
          in: query
          type: string
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-benefit-offers-employment
      path: /v1/benefit_offers/{employment_id}
      operations:
      - name: getemploymentbenefitoffers
        method: GET
        description: Get Employment Benefit Offers
        inputParameters:
        - name: employment_id
          in: path
          type: string
          required: true
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: upsertemploymentbenefitoffers
        method: PUT
        description: Upsert Employment Benefit Offers
        inputParameters:
        - name: employment_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-renewal-requests
      path: /v1/benefit_renewal_requests
      operations:
      - name: listrenewalrequests
        method: GET
        description: List Benefit Renewal Requests
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      value: '{{env.REMOTE_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: benefits-mcp
    port: 9090
    transport: http
    description: MCP adapter for Remote Benefits.
    tools:
    - name: remote-list-benefit-offers
      description: List benefit offers, optionally filtered by country.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: benefits.listbenefitoffers
      with:
        country_code: tools.country_code
    - name: remote-get-employment-benefits
      description: Get the benefit offers applicable to an employment.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: benefits.getemploymentbenefitoffers
      with:
        employment_id: tools.employment_id
    - name: remote-upsert-employment-benefits
      description: Apply / change the benefit selection for an employment.
      hints: { readOnly: false, destructive: false, idempotent: true }
      call: benefits.upsertemploymentbenefitoffers
      with:
        employment_id: tools.employment_id
        body: tools.body
    - name: remote-list-benefit-renewal-requests
      description: List pending and completed benefit-renewal requests.
      hints: { readOnly: true, destructive: false, idempotent: true }
      call: benefits.listrenewalrequests