naftiko: 1.0.0-alpha2
info:
  label: HR Partner — Employees
  description: 'HR Partner — Employees. 3 operations covering listing, retrieving, and upserting employee records via the HR Partner REST API.'
  tags:
    - HR Partner
    - Employees
    - HRIS
  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-employees
      baseUri: https://api.hrpartner.io
      description: HR Partner Employees business capability.
      resources:
        - name: employees
          path: /employees
          operations:
            - name: listEmployees
              method: GET
              description: List Employees
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: array
                  value: $.
        - name: employee
          path: /employee/{employeeCode}
          operations:
            - name: getEmployee
              method: GET
              description: Get Employee
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
            - name: upsertEmployee
              method: POST
              description: Create Or Update Employee
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: header
        header: x-api-key
        value: '{{env.HR_PARTNER_API_KEY}}'
  exposes:
    - type: rest
      namespace: hr-partner-employees-rest
      port: 8080
      description: REST adapter for HR Partner Employees.
      resources:
        - path: /v1/employees
          name: employees
          description: REST surface for employees.
          operations:
            - method: GET
              name: listEmployees
              description: List Employees
              call: hr-partner-employees.listEmployees
              outputParameters:
                - type: array
                  mapping: $.
        - path: /v1/employee/{employeeCode}
          name: employee
          description: REST surface for a single employee.
          operations:
            - method: GET
              name: getEmployee
              description: Get Employee
              call: hr-partner-employees.getEmployee
              outputParameters:
                - type: object
                  mapping: $.
            - method: POST
              name: upsertEmployee
              description: Create Or Update Employee
              call: hr-partner-employees.upsertEmployee
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: hr-partner-employees-mcp
      port: 9090
      transport: http
      description: MCP adapter for HR Partner Employees.
      tools:
        - name: list_employees
          description: List employees in the HR Partner account.
          call: hr-partner-employees.listEmployees
        - name: get_employee
          description: Retrieve a single employee by code.
          call: hr-partner-employees.getEmployee
        - name: upsert_employee
          description: Create or update an employee by code.
          call: hr-partner-employees.upsertEmployee