HR Partner — Recruitment

naftiko: 1.0.0-alpha2
info:
  label: HR Partner — Recruitment
  description: 'HR Partner — Recruitment. Job listings, applicants, applications, and application-stage tracking.'
  tags:
    - HR Partner
    - Recruitment
    - Applicant Tracking
  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-recruitment
      baseUri: https://api.hrpartner.io
      description: HR Partner Recruitment business capability.
      resources:
        - name: job-listings
          path: /job-listings
          operations:
            - { name: listJobListings, method: GET, description: List Job Listings, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
        - name: job-listing
          path: /job-listings/{id}
          operations:
            - { name: getJobListing, method: GET, description: Get Job Listing, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
        - name: applicants
          path: /applicants
          operations:
            - { name: listApplicants, method: GET, description: List Applicants, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
            - { name: createApplicant, method: POST, description: Create Applicant, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
        - name: applicant
          path: /applicants/{id}
          operations:
            - { name: getApplicant, method: GET, description: Get Applicant, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
            - { name: updateApplicant, method: POST, description: Update Applicant, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
        - name: applications
          path: /applications
          operations:
            - { name: listApplications, method: GET, description: List Applications, outputRawFormat: json, outputParameters: [{ name: result, type: array, value: '$.' }] }
            - { name: createApplication, method: POST, description: Create Application, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
        - name: application
          path: /applications/{id}
          operations:
            - { name: getApplication, method: GET, description: Get Application, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
            - { name: updateApplication, method: POST, description: Update Application, outputRawFormat: json, outputParameters: [{ name: result, type: object, value: '$.' }] }
        - name: application-stage-tracking
          path: /application-stage-tracking
          operations:
            - { name: listApplicationStageTracking, method: GET, description: List Application Stage Tracking, 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-recruitment-mcp
      port: 9090
      transport: http
      description: MCP adapter for HR Partner Recruitment.
      tools:
        - { name: list_job_listings, description: List open job listings, call: hr-partner-recruitment.listJobListings }
        - { name: get_job_listing, description: Retrieve a single job listing, call: hr-partner-recruitment.getJobListing }
        - { name: list_applicants, description: List applicants, call: hr-partner-recruitment.listApplicants }
        - { name: create_applicant, description: Create a new applicant, call: hr-partner-recruitment.createApplicant }
        - { name: get_applicant, description: Get an applicant by id, call: hr-partner-recruitment.getApplicant }
        - { name: update_applicant, description: Update an applicant by id, call: hr-partner-recruitment.updateApplicant }
        - { name: list_applications, description: List job applications, call: hr-partner-recruitment.listApplications }
        - { name: create_application, description: Create a job application, call: hr-partner-recruitment.createApplication }
        - { name: get_application, description: Get an application by id, call: hr-partner-recruitment.getApplication }
        - { name: update_application, description: Update an application by id, call: hr-partner-recruitment.updateApplication }
        - { name: list_application_stage_tracking, description: List application stage history, call: hr-partner-recruitment.listApplicationStageTracking }