Truein MCP by usefulapi
Read staff, punches, timesheets, leave and schedules; record punches and leave in Truein.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- HIGH
- MEDIUMtruein_get_punch_checklist_answers에서
- LOWtruein_get_daily_attendance_log에서
- LOWtruein_get_geofencing_locations에서
- LOWtruein_get_punch_checklist_answers에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"truein": {
"url": "https://truein.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://truein.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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.
입력 스키마
{
"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"
}커뮤니티
증거