HR Partner — Employee Records

naftiko: 1.0.0-alpha2
info:
  label: HR Partner — Employee Records
  description: 'HR Partner — Employee Records. Aggregates supporting employee sub-modules (contacts, addresses, notes, education, skills, training, assets, benefits, dependents, grievances, positions, renewables, attachments) into one Naftiko capability.'
  tags:
    - HR Partner
    - Employees
    - Records
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      HR_PARTNER_API_KEY: HR_PARTNER_API_KEY
capability:
  consumes:
    - type: http
      namespace: hr-partner-employee-records
      baseUri: https://api.hrpartner.io
      description: HR Partner Employee Records business capability.
      resources:
        - name: contacts
          path: /contacts
          operations:
            - { name: listContacts, method: GET, description: List Contacts, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: addresses
          path: /addresses
          operations:
            - { name: listAddresses, method: GET, description: List Addresses, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: notes
          path: /notes
          operations:
            - { name: listNotes, method: GET, description: List Notes, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: education
          path: /education
          operations:
            - { name: listEducation, method: GET, description: List Education Records, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: skills
          path: /skills
          operations:
            - { name: listSkills, method: GET, description: List Skills, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: training
          path: /training
          operations:
            - { name: listTraining, method: GET, description: List Training Records, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: assets
          path: /assets
          operations:
            - { name: listAssets, method: GET, description: List Assets, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: benefits
          path: /benefits
          operations:
            - { name: listBenefits, method: GET, description: List Benefits, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: dependents
          path: /dependents
          operations:
            - { name: listDependents, method: GET, description: List Dependents, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: grievances
          path: /grievances
          operations:
            - { name: listGrievances, method: GET, description: List Grievances, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: positions
          path: /positions
          operations:
            - { name: listPositions, method: GET, description: List Positions, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: renewables
          path: /renewables
          operations:
            - { name: listRenewables, method: GET, description: List Renewables, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: attachments
          path: /attachments
          operations:
            - { name: listAttachments, method: GET, description: List Attachments, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
      authentication:
        type: header
        header: x-api-key
        value: '{{env.HR_PARTNER_API_KEY}}'
  exposes:
    - type: mcp
      namespace: hr-partner-employee-records-mcp
      port: 9090
      transport: http
      description: MCP adapter for HR Partner Employee Records.
      tools:
        - { name: list_contacts, description: List employee contacts, call: hr-partner-employee-records.listContacts }
        - { name: list_addresses, description: List employee addresses, call: hr-partner-employee-records.listAddresses }
        - { name: list_notes, description: List internal HR notes, call: hr-partner-employee-records.listNotes }
        - { name: list_education, description: List employee education records, call: hr-partner-employee-records.listEducation }
        - { name: list_skills, description: List employee skills, call: hr-partner-employee-records.listSkills }
        - { name: list_training, description: List employee training records, call: hr-partner-employee-records.listTraining }
        - { name: list_assets, description: List company assets issued to employees, call: hr-partner-employee-records.listAssets }
        - { name: list_benefits, description: List employee benefit assignments, call: hr-partner-employee-records.listBenefits }
        - { name: list_dependents, description: List employee dependents, call: hr-partner-employee-records.listDependents }
        - { name: list_grievances, description: List employee grievances, call: hr-partner-employee-records.listGrievances }
        - { name: list_positions, description: List employee position history, call: hr-partner-employee-records.listPositions }
        - { name: list_renewables, description: List renewable items (certifications, licenses), call: hr-partner-employee-records.listRenewables }
        - { name: list_attachments, description: List attachments across modules, call: hr-partner-employee-records.listAttachments }