Humanforce MCP by usefulapi

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

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
95%
Calidad de los nombres
79%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (1)

  • LOWTool 'humanforce_list_public_holidays' name length outside 3-30 rangeen humanforce_list_public_holidays

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,928Tokens (definiciones de herramientas)
~1.7 KBTamaño de respuesta típico
Impacto significativo en la atención (2.29% del contexto de 128k)

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-http

Qué puede hacer

Inventario de herramientas

Herramientas (14)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada14 herramientas