Go2Clock MCP by usefulapi is an MCP server published by io.usefulapi, hosted at go2clock.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including go2clock_list_users, go2clock_list_employees, go2clock_list_clock_records, go2clock_list_clock_records_range, go2clock_get_timesheet_csv.
Read clock records, timesheets and rotas; change employees and rotas, add clock records in Go2Clock.
4,059 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List every clock user with id, name, department, shift, payroll number and manager flag. Clock PINs are removed. Go2Clock API: POST /api/users/.
No parameters.
{
"name": "go2clock_list_users",
"title": "List clock users",
"description": "List every clock user with id, name, department, shift, payroll number and manager flag. Clock PINs are removed. Go2Clock API: POST /api/users/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List clock users",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
List employee details: contact, department, trade, pay rates, roles, start and termination dates. Go2Clock API: POST /api/employees/.
No parameters.
{
"name": "go2clock_list_employees",
"title": "List employee details",
"description": "List employee details: contact, department, trade, pay rates, roles, start and termination dates. Go2Clock API: POST /api/employees/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List employee details",
"readOnlyHint": true
}
}List every clocking record (punch) for one date. Go2Clock API: POST /api/punches/ with punch_date.
| Parameter | Type | Description |
|---|---|---|
| punch_date * | string | Date to read, yyyy-mm-dd. |
{
"name": "go2clock_list_clock_records",
"title": "List clock records for a day",
"description": "List every clocking record (punch) for one date. Go2Clock API: POST /api/punches/ with punch_date.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"punch_date"
],
"properties": {
"punch_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date to read, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "List clock records for a day",
"readOnlyHint": true
}
}List clocking records between two dates, optionally for one employee. Keep the range to 7 days or fewer per call; Go2Clock advises against larger pulls. Go2Clock API: POST /api/punches_range/.
| Parameter | Type | Description |
|---|---|---|
| userid | string | Employee ID (userid), numeric. |
| end_date * | string | Last date, yyyy-mm-dd. |
| start_date * | string | First date, yyyy-mm-dd. |
{
"name": "go2clock_list_clock_records_range",
"title": "List clock records for a date range",
"description": "List clocking records between two dates, optionally for one employee. Keep the range to 7 days or fewer per call; Go2Clock advises against larger pulls. Go2Clock API: POST /api/punches_range/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last date, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First date, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "List clock records for a date range",
"readOnlyHint": true
}
}Generate the timesheet report as CSV for up to 7 days, optionally for one department or one employee. Returns the CSV text. Go2Clock API: POST /api/timesheet_csv_v1.
| Parameter | Type | Description |
|---|---|---|
| dept | string | Department name to filter by (default: all departments). |
| nodays * | integer | Number of days, 1 to 7. |
| userid | string | Employee ID (userid), numeric. |
| start_date * | string | First day of the report, yyyy-mm-dd. |
{
"name": "go2clock_get_timesheet_csv",
"title": "Get timesheet CSV",
"description": "Generate the timesheet report as CSV for up to 7 days, optionally for one department or one employee. Returns the CSV text. Go2Clock API: POST /api/timesheet_csv_v1.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"nodays"
],
"properties": {
"dept": {
"type": "string",
"description": "Department name to filter by (default: all departments)."
},
"nodays": {
"type": "integer",
"maximum": 7,
"minimum": 1,
"description": "Number of days, 1 to 7."
},
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day of the report, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Get timesheet CSV",
"readOnlyHint": true
}
}Read an employee's rota (shift schedule) between two dates: shift name, colour and planned hours per day. Go2Clock API: GET /api/employee_rota.
| Parameter | Type | Description |
|---|---|---|
| userid * | string | Employee ID (userid), numeric. |
| end_date * | string | Last date, yyyy-mm-dd. |
| start_date * | string | First date, yyyy-mm-dd. |
{
"name": "go2clock_get_rota",
"title": "Get employee rota",
"description": "Read an employee's rota (shift schedule) between two dates: shift name, colour and planned hours per day. Go2Clock API: GET /api/employee_rota.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userid",
"start_date",
"end_date"
],
"properties": {
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last date, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First date, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Get employee rota",
"readOnlyHint": true
}
}Change some details of one existing employee. Send only the fields to change. Go2Clock API: PUT /api/employee_update. Does not change sign-in passwords or roles.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| string | ||
| userid * | string | Employee ID (userid), numeric. |
| payrate | ["string","number"] | |
| deptname | string | |
| hourlypay | ["string","number"] | |
| payrollno | string | |
| tradename | string | |
| home_phone | string | |
| start_date | string | |
| home_address | string | |
| mobilenumber | string | |
| max_hours_day | ["string","number"] | |
| max_hours_week | ["string","number"] | |
| termination_date | string | |
| sagehr_employeeno | string | |
| termination_reason | string | |
| peoplehr_employeeid | string | |
| holiday_total_allowed | ["string","number"] |
{
"name": "go2clock_update_employee",
"title": "Update employee details",
"description": "Change some details of one existing employee. Send only the fields to change. Go2Clock API: PUT /api/employee_update. Does not change sign-in passwords or roles.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userid"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255
},
"email": {
"type": "string",
"maxLength": 100
},
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"payrate": {
"type": [
"string",
"number"
]
},
"deptname": {
"type": "string",
"maxLength": 255
},
"hourlypay": {
"type": [
"string",
"number"
]
},
"payrollno": {
"type": "string",
"maxLength": 50
},
"tradename": {
"type": "string",
"maxLength": 255
},
"home_phone": {
"type": "string"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"home_address": {
"type": "string"
},
"mobilenumber": {
"type": "string",
"maxLength": 20
},
"max_hours_day": {
"type": [
"string",
"number"
]
},
"max_hours_week": {
"type": [
"string",
"number"
]
},
"termination_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"sagehr_employeeno": {
"type": "string"
},
"termination_reason": {
"type": "string"
},
"peoplehr_employeeid": {
"type": "string"
},
"holiday_total_allowed": {
"type": [
"string",
"number"
]
}
}
},
"annotations": {
"title": "Update employee details",
"destructiveHint": true
}
}Upload a list of employees (new or changed). Go2Clock keys each record on userid. Sends a JSON array. Go2Clock API: PUT /api/employees/. Does not set passwords or roles.
| Parameter | Type | Description |
|---|---|---|
| employees * | array | Employees to create or update. |
{
"name": "go2clock_upload_employees",
"title": "Create or update employees",
"description": "Upload a list of employees (new or changed). Go2Clock keys each record on userid. Sends a JSON array. Go2Clock API: PUT /api/employees/. Does not set passwords or roles.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employees"
],
"properties": {
"employees": {
"type": "array",
"items": {
"type": "object",
"required": [
"userid",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255
},
"email": {
"type": "string",
"maxLength": 100
},
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"deptname": {
"type": "string",
"maxLength": 255
},
"shiftfri": {
"type": "string",
"maxLength": 255
},
"shiftmon": {
"type": "string",
"maxLength": 255
},
"shiftsat": {
"type": "string",
"maxLength": 255
},
"shiftsun": {
"type": "string",
"maxLength": 255
},
"shiftthu": {
"type": "string",
"maxLength": 255
},
"shifttue": {
"type": "string",
"maxLength": 255
},
"shiftwed": {
"type": "string",
"maxLength": 255
},
"payrollno": {
"type": "string",
"maxLength": 50
},
"tradename": {
"type": "string",
"maxLength": 255
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"mobilenumber": {
"type": "string",
"maxLength": 20
},
"termination_date": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "null"
}
]
},
"peoplehr_employeeid": {
"type": "string"
}
}
},
"minItems": 1,
"description": "Employees to create or update."
}
}
},
"annotations": {
"title": "Create or update employees",
"destructiveHint": true
}
}Add one clocking record (punch) for an employee. Go2Clock refuses a duplicate record. Go2Clock API: PUT /api/punches/.
| Parameter | Type | Description |
|---|---|---|
| userid * | string | Employee ID (userid), numeric. |
| latitude | ["string","number"] | |
| sensorid | ["string","number"] | |
| worktype | ["string","number"] | Job code number. |
| checktime * | string | When the employee clocked, yyyy-mm-ddThh:mm:ss. |
| checktype * | ["string","number"] | 0 = in, 1 = out, or another number your instance uses. |
| longitude | ["string","number"] | |
| deviceserial | string | |
| eventdescription | string |
{
"name": "go2clock_upload_clock_record",
"title": "Add a clock record",
"description": "Add one clocking record (punch) for an employee. Go2Clock refuses a duplicate record. Go2Clock API: PUT /api/punches/.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userid",
"checktime",
"checktype"
],
"properties": {
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"latitude": {
"type": [
"string",
"number"
]
},
"sensorid": {
"type": [
"string",
"number"
]
},
"worktype": {
"type": [
"string",
"number"
],
"description": "Job code number."
},
"checktime": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$",
"description": "When the employee clocked, yyyy-mm-ddThh:mm:ss."
},
"checktype": {
"type": [
"string",
"number"
],
"description": "0 = in, 1 = out, or another number your instance uses."
},
"longitude": {
"type": [
"string",
"number"
]
},
"deviceserial": {
"type": "string"
},
"eventdescription": {
"type": "string"
}
}
},
"annotations": {
"title": "Add a clock record",
"destructiveHint": true
}
}Put a named shift on an employee's rota for one or more days from a start date. An existing rota entry on the same date is replaced. The shift name must match a shift in Go2Clock's shift settings. Go2Clock API: POST /api/employee_rota.
| Parameter | Type | Description |
|---|---|---|
| nodays | integer | Consecutive days from the start date (default 1). |
| userid * | string | Employee ID (userid), numeric. |
| shift_name * | string | Shift name exactly as set in Go2Clock shift settings. |
| start_date * | string | First day of the shift, yyyy-mm-dd. |
{
"name": "go2clock_create_rota",
"title": "Create rota shifts",
"description": "Put a named shift on an employee's rota for one or more days from a start date. An existing rota entry on the same date is replaced. The shift name must match a shift in Go2Clock's shift settings. Go2Clock API: POST /api/employee_rota.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userid",
"start_date",
"shift_name"
],
"properties": {
"nodays": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Consecutive days from the start date (default 1).",
"exclusiveMinimum": 0
},
"userid": {
"type": "string",
"pattern": "^\\d+$",
"description": "Employee ID (userid), numeric."
},
"shift_name": {
"type": "string",
"minLength": 1,
"description": "Shift name exactly as set in Go2Clock shift settings."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day of the shift, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Create rota shifts",
"destructiveHint": true
}
}Tools for Go2Clock, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Who clocked in late at our salon this week?"; "Download the timesheet CSV for the last 7 days."; "Show the rota for employee 10002 for next week.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Go2Clock data. Free plan: 50 tool calls per month. Run go2clock_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run go2clock_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run go2clock_upgrade without a plan: it returns both plans, each with a payment link for the user to open. go2clock_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.