ExakTime / Arcoro MCP by usefulapi is an MCP server published by io.usefulapi, hosted at exaktime.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 32 tools, including exaktime_list_employees, exaktime_list_persons, exaktime_get_person, exaktime_get_employee, exaktime_list_locations.
MCP server for Arcoro and ExakTime — workforce data, jobs, cost codes and locations.
4,285 connections through 5 shared values. Tap any node.
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.
Inferred from the host name and headers: what a server runs on, not who runs it.
List employees (Person records of type Employee) with name, job title, department, employee id, active/inactive status and which Arcoro modules they use. Use personId with exaktime_get_employee. GET /v1/Common/Persons/Employees.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_employees",
"title": "List employees",
"description": "List employees (Person records of type Employee) with name, job title, department, employee id, active/inactive status and which Arcoro modules they use. Use personId with exaktime_get_employee. GET /v1/Common/Persons/Employees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List employees",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List or search Person records (employees and API users) by first name, last name, employee identifier or work email. Returns personId, names, work email, employee id, username and whether the person is a contractor or deleted. GET /v1/Common/Persons.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| last_name | string | Last name filter. |
| page_size | integer | Results per page, 1-100 (default 50). |
| first_name | string | First name filter. |
| work_email | string | Work email address. |
| employee_identifier | string | Your employee id / number. |
{
"name": "exaktime_list_persons",
"title": "Search persons",
"description": "List or search Person records (employees and API users) by first name, last name, employee identifier or work email. Returns personId, names, work email, employee id, username and whether the person is a contractor or deleted. GET /v1/Common/Persons.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"last_name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Last name filter."
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
},
"first_name": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "First name filter."
},
"work_email": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Work email address."
},
"employee_identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your employee id / number."
}
}
},
"annotations": {
"title": "Search persons",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One Person record: names, contact details, address, login username and security groups. Government identifiers are not available through this server. GET /v1/Common/Persons/{personId}.
| Parameter | Type | Description |
|---|---|---|
| person_id * | integer | Arcoro personId. |
{
"name": "exaktime_get_person",
"title": "Get person",
"description": "One Person record: names, contact details, address, login username and security groups. Government identifiers are not available through this server. GET /v1/Common/Persons/{personId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro personId.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get person",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Employment details for a person: hire/termination date, status, employment and pay type, pay rates, job code, manager, location, department, pay schedule and union. GET /v1/Common/Persons/{personId}/Employees.
| Parameter | Type | Description |
|---|---|---|
| person_id * | integer | Arcoro personId. |
{
"name": "exaktime_get_employee",
"title": "Get employee",
"description": "Employment details for a person: hire/termination date, status, employment and pay type, pay rates, job code, manager, location, department, pay schedule and union. GET /v1/Common/Persons/{personId}/Employees.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"person_id"
],
"properties": {
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro personId.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get employee",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List locations (job sites and offices) with address, coordinates, active flag and whether they are used for time and attendance. GET /v1/Common/Locations.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_locations",
"title": "List locations",
"description": "List locations (job sites and offices) with address, coordinates, active flag and whether they are used for time and attendance. GET /v1/Common/Locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List locations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One location by id. GET /v1/Common/Locations/{id}.
| Parameter | Type | Description |
|---|---|---|
| location_id * | integer | Arcoro locationId. |
{
"name": "exaktime_get_location",
"title": "Get location",
"description": "One location by id. GET /v1/Common/Locations/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"location_id"
],
"properties": {
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro locationId.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get location",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List jobs (projects) with identifier, name, active flag, dates, department, parent job and assigned locations. GET /v1/Time/Jobs.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_jobs",
"title": "List jobs",
"description": "List jobs (projects) with identifier, name, active flag, dates, department, parent job and assigned locations. GET /v1/Time/Jobs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List jobs",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One job by id. GET /v1/Time/Jobs/{id}.
| Parameter | Type | Description |
|---|---|---|
| job_id * | integer | Arcoro jobId. |
{
"name": "exaktime_get_job",
"title": "Get job",
"description": "One job by id. GET /v1/Time/Jobs/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro jobId.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get job",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List cost codes (phases and work activities that time is booked against) with identifier, name, active flag and cost type. GET /v1/Time/CostCodes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_cost_codes",
"title": "List cost codes",
"description": "List cost codes (phases and work activities that time is booked against) with identifier, name, active flag and cost type. GET /v1/Time/CostCodes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List cost codes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One cost code by id. GET /v1/Time/CostCodes/{id}.
| Parameter | Type | Description |
|---|---|---|
| cost_code_id * | integer | Arcoro cost code id. |
{
"name": "exaktime_get_cost_code",
"title": "Get cost code",
"description": "One cost code by id. GET /v1/Time/CostCodes/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cost_code_id"
],
"properties": {
"cost_code_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro cost code id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get cost code",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List cost types (groupings of cost codes, e.g. labor, equipment) with identifier, name and active flag. GET /v1/Time/CostTypes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_cost_types",
"title": "List cost types",
"description": "List cost types (groupings of cost codes, e.g. labor, equipment) with identifier, name and active flag. GET /v1/Time/CostTypes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List cost types",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List departments with identifier, name and active flag. GET /v1/Common/Departments.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_departments",
"title": "List departments",
"description": "List departments with identifier, name and active flag. GET /v1/Common/Departments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List departments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List job codes (positions / trades) with name, description and active flag. GET /v1/Common/JobCodes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_job_codes",
"title": "List job codes",
"description": "List job codes (positions / trades) with name, description and active flag. GET /v1/Common/JobCodes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List job codes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List pay schedules with frequency, first pay date, pay periods per year and the default flag. GET /v1/Payroll/PaySchedules.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_pay_schedules",
"title": "List pay schedules",
"description": "List pay schedules with frequency, first pay date, pay periods per year and the default flag. GET /v1/Payroll/PaySchedules.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List pay schedules",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List labor classes with identifier, name and active flag. GET /v1/Payroll/LaborClasses.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_labor_classes",
"title": "List labor classes",
"description": "List labor classes with identifier, name and active flag. GET /v1/Payroll/LaborClasses.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List labor classes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List payroll rate codes with identifier, name, description and whether it is the base rate. GET /v1/Payroll/RateCodes.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number, from 1 (default 1). Pass the previous reply's next_page. |
| page_size | integer | Results per page, 1-100 (default 50). |
{
"name": "exaktime_list_rate_codes",
"title": "List rate codes",
"description": "List payroll rate codes with identifier, name, description and whether it is the base rate. GET /v1/Payroll/RateCodes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100000,
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"exclusiveMinimum": 0
},
"page_size": {
"type": "integer",
"maximum": 100,
"description": "Results per page, 1-100 (default 50).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List rate codes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List time records (timecard entries: who worked, when, on which cost code and location, regular/overtime hours). Filter by work date range, person, location or cost code identifier; newest first. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimeRecords.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| to_date | string | Last work date to include (yyyy-mm-dd). |
| from_date | string | First work date to include (yyyy-mm-dd). |
| person_id | integer | Only this employee (personId). |
| all_fields | boolean | true: return every warehouse column (GPS, punch ids, modified-by...). Default: the main columns. |
| active_only | boolean | true: skip deleted/inactive records. |
| location_id | integer | Only this location (locationId). |
| cost_code_identifier | string | Only this cost code identifier. |
List raw clock punches (punch time, device type, location, network time difference). Filter by date range (UTC days), person or location; newest first. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimePunches.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| to_date | string | Last day to include (yyyy-mm-dd, UTC). |
| from_date | string | First day to include (yyyy-mm-dd, UTC). |
| person_id | integer | Only this employee (personId). |
| location_id | integer | Only this location (locationId). |
{
"name": "exaktime_list_time_punches",
"title": "List time punches",
"description": "List raw clock punches (punch time, device type, location, network time difference). Filter by date range (UTC days), person or location; newest first. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimePunches.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last day to include (yyyy-mm-dd, UTC)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First day to include (yyyy-mm-dd, UTC)."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee (personId).",
"exclusiveMinimum": 0
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this location (locationId).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List time punches",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List scheduled shifts (employee, start/end, title, cost code, location, notes). Filter by start date range (UTC days), person or location; newest first. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwShifts.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| to_date | string | Last start day to include (yyyy-mm-dd, UTC). |
| from_date | string | First start day to include (yyyy-mm-dd, UTC). |
| person_id | integer | Only this employee (personId). |
| location_id | integer | Only this location (locationId). |
{
"name": "exaktime_list_shifts",
"title": "List scheduled shifts",
"description": "List scheduled shifts (employee, start/end, title, cost code, location, notes). Filter by start date range (UTC days), person or location; newest first. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwShifts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last start day to include (yyyy-mm-dd, UTC)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First start day to include (yyyy-mm-dd, UTC)."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee (personId).",
"exclusiveMinimum": 0
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this location (locationId).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List scheduled shifts",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List pay periods (id, start and end date, closed or open, type), newest first. Use the id to find approvals. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwPayPeriods.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| to_date | string | Pay periods starting on or before this date. |
| from_date | string | Pay periods starting on or after this date. |
| is_closed | boolean | true: only closed periods; false: only open ones. |
{
"name": "exaktime_list_pay_periods",
"title": "List pay periods",
"description": "List pay periods (id, start and end date, closed or open, type), newest first. Use the id to find approvals. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwPayPeriods.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Pay periods starting on or before this date."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Pay periods starting on or after this date."
},
"is_closed": {
"type": "boolean",
"description": "true: only closed periods; false: only open ones."
}
}
},
"annotations": {
"title": "List pay periods",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List time off requests (employee, plan, start/end date, hours, status, comments, manager). Filter by status, person or start-date range. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimeOffRequests.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| status | string | Request status exactly as Arcoro shows it, e.g. Pending, Approved, Denied. |
| to_date | string | Requests starting on or before this date. |
| from_date | string | Requests starting on or after this date. |
| person_id | integer | Only this employee (personId). |
{
"name": "exaktime_list_time_off_requests",
"title": "List time off requests",
"description": "List time off requests (employee, plan, start/end date, hours, status, comments, manager). Filter by status, person or start-date range. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimeOffRequests.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"status": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Request status exactly as Arcoro shows it, e.g. Pending, Approved, Denied."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Requests starting on or before this date."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Requests starting on or after this date."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee (personId).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List time off requests",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List time off balances per employee and plan (balance hours, maximum balance, manager). Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimeOffBalances.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| person_id | integer | Only this employee (personId). |
| plan_name | string | Only this time off plan, exact name. |
{
"name": "exaktime_list_time_off_balances",
"title": "List time off balances",
"description": "List time off balances per employee and plan (balance hours, maximum balance, manager). Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimeOffBalances.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee (personId).",
"exclusiveMinimum": 0
},
"plan_name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Only this time off plan, exact name."
}
}
},
"annotations": {
"title": "List time off balances",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List daily timecard approvals (work date, approval type, who approved and when, the employee). Filter by work date range or employee. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwWorkDateTimeApprovals.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| to_date | string | Last work date to include. |
| from_date | string | First work date to include. |
| person_id | integer | Only this employee's timecards (personId). |
{
"name": "exaktime_list_timecard_approvals",
"title": "List daily timecard approvals",
"description": "List daily timecard approvals (work date, approval type, who approved and when, the employee). Filter by work date range or employee. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwWorkDateTimeApprovals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last work date to include."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First work date to include."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee's timecards (personId).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List daily timecard approvals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List pay period (timesheet) approvals and sign-offs: pay period, approval type, approver, time, employee, comment. Use it to see who has not yet signed off. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwPayPeriodApprovals.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| person_id | integer | Only this employee's timesheets (personId). |
| pay_period_id | integer | Only this pay period (from exaktime_list_pay_periods). |
{
"name": "exaktime_list_pay_period_approvals",
"title": "List pay period approvals",
"description": "List pay period (timesheet) approvals and sign-offs: pay period, approval type, approver, time, employee, comment. Use it to see who has not yet signed off. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwPayPeriodApprovals.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee's timesheets (personId).",
"exclusiveMinimum": 0
},
"pay_period_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this pay period (from exaktime_list_pay_periods).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List pay period approvals",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List meal break compliance violations (type, date, expected vs actual value) linked to a time record id. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwMealBreakViolations.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| to_date | string | Last violation date to include. |
| from_date | string | First violation date to include. |
| time_record_id | string | Only violations of this time record. |
{
"name": "exaktime_list_meal_break_violations",
"title": "List meal break violations",
"description": "List meal break compliance violations (type, date, expected vs actual value) linked to a time record id. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwMealBreakViolations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last violation date to include."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First violation date to include."
},
"time_record_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Only violations of this time record."
}
}
},
"annotations": {
"title": "List meal break violations",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Read-only OData query over any Arcoro data warehouse entity set, for questions the other tools do not cover (equipment, expenses, users, time records by hour group, learning, performance, recruiting, benefits...). Entity sets start with Dw, e.g. DwUsers, DwEquipments, DwExpenses, DwCostCodes, DwLocations, DwTimeRecordByHourGroups, DwEmploymentStatusHistories. Full list: https://my.arcoro.com/api/odata ; schema: https://api.arcoro.com/odata/$metadata. $filter uses OData v4 syntax, e.g. startswith(LastName,'Sm') and IsActive eq true. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/{EntitySet}.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows to return, 1-1000 (default 100). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | OData $filter expression. |
| select | string | Comma-separated property names ($select). |
| orderby | string | OData $orderby, e.g. LastName,FirstName desc. |
| entity_set * | string | Entity set name, e.g. DwUsers. |
{
"name": "exaktime_query_odata",
"title": "Query any OData entity set",
"description": "Read-only OData query over any Arcoro data warehouse entity set, for questions the other tools do not cover (equipment, expenses, users, time records by hour group, learning, performance, recruiting, benefits...). Entity sets start with Dw, e.g. DwUsers, DwEquipments, DwExpenses, DwCostCodes, DwLocations, DwTimeRecordByHourGroups, DwEmploymentStatusHistories. Full list: https://my.arcoro.com/api/odata ; schema: https://api.arcoro.com/odata/$metadata. $filter uses OData v4 syntax, e.g. startswith(LastName,'Sm') and IsActive eq true. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/{EntitySet}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"entity_set"
],
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"filter": {
"type": "string",
"maxLength": 2000,
"description": "OData $filter expression."
},
"select": {
"type": "string",
"maxLength": 1000,
"description": "Comma-separated property names ($select)."
},
"orderby": {
"type": "string",
"maxLength": 500,
"description": "OData $orderby, e.g. LastName,FirstName desc."
},
"entity_set": {
"type": "string",
"pattern": "^Dw[A-Za-z0-9]{1,80}$",
"description": "Entity set name, e.g. DwUsers."
}
}
},
"annotations": {
"title": "Query OData entity set",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}WRITE: create a job (project) that employees can book time to. Identifier must be unique. The job appears in Arcoro right away; it can be deactivated again with exaktime_update_job (there is no delete). POST /v1/Time/Jobs.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Job name. |
| end_date | string | Job end date. |
| is_active | boolean | Active jobs can be selected for time entry. |
| identifier * | string | Your unique job number/identifier. |
| start_date | string | Job start date. |
| is_certified | boolean | Certified payroll job. |
| location_ids | array | Location ids the job is limited to (exaktime_list_locations). Setting them turns off 'available at all locations'. |
| all_locations | boolean | true: the job is available at every location; false: only at location_ids. |
| department_id | integer | Department id (exaktime_list_departments). |
| parent_job_id | integer |
WRITE: change fields of an existing job (rename it, set dates, assign locations, or set is_active=false to close it). Only the fields you pass change (null clears a nullable field); the tool reads the job first and sends the full object, because Arcoro replaces the job on PUT. Two edits to the same job at the same moment can overwrite each other: run them one after the other. PUT /v1/Time/Jobs/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | Job name. |
| job_id * | integer | Arcoro jobId. |
| end_date | any | Job end date, or null to clear it. |
| is_active | boolean | Active jobs can be selected for time entry. |
| identifier | string | Your unique job number/identifier. |
| start_date | any | Job start date, or null to clear it. |
| is_certified | boolean | Certified payroll job. |
| location_ids | array | Location ids the job is limited to (exaktime_list_locations). Setting them turns off 'available at all locations'. |
| all_locations | boolean |
WRITE: create a cost code (phase or work activity) that time can be booked against. The name must be unique. It can be deactivated again with exaktime_update_cost_code (there is no delete). POST /v1/Time/CostCodes.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Cost code name (unique). |
| is_active | boolean | Default true. |
| identifier * | string | Your unique cost code identifier. |
| cost_type_id | integer | Cost type id (exaktime_list_cost_types). |
| display_option | string | Default: selectable by users. System: system-defined, hidden from users. |
{
"name": "exaktime_create_cost_code",
"title": "Create cost code",
"description": "WRITE: create a cost code (phase or work activity) that time can be booked against. The name must be unique. It can be deactivated again with exaktime_update_cost_code (there is no delete). POST /v1/Time/CostCodes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Cost code name (unique)."
},
"is_active": {
"type": "boolean",
"description": "Default true."
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your unique cost code identifier."
},
"cost_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Cost type id (exaktime_list_cost_types).",
"exclusiveMinimum": 0
},
"display_option": {
"enum": [
"Default",
"System"
],
"type": "string",
"description": "Default: selectable by users. System: system-defined, hidden from users."
}
}
},
"annotations": {
"title": "Create cost code",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}WRITE: change fields of an existing cost code (rename it, change its cost type, or set is_active=false to retire it). Only the fields you pass change; the tool reads the cost code first and sends the full object. PUT /v1/Time/CostCodes/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| is_active | boolean | |
| identifier | string | |
| cost_code_id * | integer | Arcoro cost code id. |
| cost_type_id | integer | |
| display_option | string | Default: selectable by users. System: system-defined, hidden from users. |
{
"name": "exaktime_update_cost_code",
"title": "Update cost code",
"description": "WRITE: change fields of an existing cost code (rename it, change its cost type, or set is_active=false to retire it). Only the fields you pass change; the tool reads the cost code first and sends the full object. PUT /v1/Time/CostCodes/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cost_code_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"is_active": {
"type": "boolean"
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"cost_code_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro cost code id.",
"exclusiveMinimum": 0
},
"cost_type_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"display_option": {
"enum": [
"Default",
"System"
],
"type": "string",
"description": "Default: selectable by users. System: system-defined, hidden from users."
}
}
},
"annotations": {
"title": "Update cost code",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: create a location (job site or office). Add the address and/or latitude and longitude so geofencing and maps work. It can be deactivated again with exaktime_update_location (there is no delete). POST /v1/Common/Locations.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Location name. |
| address | object | Street address; every field except address_line2 is required by Arcoro. |
| comments | string | |
| latitude | number | |
| is_active | boolean | Default true. |
| is_office | boolean | |
| longitude | number | |
| identifier | string | Your location identifier. |
| is_time_and_attendance | boolean | Employees can clock in at this location. |
| onboarding_business_unit_id | integer | Onboarding business unit id; Arcoro requires it for an office when Onboarding business units are enabled. |
WRITE: change fields of an existing location (rename, move, new address, or set is_active=false to retire it). Only the fields you pass change; the tool reads the location first and sends the full object. PUT /v1/Common/Locations/{id}.
| Parameter | Type | Description |
|---|---|---|
| name | string | |
| address | object | Street address; every field except address_line2 is required by Arcoro. |
| comments | string | |
| latitude | number | |
| is_active | boolean | |
| is_office | boolean | |
| longitude | number | |
| identifier | string | |
| location_id * | integer | Arcoro locationId. |
| is_time_and_attendance | boolean | |
| onboarding_business_unit_id | integer |
Tools for ExakTime (Arcoro Time), hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Who worked on the Main Street job last week and how many overtime hours did they log?"; "Which employees have not signed off the current pay period?"; "Show pending time off requests for this month.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes ExakTime (Arcoro Time) data. Free plan: 50 tool calls per month. Run exaktime_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 exaktime_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 exaktime_upgrade without a plan: it returns both plans, each with a payment link for the user to open. exaktime_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.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "exaktime_list_time_records",
"title": "List time records",
"description": "List time records (timecard entries: who worked, when, on which cost code and location, regular/overtime hours). Filter by work date range, person, location or cost code identifier; newest first. Source: the read-only OData data warehouse, refreshed nightly, so today's entries may not show until tomorrow. Page with skip/next_skip. GET /odata/DwTimeRecords.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 1000,
"description": "Rows to return, 1-1000 (default 100).",
"exclusiveMinimum": 0
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip."
},
"to_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Last work date to include (yyyy-mm-dd)."
},
"from_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "First work date to include (yyyy-mm-dd)."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this employee (personId).",
"exclusiveMinimum": 0
},
"all_fields": {
"type": "boolean",
"description": "true: return every warehouse column (GPS, punch ids, modified-by...). Default: the main columns."
},
"active_only": {
"type": "boolean",
"description": "true: skip deleted/inactive records."
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this location (locationId).",
"exclusiveMinimum": 0
},
"cost_code_identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Only this cost code identifier."
}
}
},
"annotations": {
"title": "List time records",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| Parent job id, to create a sub-job. |
{
"name": "exaktime_create_job",
"title": "Create job",
"description": "WRITE: create a job (project) that employees can book time to. Identifier must be unique. The job appears in Arcoro right away; it can be deactivated again with exaktime_update_job (there is no delete). POST /v1/Time/Jobs.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"identifier"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Job name."
},
"end_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Job end date."
},
"is_active": {
"type": "boolean",
"description": "Active jobs can be selected for time entry."
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your unique job number/identifier."
},
"start_date": {
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Job start date."
},
"is_certified": {
"type": "boolean",
"description": "Certified payroll job."
},
"location_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 500,
"description": "Location ids the job is limited to (exaktime_list_locations). Setting them turns off 'available at all locations'."
},
"all_locations": {
"type": "boolean",
"description": "true: the job is available at every location; false: only at location_ids."
},
"department_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Department id (exaktime_list_departments).",
"exclusiveMinimum": 0
},
"parent_job_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Parent job id, to create a sub-job.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create job",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| true: the job is available at every location; false: only at location_ids. |
| department_id | any | Department id, or null to clear it. |
| parent_job_id | any | Parent job id, or null to detach the job from its parent. |
{
"name": "exaktime_update_job",
"title": "Update job",
"description": "WRITE: change fields of an existing job (rename it, set dates, assign locations, or set is_active=false to close it). Only the fields you pass change (null clears a nullable field); the tool reads the job first and sends the full object, because Arcoro replaces the job on PUT. Two edits to the same job at the same moment can overwrite each other: run them one after the other. PUT /v1/Time/Jobs/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Job name."
},
"job_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro jobId.",
"exclusiveMinimum": 0
},
"end_date": {
"anyOf": [
{
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Job end date."
},
{
"type": "null"
}
],
"description": "Job end date, or null to clear it."
},
"is_active": {
"type": "boolean",
"description": "Active jobs can be selected for time entry."
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your unique job number/identifier."
},
"start_date": {
"anyOf": [
{
"type": "string",
"pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
"description": "Job start date."
},
{
"type": "null"
}
],
"description": "Job start date, or null to clear it."
},
"is_certified": {
"type": "boolean",
"description": "Certified payroll job."
},
"location_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 500,
"description": "Location ids the job is limited to (exaktime_list_locations). Setting them turns off 'available at all locations'."
},
"all_locations": {
"type": "boolean",
"description": "true: the job is available at every location; false: only at location_ids."
},
"department_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"description": "Department id (exaktime_list_departments).",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Department id, or null to clear it."
},
"parent_job_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"description": "Parent job id, to create a sub-job.",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "Parent job id, or null to detach the job from its parent."
}
}
},
"annotations": {
"title": "Update job",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "exaktime_create_location",
"title": "Create location",
"description": "WRITE: create a location (job site or office). Add the address and/or latitude and longitude so geofencing and maps work. It can be deactivated again with exaktime_update_location (there is no delete). POST /v1/Common/Locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Location name."
},
"address": {
"type": "object",
"required": [
"address_line1",
"city",
"country_code",
"state_code",
"postal_code"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"state_code": {
"type": "string",
"maxLength": 10,
"minLength": 1,
"description": "State/province code, e.g. TX."
},
"postal_code": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"country_code": {
"type": "string",
"maxLength": 3,
"minLength": 2,
"description": "ISO country code, e.g. US."
},
"address_line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address_line2": {
"type": "string",
"maxLength": 200
}
},
"description": "Street address; every field except address_line2 is required by Arcoro."
},
"comments": {
"type": "string",
"maxLength": 2000
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"is_active": {
"type": "boolean",
"description": "Default true."
},
"is_office": {
"type": "boolean"
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Your location identifier."
},
"is_time_and_attendance": {
"type": "boolean",
"description": "Employees can clock in at this location."
},
"onboarding_business_unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Onboarding business unit id; Arcoro requires it for an office when Onboarding business units are enabled.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create location",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| Onboarding business unit id; Arcoro requires it for an office when Onboarding business units are enabled. |
{
"name": "exaktime_update_location",
"title": "Update location",
"description": "WRITE: change fields of an existing location (rename, move, new address, or set is_active=false to retire it). Only the fields you pass change; the tool reads the location first and sends the full object. PUT /v1/Common/Locations/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"location_id"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address": {
"type": "object",
"required": [
"address_line1",
"city",
"country_code",
"state_code",
"postal_code"
],
"properties": {
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"state_code": {
"type": "string",
"maxLength": 10,
"minLength": 1,
"description": "State/province code, e.g. TX."
},
"postal_code": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"country_code": {
"type": "string",
"maxLength": 3,
"minLength": 2,
"description": "ISO country code, e.g. US."
},
"address_line1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address_line2": {
"type": "string",
"maxLength": 200
}
},
"description": "Street address; every field except address_line2 is required by Arcoro."
},
"comments": {
"type": "string",
"maxLength": 2000
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"is_active": {
"type": "boolean"
},
"is_office": {
"type": "boolean"
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"identifier": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"location_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Arcoro locationId.",
"exclusiveMinimum": 0
},
"is_time_and_attendance": {
"type": "boolean"
},
"onboarding_business_unit_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Onboarding business unit id; Arcoro requires it for an office when Onboarding business units are enabled.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Update location",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}