List employees in the organization.

Args: status: 1 = active, 0 = inactive. Default active. page_number: Zero-based page index. per_page: Records per page (keep modest, e.g. 50-500). order: 'asc' or 'desc'.

Returns the raw employee list payload (id, name, department, etc.). Use this to resolve an employee's name to their numeric ID before calling employee- or report-specific tools.

Get the basic profile of a single employee by their numeric employee ID.

Args: employee_id: The Tipsoi employee ID (string of digits).

Monthly attendance report for an office.

Args: year: e.g. 2026. month: 1-12. office_id: Tipsoi office ID. Falls back to TIPSOI_OFFICE_ID if omitted. employee_name: Optional name filter (substring). status: 1 = active employees. per_page / page_number: Pagination.

Daily attendance summary for a single date.

Args: date: YYYY-MM-DD. office_id: Falls back to TIPSOI_OFFICE_ID if omitted. employee_name: Optional name filter. status: 1 = active employees. per_page: Pagination size.

Report of employees absent on a given date.

Args: date: YYYY-MM-DD. office_id: Falls back to TIPSOI_OFFICE_ID if omitted. absent_type: Tipsoi absent classification code (default 1). per_page: Pagination size.

Late / leave / absent combined report over a date range.

Args: from_date: YYYY-MM-DD (inclusive). to_date: YYYY-MM-DD (inclusive). office_id: Falls back to TIPSOI_OFFICE_ID. company_id: Falls back to TIPSOI_COMPANY_ID. per_page: Pagination size.

Mobile punch (app-based check-in/out, incl. selfie attendance) report.

Args: from_date: YYYY-MM-DD (inclusive). to_date: YYYY-MM-DD (inclusive). office_id: Falls back to TIPSOI_OFFICE_ID. per_page: Pagination size.

Leave balance report across a date range.

Args: from_date: YYYY-MM-DD. to_date: YYYY-MM-DD. office_id: Falls back to TIPSOI_OFFICE_ID. per_page: Pagination size.

List applied leave requests and their statuses (READ-ONLY view).

Args: keyword: Optional search term. statuses: List of status codes to include (e.g. [0,1] for pending+approved). Defaults to [0, 1]. page: Zero-based page index. count: Page size.

NOTE: This only reads leave applications. Applying/approving/rejecting leave is a write action and is intentionally NOT available in Phase 1.

Monthly overtime report.

Args: year: e.g. 2026. month: 1-12. office_id: Falls back to TIPSOI_OFFICE_ID. company_id: Falls back to TIPSOI_COMPANY_ID. per_page: Pagination size.

List all workplaces (offices/locations) configured in Tipsoi.

Useful for discovering valid office_id values to pass to report tools.

List departments.

Args: include_inactive: Include inactive departments. Default True.

List all designations (job titles).

List configured holidays.

List recent notifications for the authenticated account.

Args: page_number: Zero-based page index. per_page: Page size.