naftiko: 1.0.0-alpha2
info:
  label: Justworks Time Off API — Balances, Policies, Requests
  description: 'Justworks Time Off API. 5 operations. Lead operation: Justworks Create Time Off Balances Report. Asynchronous balance reporting plus policy and request reads.'
  tags:
  - Justworks
  - Time Off
  - Leave
  - PTO
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    JUSTWORKS_ACCESS_TOKEN: JUSTWORKS_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: time-off
    baseUri: https://public-api.justworks.com
    description: Justworks Time Off API business capability.
    resources:
    - name: v1-time-off-balances
      path: /v1/time-off/balances
      operations:
      - name: createtimeoffbalancesreport
        method: POST
        description: Justworks Create Time Off Balances Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-time-off-balances-report_id
      path: /v1/time-off/balances/{report_id}
      operations:
      - name: gettimeoffbalancesreport
        method: GET
        description: Justworks Get Time Off Balances Report
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-time-off-policies
      path: /v1/time-off/policies
      operations:
      - name: listtimeoffpolicies
        method: GET
        description: Justworks List Time Off Policies
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-time-off-requests
      path: /v1/time-off/requests
      operations:
      - name: listtimeoffrequests
        method: GET
        description: Justworks List Time Off Requests
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      key: Authorization
      value: 'Bearer {{env.JUSTWORKS_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: mcp
    namespace: time-off-mcp
    port: 9090
    transport: http
    description: MCP adapter for Justworks Time Off API.
    tools:
    - name: justworks-create-time-off-balances-report
      description: Justworks Create Time Off Balances Report
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: time-off.createtimeoffbalancesreport
      outputParameters:
      - type: object
        mapping: $.
    - name: justworks-get-time-off-balances-report
      description: Justworks Get Time Off Balances Report
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: time-off.gettimeoffbalancesreport
      outputParameters:
      - type: object
        mapping: $.
    - name: justworks-list-time-off-policies
      description: Justworks List Time Off Policies
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: time-off.listtimeoffpolicies
      outputParameters:
      - type: object
        mapping: $.
    - name: justworks-list-time-off-requests
      description: Justworks List Time Off Requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: time-off.listtimeoffrequests
      outputParameters:
      - type: object
        mapping: $.