naftiko: 1.0.0-alpha2
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-06'
binds:
- namespace: env
  keys:
    WORKDAY_CLIENT_ID: WORKDAY_CLIENT_ID
    WORKDAY_CLIENT_SECRET: WORKDAY_CLIENT_SECRET
    WORKDAY_TENANT: WORKDAY_TENANT
capability:
  consumes:
  - openapi: workday-advanced-compensation
    location: ../../openapi/workday-advanced-compensation-openapi.yml
  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: $.