WebClock MCP by usefulapi

Read employees, time clock, timesheets, time off, schedules and payroll data in WebClock.

Should I use this

Quality & Safety

B
Description quality
91%
Schema completeness
65%
Naming quality
79%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (5)

  • LOWTool 'webclock_get_anomalies' description lacks action verbin webclock_get_anomalies
  • LOWTool 'webclock_get_hr_certifications' description lacks action verbin webclock_get_hr_certifications
  • LOWTool 'webclock_get_accrual_balances' description lacks action verbin webclock_get_accrual_balances
  • LOWTool 'webclock_list_job_functions' description lacks action verbin webclock_list_job_functions
  • LOWTool 'webclock_get_time_off_requests_admin' name length outside 3-30 rangein webclock_get_time_off_requests_admin

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,312Tokens (tool definitions)
~862 BTypical response size
Moderate attention impact (1.81% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "webclock": {
      "url": "https://webclock.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

https://webclock.usefulapi.io/mcpstreamable-http

What it can do

Tool inventory

Tools (16)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢webclock_list_employees

List all employees defined in WebClock, active and terminated, with pay group, department, pay type and hire/term dates.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_time_clock(start_date, end_date)

Return time-clock records (punch times, rounded times, hours, approvals) for a date range. Dates are MM/DD/YYYY.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "Last day, MM/DD/YYYY."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_timesheets(start_date, end_date)

Return timesheet records for a date range: hours by pay code, client, task and shift, with lock and approval status. Dates are MM/DD/YYYY.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "Last day, MM/DD/YYYY."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_time_off_requests(start_date, end_date, status, employee_id)

Return time-off requests in a date range, optionally filtered by status or employee ID. Dates are MM/DD/YYYY.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "Last day, MM/DD/YYYY."
    },
    "status": {
      "description": "Request status (default ALL).",
      "type": "string",
      "enum": [
        "ALL",
        "Approved",
        "Open",
        "Rejected"
      ]
    },
    "employee_id": {
      "description": "WebClock employee ID to filter by.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_time_off_requests_admin(start_date, end_date)

Return all time-off records in a date range, including administrative fields such as create date and last updated by. Dates end with a time: MM/DD/YYYY HH:MM:SS AM/PM.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4} \\d{1,2}:\\d{2}:\\d{2} ?(AM|PM)$",
      "description": "Last moment, MM/DD/YYYY HH:MM:SS AM/PM."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_whos_in_out

Return the current in/out status of employees: last in, last out, current status (1 in, 2 out), activity and time-off flag.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_license

Return the license count and the number of active users for the WebClock client.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_time_summary(start_date, end_date, period, group_by)

Return summed time totals across a date range, optionally per week or month and grouped by department. The end date ends with a time.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4} \\d{1,2}:\\d{2}:\\d{2} ?(AM|PM)$",
      "description": "Last moment, MM/DD/YYYY HH:MM:SS AM/PM."
    },
    "period": {
      "description": "Period grouping (optional).",
      "type": "string",
      "enum": [
        "WEEKLY",
        "MONTHLY",
        "NONE"
      ]
    },
    "group_by": {
      "description": "Group by department (optional).",
      "type": "string",
      "enum": [
        "DEPARTMENT",
        "NONE"
      ]
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_schedules(start_date, end_date, employee_id, pay_group, department)

Return employee schedule records for a date range, with optional filters by employee, pay group or department. Dates are YYYY-MM-DD.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "First day, YYYY-MM-DD."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Last day, YYYY-MM-DD."
    },
    "employee_id": {
      "description": "WebClock employee ID to filter by.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "pay_group": {
      "description": "Pay group to filter by.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "pattern": "^[\\x20-\\x7E]+$"
    },
    "department": {
      "description": "Department to filter by.",
      "type": "string",
      "minLength": 1,
      "maxLength": 75,
      "pattern": "^[\\x20-\\x7E]+$"
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_anomalies(start_date, end_date)

Return shift anomalies such as missing punches for a date range. The end date ends with a time.

Input Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4} \\d{1,2}:\\d{2}:\\d{2} ?(AM|PM)$",
      "description": "Last moment, MM/DD/YYYY HH:MM:SS AM/PM."
    }
  },
  "required": [
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_hr_certifications

Return HR certifications and class history for employees: class, institution, credits, completion date and cost.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_accrual_balances

Return the current accrual balances by employee and accrual type.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_get_payroll_data(pay_group, start_date, end_date)

Return payroll-ready records for one pay group over a date range: units, rates, pay codes and PTO balance. Dates are MM/DD/YYYY.

Input Schema

{
  "type": "object",
  "properties": {
    "pay_group": {
      "type": "string",
      "minLength": 1,
      "maxLength": 10,
      "pattern": "^[\\x20-\\x7E]+$",
      "description": "Pay group name, as defined in WebClock."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "First day, MM/DD/YYYY."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{2}\\/\\d{2}\\/\\d{4}$",
      "description": "Last day, MM/DD/YYYY."
    }
  },
  "required": [
    "pay_group",
    "start_date",
    "end_date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_list_locations

Return the configured work-location list for the client, with sub-locations and descriptions.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_list_tasks

Return the configured task list for the client, with sub-tasks and effective dates.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢webclock_list_job_functions

Return the HR job-function definitions for the client.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded16 tools