Truein MCP by usefulapi
Read staff, punches, timesheets, leave and schedules; record punches and leave in Truein.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (5)
- HIGH
- MEDIUMen truein_get_punch_checklist_answers
- LOWen truein_get_daily_attendance_log
- LOWen truein_get_geofencing_locations
- LOWen truein_get_punch_checklist_answers
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": {
"truein": {
"url": "https://truein.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://truein.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (20)
🟢truein_list_employees(empId, lastUid, status, managerEmpId, modifiedAfter)
List staff master records (employee id, name, status, manager). Use status=active to see current staff. Truein GET /apis/ext/attendance/v1.0/getEmployeeDtls.
Esquema de entrada
{
"type": "object",
"properties": {
"empId": {
"description": "Employee ID. Leave empty to list all staff.",
"type": "string"
},
"lastUid": {
"description": "Pagination cursor: the last_uid value from the previous reply.",
"type": "string"
},
"status": {
"description": "Filter by status: active or inactive.",
"type": "string"
},
"managerEmpId": {
"description": "Only staff who report to this manager employee ID.",
"type": "string"
},
"modifiedAfter": {
"description": "Only records added or updated after this time, format YYYY-MM-DD HH:MM:SS.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_list_punch_pairs(lastUid, from_date, to_date, emp_id)
List clock-in and clock-out punch pairs for all staff, 1000 records per call. Send lastUid=0 first, then the uid of the last record for the next page. Filters on the clock-in time. Truein GET /apis/ext/attendance/v1.0/inOutDtls.
Esquema de entrada
{
"type": "object",
"properties": {
"lastUid": {
"type": "string",
"description": "Pagination cursor. Send 0 on the first call."
},
"from_date": {
"description": "Start of the clock-in window, YYYY-MM-DD (inclusive).",
"type": "string"
},
"to_date": {
"description": "End of the clock-in window, YYYY-MM-DD (inclusive).",
"type": "string"
},
"emp_id": {
"description": "Employee IDs, comma-separated, no spaces.",
"type": "string"
}
},
"required": [
"lastUid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_daily_attendance_log(date, lastUid, emp_id, include_absent, site_name, ...)
Get the attendance log for one day: who was present, absent or late. Paginated by lastUid (send 0 first). Truein GET /apis/ext/attendance/v1.0/dailyAttendanceLog.
Esquema de entrada
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "Day to read, YYYY-MM-DD."
},
"lastUid": {
"type": "string",
"description": "Pagination cursor. Send 0 on the first call."
},
"emp_id": {
"description": "Employee IDs, comma-separated.",
"type": "string"
},
"include_absent": {
"description": "true to include absent staff.",
"type": "string"
},
"site_name": {
"description": "Filter by site name.",
"type": "string"
},
"category": {
"description": "Filter by staff category.",
"type": "string"
},
"attendanceStatus": {
"description": "Filter by attendance status.",
"type": "string"
}
},
"required": [
"date",
"lastUid"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_punch_log(lastUid, from_time, to_time, emp_id)
Get raw punch records (each clock event) for a time window or employee. Paginated by lastUid. Truein GET /ext/v1/time-tracking/getPunchLog.
Esquema de entrada
{
"type": "object",
"properties": {
"lastUid": {
"description": "Pagination cursor. Send 0 on the first call.",
"type": "string"
},
"from_time": {
"description": "Start time, YYYY-MM-DD HH:mm:ss.",
"type": "string"
},
"to_time": {
"description": "End time, YYYY-MM-DD HH:mm:ss.",
"type": "string"
},
"emp_id": {
"description": "Employee ID.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_timesheet_summary(siteCode, empId, includeAbsent, fromDate, toDate, ...)
Get the hours worked per employee for a date range, optionally with leave split and job-wise totals. Truein GET /ext/v1/timesheet/getTimesheetSummary.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
},
"empId": {
"description": "Employee ID.",
"type": "string"
},
"includeAbsent": {
"description": "true to include absent days.",
"type": "string"
},
"fromDate": {
"description": "Start date, YYYY-MM-DD.",
"type": "string"
},
"toDate": {
"description": "End date, YYYY-MM-DD.",
"type": "string"
},
"category": {
"description": "Staff category.",
"type": "string"
},
"includeLeaveBifurcation": {
"description": "true to split leave hours out.",
"type": "string"
},
"includeJobWiseSummary": {
"description": "true to add job-wise totals.",
"type": "string"
},
"jobCode": {
"description": "Job code.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_leave(siteCode, empId, leaveCodes, fromDate, toDate, ...)
List leave requests with their approval status for a site or employee. Truein GET /ext/v1/leave/getLeave.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
},
"empId": {
"description": "Employee ID.",
"type": "string"
},
"leaveCodes": {
"description": "Leave codes, comma-separated (for example PTO).",
"type": "string"
},
"fromDate": {
"description": "Start date, YYYY-MM-DD.",
"type": "string"
},
"toDate": {
"description": "End date, YYYY-MM-DD.",
"type": "string"
},
"approvalStatus": {
"description": "Approval status filter.",
"type": "string"
},
"searchString": {
"description": "Free-text search.",
"type": "string"
},
"extRefId": {
"description": "Your own reference id for the request.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_leave_lite(siteCode, empId, leaveCodes, fromDate, toDate, ...)
List leave-lite requests (short leave) with approval status. Truein GET /ext/v1/leave/getLeaveLite.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
},
"empId": {
"description": "Employee ID.",
"type": "string"
},
"leaveCodes": {
"description": "Leave codes, comma-separated.",
"type": "string"
},
"fromDate": {
"description": "Start date, YYYY-MM-DD.",
"type": "string"
},
"toDate": {
"description": "End date, YYYY-MM-DD.",
"type": "string"
},
"approvalStatus": {
"description": "Approval status filter.",
"type": "string"
},
"searchString": {
"description": "Free-text search.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_schedule(siteCode, date, employeeIds, shiftCode, jobCode, ...)
Get who is scheduled on which shift and job for a date at a site. Paginated. Truein GET /ext/v1/schedule/getSchedule.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
},
"date": {
"description": "Date, YYYY-MM-DD.",
"type": "string"
},
"employeeIds": {
"description": "Employee IDs, comma-separated.",
"type": "string"
},
"shiftCode": {
"description": "Shift code.",
"type": "string"
},
"jobCode": {
"description": "Job code.",
"type": "string"
},
"page": {
"description": "Page number.",
"type": "string"
},
"pageSize": {
"description": "Records per page.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_shifts(siteCode, shiftCode, shiftName)
List shift definitions (code, name, start and end times) for a site. Truein GET /ext/v1/shift/getShifts.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
},
"shiftCode": {
"description": "Shift code.",
"type": "string"
},
"shiftName": {
"description": "Shift name.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_client_sites(siteCode)
List sites (work locations) with their codes. Truein GET /ext/v1/client-site/getClientSites.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code. Leave empty to list all sites.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_regions(regionName)
List regions that group sites. Truein GET /ext/v1/region/getRegions.
Esquema de entrada
{
"type": "object",
"properties": {
"regionName": {
"description": "Region name.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_public_holidays(holidayDate, year, extRefId)
List public holidays for a year or a date. Truein GET /ext/v1/holiday/getPublicHoliday.
Esquema de entrada
{
"type": "object",
"properties": {
"holidayDate": {
"description": "Holiday date, YYYY-MM-DD.",
"type": "string"
},
"year": {
"description": "Year, for example 2026.",
"type": "string"
},
"extRefId": {
"description": "Your own reference id.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_geofencing_locations(siteCode)
List the geofenced locations used for GPS attendance at a site. Truein GET /ext/v1/geofencing-location/getGeoFencingLocations.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_spoof_punches(fromDate, toDate, siteCodes, empIds)
List punches that Truein flagged as possible spoofing (for example a photo held up to the camera). Truein GET /ext/v1/alerts/getSpoofPunches.
Esquema de entrada
{
"type": "object",
"properties": {
"fromDate": {
"description": "Start date, YYYY-MM-DD.",
"type": "string"
},
"toDate": {
"description": "End date, YYYY-MM-DD.",
"type": "string"
},
"siteCodes": {
"description": "Site codes, comma-separated.",
"type": "string"
},
"empIds": {
"description": "Employee IDs, comma-separated.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_kiosk_devices(siteCode, kioskId)
List the kiosk (punch device) records for a site. Truein GET /ext/v1/kiosk-device/getKioskDevice.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"description": "Site code.",
"type": "string"
},
"kioskId": {
"description": "Kiosk id.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢truein_get_punch_checklist_answers(date, punchType, empId)
Get the answers staff gave to the punch checklist questions for a date. Truein GET /ext/v1/timesheet/getPunchChecklistAnswers.
Esquema de entrada
{
"type": "object",
"properties": {
"date": {
"description": "Date, YYYY-MM-DD.",
"type": "string"
},
"punchType": {
"description": "Punch type (In or Out).",
"type": "string"
},
"empId": {
"description": "Employee ID.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴truein_clock_in(siteCode, empId, inTime, jobCode)
WRITE: record a clock-in punch for an employee at a site, at the given time. Truein POST /v1/time-tracking/clockIn. Geofenced sites may reject a punch without a photo or location.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"type": "string",
"description": "Site code where the punch is made."
},
"empId": {
"type": "string",
"description": "Employee ID."
},
"inTime": {
"type": "string",
"description": "Clock-in time, YYYY-MM-DD HH:mm:ss."
},
"jobCode": {
"description": "Job code, if the punch is for a job.",
"type": "string"
}
},
"required": [
"siteCode",
"empId",
"inTime"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴truein_clock_out(siteCode, empId, outTime, jobCode)
WRITE: record a clock-out punch for an employee at a site, at the given time. Truein POST /v1/time-tracking/clockOut.
Esquema de entrada
{
"type": "object",
"properties": {
"siteCode": {
"type": "string",
"description": "Site code where the punch is made."
},
"empId": {
"type": "string",
"description": "Employee ID."
},
"outTime": {
"type": "string",
"description": "Clock-out time, YYYY-MM-DD HH:mm:ss."
},
"jobCode": {
"description": "Job code, if the punch is for a job.",
"type": "string"
}
},
"required": [
"siteCode",
"empId",
"outTime"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴truein_request_leave(empId, siteCode, leaveCode, fromDate, toDate, ...)
WRITE: submit a leave-lite request for an employee for the given dates. The request then waits for approval. Truein POST /ext/v1/leave/addLeaveLite.
Esquema de entrada
{
"type": "object",
"properties": {
"empId": {
"type": "string",
"description": "Employee ID of the person taking leave."
},
"siteCode": {
"type": "string",
"description": "Site code where the employee is assigned."
},
"leaveCode": {
"type": "string",
"description": "Leave type code, for example PTO."
},
"fromDate": {
"type": "string",
"description": "First day of leave, YYYY-MM-DD."
},
"toDate": {
"type": "string",
"description": "Last day of leave, YYYY-MM-DD."
},
"fromDateHalfDay": {
"description": "First Half or Second Half, if the first day is a half day.",
"type": "string"
},
"toDateHalfDay": {
"description": "First Half or Second Half, if the last day is a half day.",
"type": "string"
},
"leaveReason": {
"description": "Reason for the leave.",
"type": "string"
}
},
"required": [
"empId",
"siteCode",
"leaveCode",
"fromDate",
"toDate"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴truein_cancel_leave_request(empId, siteCode, fromDate, toDate, fromDateHalfDay, ...)
WRITE: cancel a leave-lite request for an employee on the given dates. Truein POST /ext/v1/leave/cancelLeaveLiteStatus.
Esquema de entrada
{
"type": "object",
"properties": {
"empId": {
"type": "string",
"description": "Employee ID."
},
"siteCode": {
"type": "string",
"description": "Site code where the employee is assigned."
},
"fromDate": {
"type": "string",
"description": "First day of the leave, YYYY-MM-DD."
},
"toDate": {
"type": "string",
"description": "Last day of the leave, YYYY-MM-DD."
},
"fromDateHalfDay": {
"description": "First Half or Second Half, if the first day was a half day.",
"type": "string"
},
"leaveCode": {
"type": "string",
"description": "Leave type code, for example PTO."
}
},
"required": [
"empId",
"siteCode",
"fromDate",
"toDate",
"leaveCode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia