ActivTrak MCP

Compare application usage between two time periods for a user or group. Returns each application's time spent in both periods, the change, percentage of total, and productivity classification, ranked by size of change. Either user_ids or group_ids must be provided. Both periods are required.

get_application_usage_trend

Fetch the top categories by time spent for a user, team, or group. A category groups applications and websites (e.g. 'Developer', 'Email'); unclassified activity is 'Uncategorized'. Returns category name, time spent, and percentage of total. Either user_ids or group_ids must be provided.

get_category_usage

Compare category usage between two time periods for a user, team, or group. Returns each category's time spent in both periods, the change, and percentage of total, ranked by size of change. Unclassified activity is 'Uncategorized'. Either user_ids or group_ids must be provided. Both periods are required.

get_category_usage_trend

Fetch a specific group by its numeric group_id.

get_group_by_id

Fetch the activity evidence around one PFA event, given its log_id from a prior PFA alarm log result.

get_pfa_activity_context

Fetch Potential False Activity (PFA) findings for a user or group. Either userIds or groupIds must be provided.

get_pfa_alarm_log

Fetch a user or group's PTO data by their numeric user_id or group_id. Returns a list of objects with: user_id, date, and duration. Either user_ids or group_ids must be provided.

get_pto_by_user_or_group

Analyze schedule adherence for users or a group over a date range. Returns per-user pre-computed metrics: late start/early end counts, goal achievement percentage and classification, extended inactivity flag, problem flags, and correlation patterns. Also returns team-level aggregates. Flex schedule users are excluded from late start/early end analysis. Default window: last 14 days. Either user_ids or group_ids must be provided.

get_schedule_adherence

Detect absent days for a group of users over a date range. A day is classified as absent when it is a scheduled working day, there is no recorded activity, and no PTO is logged. Handles both flex and non-flex schedules. Returns per-user absent dates, absent day count, and a team-level total. Use this for questions about absences, missed days, or days with no activity on working days.

get_team_absence_data

Detect absent days for one or more users over a date range. A day is classified as absent when it is a scheduled working day, there is no recorded activity, and no PTO is logged. Handles both flex and non-flex schedules. Returns per-user absent dates, absent day count, and a team-level total. Use this for questions about absences, missed days, or days with no activity on working days.

get_user_absence_data

Get the work schedule for one or more users by their user_ids. Returns each user's schedule per day of the week, including shift start/end times. If IsFlex is true the user is on a flexible schedule. If IsWorkingDay is false the user is off on that day. Every user has a schedule — if no custom schedule is configured the account default is applied automatically. Use search_users_by_name to resolve names to user_ids first.

get_user_schedule

Fetch productivity targets for one or more users. Returns each user's configured goals: productive hours per day, focused hours per day, and collaboration hours per day.

get_user_targets

Fetch a specific user by their numeric user_id. Returns the user and any alias-grouped peers.

get_user_by_id

Fetch utilization metrics for specific user(s) or group(s) within a date range. Returns utilization percentage, hours worked, capacity, and efficiency metrics per user or aggregated for groups.

get_utilization

Fetch utilization trend analysis for specific teams or users. Returns weekly trends with 4-week and 12-week rolling averages, burnout signals, and capacity status. For accurate 12-week averages, provide at least 84 days of history. Either user_ids or group_ids must be provided.

get_utilization_trends

Drill into one or more named websites to see the specific pages visited within them, ranked by time spent — the full URL, page title, time spent, percentage of total, and productivity classification per page. Use for questions about specific pages inside a site, not to rank whole sites. Only available when the account's Sensitive Data Visibility is Advanced Details; otherwise it returns an error and only domain-level usage can be shown. website_names, a date range, and either user_ids or group_ids are required.

get_website_details

Fetch the top websites by time spent for a user, team, or group. Returns website name, time spent, percentage of total, and productivity classification. Either user_ids or group_ids must be provided.

get_website_usage

Compare website usage between two time periods for a user, team, or group. Returns each website's time spent in both periods, the change, percentage of total, and productivity classification, ranked by size of change. Either user_ids or group_ids must be provided. Both periods are required.

get_website_usage_trend

Resolve a natural language date period into concrete start_date and end_date values. Call this once per user request when the user specifies a relative period (e.g. 'last month', 'this past week'). Reuse the returned dates for all subsequent tool calls.

resolve_date_range

Search for groups by name or partial name. Returns matching groups with group_id and group_name.

search_groups_by_name

Find all groups that a specific user belongs to.

search_groups_by_user

Find all users who are members of a specific group.

search_users_by_group

Search for users by name or partial name. Returns matching users with their IDs and usernames. Users with the same tag are grouped as a single logical user.

search_users_by_name