Humanforce MCP by usefulapi
Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen humanforce_list_public_holidays
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"humanforce": {
"url": "https://humanforce.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://humanforce.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia