Humanforce MCP by usefulapi
Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWhumanforce_list_public_holidays에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거