Humanforce MCP by usefulapi

Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
95%
이름 품질
79%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (1)

  • LOWTool 'humanforce_list_public_holidays' name length outside 3-30 rangehumanforce_list_public_holidays에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,928토큰 (도구 정의)
~1.7 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.29%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "humanforce": {
      "url": "https://humanforce.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://humanforce.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (14)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢humanforce_list_employees(activeOnly, employeeCode, defaultLocationGuidKey, defaultDepartmentGuidKey, lastEdit, ...)

List employees with summary details (code, name, default location, department and role, active status). Humanforce API: GET /api/1.0/employees.

입력 스키마

{
  "type": "object",
  "properties": {
    "activeOnly": {
      "description": "Only active employees (true) or include terminated (false).",
      "type": "boolean"
    },
    "employeeCode": {
      "description": "Filter by employee code.",
      "type": "string"
    },
    "defaultLocationGuidKey": {
      "description": "Filter by default location GUID.",
      "type": "string"
    },
    "defaultDepartmentGuidKey": {
      "description": "Filter by default department GUID.",
      "type": "string"
    },
    "lastEdit": {
      "description": "Only records changed since this date-time (ISO 8601).",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_get_employee(guidKey, roleRevisionEffectiveDate)

Get one employee with all details (personal, employment, roles, locations and departments). Humanforce API: GET /api/1.0/employees/{guidKey}.

입력 스키마

{
  "type": "object",
  "properties": {
    "guidKey": {
      "type": "string",
      "minLength": 1,
      "description": "GUID key of the record (from a list tool)."
    },
    "roleRevisionEffectiveDate": {
      "description": "Role revision effective date (yyyy-mm-dd), if the role at a date matters.",
      "type": "string"
    }
  },
  "required": [
    "guidKey"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_locations(page, pageSize)

List locations with summary data (site names and codes). Humanforce API: GET /api/1.0/locations.

입력 스키마

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_departments(page, pageSize)

List all departments. Humanforce API: GET /api/1.0/departments.

입력 스키마

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_roles(page, pageSize)

List all roles (job roles used for rostering and pay). Humanforce API: GET /api/1.0/roles.

입력 스키마

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_shift_types(isLeaveType, page, pageSize)

List shift types, including leave types when isLeaveType is true. Humanforce API: GET /api/1.0/shiftTypes.

입력 스키마

{
  "type": "object",
  "properties": {
    "isLeaveType": {
      "description": "Only leave types (true) or only non-leave shift types (false).",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_pay_types(page, pageSize)

List all pay types used in timesheets and payruns. Humanforce API: GET /api/1.0/payTypes.

입력 스키마

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_pay_companies(page, pageSize)

List the pay companies (legal payroll entities) in this tenant. Humanforce API: GET /api/1.0/PayCompany.

입력 스키마

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_roster_items(dateMin, dateMax, employeeGuidKey, locationGuidKey, departmentGuidKey, ...)

List rostered shifts between two dates, with filters for employee, location, department and role. Humanforce API: GET /api/1.0/rosterItems.

입력 스키마

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "departmentGuidKey": {
      "description": "Filter by department GUID.",
      "type": "string"
    },
    "roleGuidKey": {
      "description": "Filter by role GUID.",
      "type": "string"
    },
    "published": {
      "description": "Only published (true) or unpublished (false) shifts.",
      "type": "boolean"
    },
    "includeDeleted": {
      "description": "Include deleted shifts.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_availability(dateMin, dateMax, employeeGuidKey, locationGuidKey, departmentGuidKey, ...)

List employee availability between two dates, optionally for one employee, location or department. Humanforce API: GET /api/1.0/availability.

입력 스키마

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "departmentGuidKey": {
      "description": "Filter by department GUID.",
      "type": "string"
    },
    "recurring": {
      "description": "Only recurring availability (true) or only one-off (false).",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_public_holidays(dateMin, dateMax, regionGuidKey, page, pageSize)

List public holidays between two dates, optionally for one region. Humanforce API: GET /api/1.0/publicHolidays.

입력 스키마

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "regionGuidKey": {
      "description": "Filter by region GUID.",
      "type": "string"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_get_clocking_status(employeeGuidKey, timezoneOffset)

Get whether an employee is clocked in or out now, in their local time. Humanforce API: GET /api/1.0/clocking/status.

입력 스키마

{
  "type": "object",
  "properties": {
    "employeeGuidKey": {
      "type": "string",
      "minLength": 1,
      "description": "Employee GUID."
    },
    "timezoneOffset": {
      "type": "integer",
      "minimum": -840,
      "maximum": 840,
      "description": "Minutes offset from UTC for local time, for example 600 for Sydney and -240 for New York."
    }
  },
  "required": [
    "employeeGuidKey",
    "timezoneOffset"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_timesheets(dateMin, dateMax, usePayDate, employeeGuidKey, locationGuidKey, ...)

List timesheets in a date range (or pay-date range), with filters for employee, location and approval. Humanforce API: GET /api/1.0/timesheets.

입력 스키마

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "usePayDate": {
      "type": "boolean",
      "description": "Filter on the pay date (true) or the shift date (false)."
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "authorised": {
      "description": "Only authorised (true) or unauthorised (false) timesheets.",
      "type": "boolean"
    },
    "rostered": {
      "description": "Only rostered (true) or unrostered (false) timesheets.",
      "type": "boolean"
    },
    "includeDeleted": {
      "description": "Include deleted timesheets.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax",
    "usePayDate"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢humanforce_list_leave_requests(dateMin, dateMax, approvedStatus, employeeGuidKey, locationGuidKey, ...)

List leave requests in a date range, optionally only approved ones or for one employee. Humanforce API: GET /api/1.0/leaveRequest.

입력 스키마

{
  "type": "object",
  "properties": {
    "dateMin": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "dateMax": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date as yyyy-mm-dd."
    },
    "approvedStatus": {
      "description": "Only approved (true) or not approved (false) requests.",
      "type": "boolean"
    },
    "employeeGuidKey": {
      "description": "Filter by employee GUID.",
      "type": "string"
    },
    "locationGuidKey": {
      "description": "Filter by location GUID.",
      "type": "string"
    },
    "deleted": {
      "description": "Only deleted (true) or not deleted (false) requests.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Results per page, 1 to 500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "dateMin",
    "dateMax"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 14개