Truein MCP by usefulapi

Read staff, punches, timesheets, leave and schedules; record punches and leave in Truein.

사용해야 할까요

품질 및 안전성

A
설명 품질
96%
스키마 완전성
93%
이름 품질
77%
오염 위험
80%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (5)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains suspicious base64-like encoded stringtruein_get_punch_checklist_answers에서
  • LOWTool 'truein_get_daily_attendance_log' name length outside 3-30 rangetruein_get_daily_attendance_log에서
  • LOWTool 'truein_get_geofencing_locations' name length outside 3-30 rangetruein_get_geofencing_locations에서
  • LOWTool 'truein_get_punch_checklist_answers' name length outside 3-30 rangetruein_get_punch_checklist_answers에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~3,345토큰 (도구 정의)
~1.3 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.61%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`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"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 20개