Humanforce MCP by usefulapi is an MCP server published by io.usefulapi, hosted at humanforce.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including humanforce_list_employees, humanforce_get_employee, humanforce_list_locations, humanforce_list_departments, humanforce_list_roles.
Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.
4,014 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List employees with summary details (code, name, default location, department and role, active status). Humanforce API: GET /api/1.0/employees.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| lastEdit | string | Only records changed since this date-time (ISO 8601). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| activeOnly | boolean | Only active employees (true) or include terminated (false). |
| employeeCode | string | Filter by employee code. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| defaultLocationGuidKey | string | Filter by default location GUID. |
| defaultDepartmentGuidKey | string | Filter by default department GUID. |
{
"name": "humanforce_list_employees",
"title": "List employees",
"description": "List employees with summary details (code, name, default location, department and role, active status). Humanforce API: GET /api/1.0/employees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"lastEdit": {
"type": "string",
"description": "Only records changed since this date-time (ISO 8601)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"activeOnly": {
"type": "boolean",
"description": "Only active employees (true) or include terminated (false)."
},
"employeeCode": {
"type": "string",
"description": "Filter by employee code."
},
"defaultLocationGuidKey": {
"type": "string",
"description": "Filter by default location GUID."
},
"defaultDepartmentGuidKey": {
"type": "string",
"description": "Filter by default department GUID."
}
}
},
"annotations": {
"title": "List employees",
"readOnlyHint": true
}
}Get one employee with all details (personal, employment, roles, locations and departments). Humanforce API: GET /api/1.0/employees/{guidKey}.
| Parameter | Type | Description |
|---|---|---|
| guidKey * | string | GUID key of the record (from a list tool). |
| roleRevisionEffectiveDate | string | Role revision effective date (yyyy-mm-dd), if the role at a date matters. |
{
"name": "humanforce_get_employee",
"title": "Get an employee",
"description": "Get one employee with all details (personal, employment, roles, locations and departments). Humanforce API: GET /api/1.0/employees/{guidKey}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"guidKey"
],
"properties": {
"guidKey": {
"type": "string",
"minLength": 1,
"description": "GUID key of the record (from a list tool)."
},
"roleRevisionEffectiveDate": {
"type": "string",
"description": "Role revision effective date (yyyy-mm-dd), if the role at a date matters."
}
}
},
"annotations": {
"title": "Get an employee",
"readOnlyHint": true
}
}List locations with summary data (site names and codes). Humanforce API: GET /api/1.0/locations.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
{
"name": "humanforce_list_locations",
"title": "List locations",
"description": "List locations with summary data (site names and codes). Humanforce API: GET /api/1.0/locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
}
}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true
}
}List all departments. Humanforce API: GET /api/1.0/departments.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
{
"name": "humanforce_list_departments",
"title": "List departments",
"description": "List all departments. Humanforce API: GET /api/1.0/departments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
}
}
},
"annotations": {
"title": "List departments",
"readOnlyHint": true
}
}List all roles (job roles used for rostering and pay). Humanforce API: GET /api/1.0/roles.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
{
"name": "humanforce_list_roles",
"title": "List roles",
"description": "List all roles (job roles used for rostering and pay). Humanforce API: GET /api/1.0/roles.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
}
}
},
"annotations": {
"title": "List roles",
"readOnlyHint": true
}
}List shift types, including leave types when isLeaveType is true. Humanforce API: GET /api/1.0/shiftTypes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| isLeaveType | boolean | Only leave types (true) or only non-leave shift types (false). |
{
"name": "humanforce_list_shift_types",
"title": "List shift types",
"description": "List shift types, including leave types when isLeaveType is true. Humanforce API: GET /api/1.0/shiftTypes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"isLeaveType": {
"type": "boolean",
"description": "Only leave types (true) or only non-leave shift types (false)."
}
}
},
"annotations": {
"title": "List shift types",
"readOnlyHint": true
}
}List all pay types used in timesheets and payruns. Humanforce API: GET /api/1.0/payTypes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
{
"name": "humanforce_list_pay_types",
"title": "List pay types",
"description": "List all pay types used in timesheets and payruns. Humanforce API: GET /api/1.0/payTypes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
}
}
},
"annotations": {
"title": "List pay types",
"readOnlyHint": true
}
}List the pay companies (legal payroll entities) in this tenant. Humanforce API: GET /api/1.0/PayCompany.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
{
"name": "humanforce_list_pay_companies",
"title": "List pay companies",
"description": "List the pay companies (legal payroll entities) in this tenant. Humanforce API: GET /api/1.0/PayCompany.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
}
}
},
"annotations": {
"title": "List pay companies",
"readOnlyHint": true
}
}List rostered shifts between two dates, with filters for employee, location, department and role. Humanforce API: GET /api/1.0/rosterItems.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| dateMax * | string | Date as yyyy-mm-dd. |
| dateMin * | string | Date as yyyy-mm-dd. |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| published | boolean | Only published (true) or unpublished (false) shifts. |
| roleGuidKey | string | Filter by role GUID. |
| includeDeleted | boolean | Include deleted shifts. |
| employeeGuidKey | string | Filter by employee GUID. |
| locationGuidKey | string | Filter by location GUID. |
| departmentGuidKey | string | Filter by department GUID. |
{
"name": "humanforce_list_roster_items",
"title": "List roster shifts",
"description": "List rostered shifts between two dates, with filters for employee, location, department and role. Humanforce API: GET /api/1.0/rosterItems.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dateMin",
"dateMax"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"dateMax": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"dateMin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"published": {
"type": "boolean",
"description": "Only published (true) or unpublished (false) shifts."
},
"roleGuidKey": {
"type": "string",
"description": "Filter by role GUID."
},
"includeDeleted": {
"type": "boolean",
"description": "Include deleted shifts."
},
"employeeGuidKey": {
"type": "string",
"description": "Filter by employee GUID."
},
"locationGuidKey": {
"type": "string",
"description": "Filter by location GUID."
},
"departmentGuidKey": {
"type": "string",
"description": "Filter by department GUID."
}
}
},
"annotations": {
"title": "List roster shifts",
"readOnlyHint": true
}
}List employee availability between two dates, optionally for one employee, location or department. Humanforce API: GET /api/1.0/availability.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| dateMax * | string | Date as yyyy-mm-dd. |
| dateMin * | string | Date as yyyy-mm-dd. |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| recurring | boolean | Only recurring availability (true) or only one-off (false). |
| employeeGuidKey | string | Filter by employee GUID. |
| locationGuidKey | string | Filter by location GUID. |
| departmentGuidKey | string | Filter by department GUID. |
{
"name": "humanforce_list_availability",
"title": "List availability",
"description": "List employee availability between two dates, optionally for one employee, location or department. Humanforce API: GET /api/1.0/availability.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dateMin",
"dateMax"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"dateMax": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"dateMin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"recurring": {
"type": "boolean",
"description": "Only recurring availability (true) or only one-off (false)."
},
"employeeGuidKey": {
"type": "string",
"description": "Filter by employee GUID."
},
"locationGuidKey": {
"type": "string",
"description": "Filter by location GUID."
},
"departmentGuidKey": {
"type": "string",
"description": "Filter by department GUID."
}
}
},
"annotations": {
"title": "List availability",
"readOnlyHint": true
}
}List public holidays between two dates, optionally for one region. Humanforce API: GET /api/1.0/publicHolidays.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| dateMax * | string | Date as yyyy-mm-dd. |
| dateMin * | string | Date as yyyy-mm-dd. |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| regionGuidKey | string | Filter by region GUID. |
{
"name": "humanforce_list_public_holidays",
"title": "List public holidays",
"description": "List public holidays between two dates, optionally for one region. Humanforce API: GET /api/1.0/publicHolidays.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dateMin",
"dateMax"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"dateMax": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"dateMin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"regionGuidKey": {
"type": "string",
"description": "Filter by region GUID."
}
}
},
"annotations": {
"title": "List public holidays",
"readOnlyHint": true
}
}Get whether an employee is clocked in or out now, in their local time. Humanforce API: GET /api/1.0/clocking/status.
| Parameter | Type | Description |
|---|---|---|
| timezoneOffset * | integer | Minutes offset from UTC for local time, for example 600 for Sydney and -240 for New York. |
| employeeGuidKey * | string | Employee GUID. |
{
"name": "humanforce_get_clocking_status",
"title": "Get clocking status",
"description": "Get whether an employee is clocked in or out now, in their local time. Humanforce API: GET /api/1.0/clocking/status.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employeeGuidKey",
"timezoneOffset"
],
"properties": {
"timezoneOffset": {
"type": "integer",
"maximum": 840,
"minimum": -840,
"description": "Minutes offset from UTC for local time, for example 600 for Sydney and -240 for New York."
},
"employeeGuidKey": {
"type": "string",
"minLength": 1,
"description": "Employee GUID."
}
}
},
"annotations": {
"title": "Get clocking status",
"readOnlyHint": true
}
}List timesheets in a date range (or pay-date range), with filters for employee, location and approval. Humanforce API: GET /api/1.0/timesheets.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| dateMax * | string | Date as yyyy-mm-dd. |
| dateMin * | string | Date as yyyy-mm-dd. |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| rostered | boolean | Only rostered (true) or unrostered (false) timesheets. |
| authorised | boolean | Only authorised (true) or unauthorised (false) timesheets. |
| usePayDate * | boolean | Filter on the pay date (true) or the shift date (false). |
| includeDeleted | boolean | Include deleted timesheets. |
| employeeGuidKey | string | Filter by employee GUID. |
| locationGuidKey | string | Filter by location GUID. |
{
"name": "humanforce_list_timesheets",
"title": "List timesheets",
"description": "List timesheets in a date range (or pay-date range), with filters for employee, location and approval. Humanforce API: GET /api/1.0/timesheets.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dateMin",
"dateMax",
"usePayDate"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"dateMax": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"dateMin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"rostered": {
"type": "boolean",
"description": "Only rostered (true) or unrostered (false) timesheets."
},
"authorised": {
"type": "boolean",
"description": "Only authorised (true) or unauthorised (false) timesheets."
},
"usePayDate": {
"type": "boolean",
"description": "Filter on the pay date (true) or the shift date (false)."
},
"includeDeleted": {
"type": "boolean",
"description": "Include deleted timesheets."
},
"employeeGuidKey": {
"type": "string",
"description": "Filter by employee GUID."
},
"locationGuidKey": {
"type": "string",
"description": "Filter by location GUID."
}
}
},
"annotations": {
"title": "List timesheets",
"readOnlyHint": true
}
}List leave requests in a date range, optionally only approved ones or for one employee. Humanforce API: GET /api/1.0/leaveRequest.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| dateMax * | string | Date as yyyy-mm-dd. |
| dateMin * | string | Date as yyyy-mm-dd. |
| deleted | boolean | Only deleted (true) or not deleted (false) requests. |
| pageSize | integer | Results per page, 1 to 500 (default 100). |
| approvedStatus | boolean | Only approved (true) or not approved (false) requests. |
| employeeGuidKey | string | Filter by employee GUID. |
| locationGuidKey | string | Filter by location GUID. |
{
"name": "humanforce_list_leave_requests",
"title": "List leave requests",
"description": "List leave requests in a date range, optionally only approved ones or for one employee. Humanforce API: GET /api/1.0/leaveRequest.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"dateMin",
"dateMax"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page number (default 1)."
},
"dateMax": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"dateMin": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date as yyyy-mm-dd."
},
"deleted": {
"type": "boolean",
"description": "Only deleted (true) or not deleted (false) requests."
},
"pageSize": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Results per page, 1 to 500 (default 100)."
},
"approvedStatus": {
"type": "boolean",
"description": "Only approved (true) or not approved (false) requests."
},
"employeeGuidKey": {
"type": "string",
"description": "Filter by employee GUID."
},
"locationGuidKey": {
"type": "string",
"description": "Filter by location GUID."
}
}
},
"annotations": {
"title": "List leave requests",
"readOnlyHint": true
}
}Tools for Humanforce, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Who is rostered at our Sydney site tomorrow, and in which roles?"; "Show the timesheets from last week that are not yet authorised."; "Which employees are clocked in right now at each location?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Humanforce data. Free plan: 50 tool calls per month. Run humanforce_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run humanforce_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run humanforce_upgrade without a plan: it returns both plans, each with a payment link for the user to open. humanforce_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.