naftiko: 1.0.0-alpha2
info:
  label: Sage HR Vikarina Integrations API
  description: Self-contained Naftiko capability covering the Sage HR -> Vikarina payroll bridge — job positions,
    org structure, new-starters, contracts, appointments, salaries, bank accounts, terminations, unused vacation,
    leave types, timesheets, and bonuses.
  tags:
  - Sage HR
  - Integrations
  - Vikarina
  - Payroll
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    SAGE_HR_API_KEY: SAGE_HR_API_KEY
    SAGE_HR_SUBDOMAIN: SAGE_HR_SUBDOMAIN
capability:
  consumes:
  - type: http
    namespace: sage-hr-vikarina
    baseUri: https://{{env.SAGE_HR_SUBDOMAIN}}.sage.hr/api
    description: Sage HR Vikarina-integration resource group.
    resources:
    - name: job-positions
      path: /vikarina/job-positions
      operations:
      - name: transfer-job-positions
        method: POST
        description: Transfer job positions to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: organization-structure
      path: /vikarina/organization-structure
      operations:
      - name: transfer-org-structure
        method: POST
        description: Transfer organization structure to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: newstarter-employees
      path: /vikarina/newstarter-employees
      operations:
      - name: import-new-starters
        method: POST
        description: Import new starters into Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: contract-information
      path: /vikarina/contract-information
      operations:
      - name: transfer-contracts
        method: POST
        description: Transfer contract information to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: appointments
      path: /vikarina/appointments
      operations:
      - name: transfer-appointments
        method: POST
        description: Transfer appointment information to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: salaries
      path: /vikarina/salaries
      operations:
      - name: transfer-salaries
        method: POST
        description: Transfer salary information to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: bank-accounts
      path: /vikarina/bank-accounts
      operations:
      - name: transfer-bank-accounts
        method: POST
        description: Transfer employee bank account information to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: terminated-employees
      path: /vikarina/terminated-employees
      operations:
      - name: transfer-terminations
        method: POST
        description: Transfer termination information to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: unused-days
      path: /vikarina/unused-days
      operations:
      - name: transfer-unused-days
        method: POST
        description: Transfer unused vacation days to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: leave-types
      path: /vikarina/leave-types
      operations:
      - name: transfer-leave-types
        method: POST
        description: Transfer leave-type definitions to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: timesheets
      path: /vikarina/timesheets
      operations:
      - name: transfer-timesheets
        method: POST
        description: Transfer timesheet/time-schedule information to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: bonuses
      path: /vikarina/bonuses
      operations:
      - name: transfer-bonuses
        method: POST
        description: Send bonus payouts to Vikarina.
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-Auth-Token
      value: '{{env.SAGE_HR_API_KEY}}'
      placement: header
  exposes:
  - type: mcp
    namespace: sage-hr-vikarina-mcp
    port: 9090
    transport: http
    description: MCP adapter for Sage HR Vikarina Integrations.
    tools:
    - name: sage-hr-transfer-job-positions
      description: Transfer job positions to Vikarina payroll.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: sage-hr-vikarina.transfer-job-positions