Workday Advanced Compensation Management

naftiko: "1.0.0-alpha1"

info:
  label: "Workday Advanced Compensation Management"
  description: "Unified capability for HR compensation teams managing Workday Advanced Compensation including compensation plans, merit increases, bonus plans, equity awards, budgets, review cycles, and individual employee compensation packages."
  tags:
    - Advanced Compensation
    - Benefits
    - Enterprise
    - HCM
    - HR
    - Workday
  created: "2026-05-03"
  modified: "2026-05-03"

binds:
  - namespace: env
    keys:
      WORKDAY_CLIENT_ID: WORKDAY_CLIENT_ID
      WORKDAY_CLIENT_SECRET: WORKDAY_CLIENT_SECRET
      WORKDAY_TENANT: WORKDAY_TENANT

capability:
  consumes:
    - import: workday-advanced-compensation
      location: ./shared/advanced-compensation.yaml

  exposes:
    - type: rest
      port: 8080
      namespace: workday-compensation-management-api
      description: "Unified REST API for Workday Advanced Compensation management workflows."
      resources:
        - path: /v1/compensation-plans
          name: compensation-plans
          description: "Compensation plans"
          operations:
            - method: GET
              name: list-compensation-plans
              description: "List compensation plans"
              call: "workday-advanced-compensation.list-compensation-plans"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: POST
              name: create-compensation-plan
              description: "Create a new compensation plan"
              call: "workday-advanced-compensation.create-compensation-plan"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/compensation-plans/{planId}
          name: compensation-plan-by-id
          description: "Single compensation plan"
          operations:
            - method: GET
              name: get-compensation-plan
              description: "Get a compensation plan"
              call: "workday-advanced-compensation.get-compensation-plan"
              with:
                planId: "rest.planId"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/compensation-grades
          name: compensation-grades
          description: "Compensation grades"
          operations:
            - method: GET
              name: list-compensation-grades
              description: "List compensation grades"
              call: "workday-advanced-compensation.list-compensation-grades"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/merit-plans
          name: merit-plans
          description: "Merit plans"
          operations:
            - method: GET
              name: list-merit-plans
              description: "List merit plans"
              call: "workday-advanced-compensation.list-merit-plans"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/bonus-plans
          name: bonus-plans
          description: "Bonus plans"
          operations:
            - method: GET
              name: list-bonus-plans
              description: "List bonus plans"
              call: "workday-advanced-compensation.list-bonus-plans"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/stock-plans
          name: stock-plans
          description: "Stock plans"
          operations:
            - method: GET
              name: list-stock-plans
              description: "List stock plans"
              call: "workday-advanced-compensation.list-stock-plans"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/compensation-budgets
          name: compensation-budgets
          description: "Compensation budgets"
          operations:
            - method: GET
              name: list-compensation-budgets
              description: "List compensation budgets"
              call: "workday-advanced-compensation.list-compensation-budgets"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/compensation-reviews
          name: compensation-reviews
          description: "Compensation reviews"
          operations:
            - method: GET
              name: list-compensation-reviews
              description: "List compensation reviews"
              call: "workday-advanced-compensation.list-compensation-reviews"
              outputParameters:
                - type: object
                  mapping: "$."
        - path: /v1/employees/{employeeId}/compensation
          name: employee-compensation
          description: "Employee compensation"
          operations:
            - method: GET
              name: get-employee-compensation
              description: "Get employee compensation"
              call: "workday-advanced-compensation.get-employee-compensation"
              with:
                employeeId: "rest.employeeId"
              outputParameters:
                - type: object
                  mapping: "$."
            - method: PUT
              name: update-employee-compensation
              description: "Update employee compensation"
              call: "workday-advanced-compensation.update-employee-compensation"
              with:
                employeeId: "rest.employeeId"
              outputParameters:
                - type: object
                  mapping: "$."

    - type: mcp
      port: 9080
      namespace: workday-compensation-management-mcp
      transport: http
      description: "MCP server for AI-assisted Workday Advanced Compensation management, plan operations, and compensation analytics."
      tools:
        - name: list-compensation-plans
          description: "List Workday compensation plans with optional filtering by type or status"
          hints:
            readOnly: true
            openWorld: true
          call: "workday-advanced-compensation.list-compensation-plans"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-compensation-plan
          description: "Get a specific Workday compensation plan by ID"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.get-compensation-plan"
          with:
            planId: "tools.planId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: create-compensation-plan
          description: "Create a new Workday compensation plan"
          hints:
            readOnly: false
          call: "workday-advanced-compensation.create-compensation-plan"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-compensation-grades
          description: "List Workday compensation grades and their pay ranges"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.list-compensation-grades"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-compensation-grade
          description: "Get a specific Workday compensation grade with pay range details"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.get-compensation-grade"
          with:
            gradeId: "tools.gradeId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-merit-plans
          description: "List Workday merit increase plans and guidelines"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.list-merit-plans"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-bonus-plans
          description: "List Workday bonus and incentive compensation plans"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.list-bonus-plans"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-stock-plans
          description: "List Workday equity and stock compensation plans"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.list-stock-plans"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-compensation-budgets
          description: "List Workday compensation budgets and track allocations"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.list-compensation-budgets"
          outputParameters:
            - type: object
              mapping: "$."
        - name: list-compensation-reviews
          description: "List Workday compensation review cycles and their status"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.list-compensation-reviews"
          outputParameters:
            - type: object
              mapping: "$."
        - name: get-employee-compensation
          description: "Get an employee's current compensation package including base pay, bonuses, and equity"
          hints:
            readOnly: true
          call: "workday-advanced-compensation.get-employee-compensation"
          with:
            employeeId: "tools.employeeId"
          outputParameters:
            - type: object
              mapping: "$."
        - name: update-employee-compensation
          description: "Update an employee's compensation including merit increases or off-cycle adjustments"
          hints:
            readOnly: false
          call: "workday-advanced-compensation.update-employee-compensation"
          with:
            employeeId: "tools.employeeId"
          outputParameters:
            - type: object
              mapping: "$."