naftiko: 1.0.0-alpha2
info:
  label: Unum Benefits Administration
  description: Workflow capability for Unum benefits administration, combining eligibility management, enrollment processing,
    EOI handling, leave management, and billing operations. Designed for HR administrators, benefits coordinators, and HR
    technology integration partners who manage employee benefits lifecycle from onboarding through termination.
  tags:
  - Unum
  - Benefits Administration
  - HR Integration
  - Insurance
  - Leave Management
  - Eligibility
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    UNUM_CLIENT_ID: UNUM_CLIENT_ID
    UNUM_CLIENT_SECRET: UNUM_CLIENT_SECRET
capability:
  consumes:
  - type: http
    namespace: unum-hr-connect
    baseUri: https://api.unum.com/v1
    description: Unum HR Connect REST API for benefits integration
    authentication:
      type: bearer
      token: '{{UNUM_ACCESS_TOKEN}}'
    resources:
    - name: eligibility-members
      path: /eligibility/members
      description: Member eligibility management
      operations:
      - name: list-eligible-members
        method: GET
        description: Retrieve eligible members for an employer group
        inputParameters:
        - name: groupId
          in: query
          type: string
          required: true
          description: Employer group identifier
        - name: effectiveDate
          in: query
          type: string
          required: false
          description: Effective date for eligibility check
        - name: page
          in: query
          type: integer
          required: false
          description: Page number
        - name: limit
          in: query
          type: integer
          required: false
          description: Records per page
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submit-member-eligibility
        method: POST
        description: Submit or update member eligibility
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            groupId: '{{tools.groupId}}'
            firstName: '{{tools.firstName}}'
            lastName: '{{tools.lastName}}'
            dateOfBirth: '{{tools.dateOfBirth}}'
            employeeId: '{{tools.employeeId}}'
            hireDate: '{{tools.hireDate}}'
            employmentStatus: '{{tools.employmentStatus}}'
            effectiveDate: '{{tools.effectiveDate}}'
    - name: eligibility-member
      path: /eligibility/members/{memberId}
      description: Individual member eligibility operations
      operations:
      - name: get-member-eligibility
        method: GET
        description: Get eligibility details for a specific member
        inputParameters:
        - name: memberId
          in: path
          type: string
          required: true
          description: Unique member identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: update-member-eligibility
        method: PUT
        description: Update eligibility for an existing member
        inputParameters:
        - name: memberId
          in: path
          type: string
          required: true
          description: Unique member identifier
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            employmentStatus: '{{tools.employmentStatus}}'
            effectiveDate: '{{tools.effectiveDate}}'
      - name: terminate-member-eligibility
        method: DELETE
        description: Terminate eligibility for a member
        inputParameters:
        - name: memberId
          in: path
          type: string
          required: true
          description: Unique member identifier
        - name: terminationDate
          in: query
          type: string
          required: true
          description: Effective termination date
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: enrollment-elections
      path: /enrollment/elections
      description: Benefits enrollment elections
      operations:
      - name: list-enrollment-elections
        method: GET
        description: List benefit enrollment elections for a group
        inputParameters:
        - name: groupId
          in: query
          type: string
          required: true
          description: Employer group identifier
        - name: planYear
          in: query
          type: integer
          required: false
          description: Plan year filter
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submit-enrollment-election
        method: POST
        description: Submit a new benefit enrollment election
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            memberId: '{{tools.memberId}}'
            groupId: '{{tools.groupId}}'
            planYear: '{{tools.planYear}}'
            elections: '{{tools.elections}}'
    - name: leave-requests
      path: /leave/requests
      description: Leave and absence request management
      operations:
      - name: list-leave-requests
        method: GET
        description: List leave requests for a group
        inputParameters:
        - name: groupId
          in: query
          type: string
          required: true
          description: Employer group identifier
        - name: memberId
          in: query
          type: string
          required: false
          description: Filter by member
        - name: status
          in: query
          type: string
          required: false
          description: Filter by status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submit-leave-request
        method: POST
        description: Submit a new leave request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            memberId: '{{tools.memberId}}'
            groupId: '{{tools.groupId}}'
            leaveType: '{{tools.leaveType}}'
            startDate: '{{tools.startDate}}'
            endDate: '{{tools.endDate}}'
    - name: eoi-submissions
      path: /eoi/submissions
      description: Evidence of insurability submissions
      operations:
      - name: list-eoi-submissions
        method: GET
        description: List EOI submissions for a group
        inputParameters:
        - name: groupId
          in: query
          type: string
          required: true
          description: Employer group identifier
        - name: status
          in: query
          type: string
          required: false
          description: Filter by submission status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: submit-eoi
        method: POST
        description: Submit a new EOI application
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            memberId: '{{tools.memberId}}'
            groupId: '{{tools.groupId}}'
            productType: '{{tools.productType}}'
            requestedBenefitAmount: '{{tools.requestedBenefitAmount}}'
    - name: billing-invoices
      path: /billing/invoices
      description: Premium billing invoice management
      operations:
      - name: list-billing-invoices
        method: GET
        description: List billing invoices for an employer group
        inputParameters:
        - name: groupId
          in: query
          type: string
          required: true
          description: Employer group identifier
        - name: startDate
          in: query
          type: string
          required: false
          description: Filter from date
        - name: endDate
          in: query
          type: string
          required: false
          description: Filter to date
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: unum-benefits-api
    description: Unified REST API for Unum benefits administration workflows.
    resources:
    - path: /v1/members
      name: members
      description: Member eligibility management
      operations:
      - method: GET
        name: list-members
        description: List eligible members for an employer group
        call: unum-hr-connect.list-eligible-members
        with:
          groupId: rest.groupId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-member
        description: Submit member eligibility information
        call: unum-hr-connect.submit-member-eligibility
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/members/{memberId}
      name: member
      description: Individual member operations
      operations:
      - method: GET
        name: get-member
        description: Get eligibility details for a member
        call: unum-hr-connect.get-member-eligibility
        with:
          memberId: rest.memberId
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: update-member
        description: Update eligibility for a member
        call: unum-hr-connect.update-member-eligibility
        with:
          memberId: rest.memberId
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: terminate-member
        description: Terminate member eligibility
        call: unum-hr-connect.terminate-member-eligibility
        with:
          memberId: rest.memberId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/enrollments
      name: enrollments
      description: Benefit enrollment elections
      operations:
      - method: GET
        name: list-enrollments
        description: List enrollment elections for a group
        call: unum-hr-connect.list-enrollment-elections
        with:
          groupId: rest.groupId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-enrollment
        description: Submit a new enrollment election
        call: unum-hr-connect.submit-enrollment-election
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/leave-requests
      name: leave-requests
      description: Leave and absence requests
      operations:
      - method: GET
        name: list-leave-requests
        description: List leave requests for a group
        call: unum-hr-connect.list-leave-requests
        with:
          groupId: rest.groupId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-leave-request
        description: Submit a new leave request
        call: unum-hr-connect.submit-leave-request
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/leave-requests/{requestId}
      name: leave-request
      description: Individual leave request operations
      operations:
      - method: GET
        name: get-leave-request
        description: Get leave request details
        call: unum-hr-connect.get-leave-request
        with:
          requestId: rest.requestId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/eoi-submissions
      name: eoi-submissions
      description: Evidence of insurability submissions
      operations:
      - method: GET
        name: list-eoi-submissions
        description: List EOI submissions for a group
        call: unum-hr-connect.list-eoi-submissions
        with:
          groupId: rest.groupId
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-eoi-submission
        description: Submit a new EOI application
        call: unum-hr-connect.submit-eoi
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/eoi-submissions/{submissionId}
      name: eoi-submission
      description: Individual EOI submission
      operations:
      - method: GET
        name: get-eoi-submission
        description: Get EOI submission status and details
        call: unum-hr-connect.get-eoi-submission
        with:
          submissionId: rest.submissionId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/billing-invoices
      name: billing-invoices
      description: Premium billing invoices
      operations:
      - method: GET
        name: list-billing-invoices
        description: List billing invoices for an employer group
        call: unum-hr-connect.list-billing-invoices
        with:
          groupId: rest.groupId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/billing-invoices/{invoiceId}
      name: billing-invoice
      description: Individual billing invoice
      operations:
      - method: GET
        name: get-billing-invoice
        description: Get billing invoice details
        call: unum-hr-connect.get-billing-invoice
        with:
          invoiceId: rest.invoiceId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: unum-benefits-mcp
    transport: http
    description: MCP server for AI-assisted Unum benefits administration workflows.
    tools:
    - name: list-members
      description: List eligible members for an employer group
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.list-eligible-members
      with:
        groupId: tools.groupId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-member
      description: Get eligibility details for a specific member
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.get-member-eligibility
      with:
        memberId: tools.memberId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-member
      description: Submit new member eligibility to Unum
      hints:
        readOnly: false
        openWorld: false
      call: unum-hr-connect.submit-member-eligibility
      outputParameters:
      - type: object
        mapping: $.
    - name: update-member
      description: Update existing member eligibility information
      hints:
        readOnly: false
        idempotent: true
      call: unum-hr-connect.update-member-eligibility
      with:
        memberId: tools.memberId
      outputParameters:
      - type: object
        mapping: $.
    - name: terminate-member
      description: Terminate eligibility for a member
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: unum-hr-connect.terminate-member-eligibility
      with:
        memberId: tools.memberId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-enrollments
      description: List benefit enrollment elections for a group
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.list-enrollment-elections
      with:
        groupId: tools.groupId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-enrollment
      description: Submit a new benefit enrollment election for a member
      hints:
        readOnly: false
        openWorld: false
      call: unum-hr-connect.submit-enrollment-election
      outputParameters:
      - type: object
        mapping: $.
    - name: list-leave-requests
      description: List leave and absence requests for a group
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.list-leave-requests
      with:
        groupId: tools.groupId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-leave-request
      description: Submit a new leave or absence request for a member
      hints:
        readOnly: false
        openWorld: false
      call: unum-hr-connect.submit-leave-request
      outputParameters:
      - type: object
        mapping: $.
    - name: get-leave-request
      description: Get details and status of a leave request
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.get-leave-request
      with:
        requestId: tools.requestId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-eoi-submissions
      description: List evidence of insurability submissions for a group
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.list-eoi-submissions
      with:
        groupId: tools.groupId
      outputParameters:
      - type: object
        mapping: $.
    - name: create-eoi-submission
      description: Submit a new evidence of insurability application
      hints:
        readOnly: false
        openWorld: false
      call: unum-hr-connect.submit-eoi
      outputParameters:
      - type: object
        mapping: $.
    - name: get-eoi-submission
      description: Get status and decision for an EOI submission
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.get-eoi-submission
      with:
        submissionId: tools.submissionId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-billing-invoices
      description: List premium billing invoices for an employer group
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.list-billing-invoices
      with:
        groupId: tools.groupId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-billing-invoice
      description: Get premium billing invoice details
      hints:
        readOnly: true
        openWorld: false
      call: unum-hr-connect.get-billing-invoice
      with:
        invoiceId: tools.invoiceId
      outputParameters:
      - type: object
        mapping: $.