McTime API

Name: McTime API
Brand: McTime API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHR recruitingEmployee ManagementapiKey18 EndpointsREST

For Agents

Track time entries, manage shift assignments, run clock in/out events, and prepare payroll for McTime's workforce management platform.

Install Jentic One Beta

Connect the McTime API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the McTime API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with McTime API.

Record clock-in and clock-out events for an employee

Create, update, and approve time entries against an assignment

Manage user accounts including roles and active status

Manage organisations and their hierarchical structure

GET STARTED

Start building with McTime API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use McTime API for, with concrete tasks.

★ Kiosk-Based Clock In/Out

Power a tablet kiosk or chat-based attendance flow that lets shift workers clock in and out without using the full McTime web app. The /clock endpoint accepts the user id and an in/out event, returning the recorded entry. Operations managers deploy this in warehouses, restaurants, and care homes where workers do not have desk access.

Call POST /clock with user_id=123 and event=in to record a clock-in for the current shift, then return the new time entry id.

Manager Approval Dashboard

Surface pending time entries to managers and let them approve, edit, or reject them in bulk. The /times endpoint returns entries filtered by assignment or status, and individual entries can be updated via /times/{id}. Agents typically build this on top of an existing manager portal so approvals happen in seconds rather than minutes.

List time entries with status='pending' for assignments owned by manager_id 7, then update each to status='approved' after the agent has applied the team's overtime rules.

Payroll Export Preparation

Roll up approved time entries by user and pay period and produce a payroll export ready for ingestion into a payroll system. The /times endpoint supports filtering by approval status and date range, and /assignments provides the mapping to cost centres and pay rates. This compresses the manual payroll-prep cycle and reduces transcription errors before paychecks are issued.

List all approved time entries between 2026-06-01 and 2026-06-15, group by user and assignment, calculate total regular and overtime hours, and return a CSV ready for payroll import.

AI Agent for Attendance Anomalies

Build an agent that watches McTime time entries each morning, flags employees who clocked in late, missed a punch, or worked unscheduled hours, and posts a summary to the operations channel. The agent searches Jentic for 'list McTime time entries', loads the listing schema, and executes calls with vault credentials. Operations leads use the digest to address attendance issues the same day rather than at the end of the pay period.

List all time entries for yesterday, identify entries where clock-in was more than 10 minutes after the scheduled assignment start, and return a list of user names with their lateness in minutes.

Key Endpoints

18 endpoints — jentic publishes the only available openapi specification for mctime api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/times

List time entries

GET

/times/{id}

Retrieve a time entry

POST

/clock

Record a clock-in or clock-out event

GET

/users

List users

GET

/users/{id}

Retrieve a user

GET

/organizations

List organisations

GET

/assignments

List assignments

GET

/times

List time entries

GET

/times/{id}

Retrieve a time entry

POST

/clock

Record a clock-in or clock-out event

GET

/users

List users

GET

/users/{id}

Retrieve a user

GET

/organizations

List organisations

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

McTime API keys are stored encrypted in the Jentic vault (MAXsystem) and injected into the API_KEY header at execution time. Agents receive scoped access only and the raw key never appears in their context.

Intent-based discovery

Agents search Jentic by intent (e.g. 'clock in a McTime employee') and Jentic returns the matching McTime operation with its input schema, so the agent can call the right endpoint without browsing mctime.readme.io.

Time to first call

Direct McTime integration: 2-4 days for API-key setup, clock-event handling, and payroll-export logic. Through Jentic: under 1 hour — search, load, execute.

FAQs

Specific to using McTime API through Jentic.

Why is there no official OpenAPI spec for McTime API?

McTime does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call McTime API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the McTime API use?

McTime uses an API key passed in the API_KEY header. Through Jentic, the key is stored encrypted in the MAXsystem vault and attached to outbound requests at execution time, so the raw key never enters the agent's prompt or transcript.

Can I clock employees in and out with the McTime API?

Yes. POST /clock accepts the user id and an in/out event and records a punch against the active shift. This is the primary endpoint for kiosk or chat-based attendance flows where users do not log into the full McTime app.

What are the rate limits for the McTime API?

Rate limits are documented at mctime.readme.io and vary by plan tier. The API responds with 429 status codes when limits are exceeded; agents should respect Retry-After headers and back off exponentially during bulk operations like nightly payroll prep.

How do I approve a time entry through Jentic?

Search Jentic for 'approve a McTime time entry', load the schema for the time-entry update operation under /times/{id}, and execute with status='approved'. Jentic attaches the API_KEY header automatically and returns the updated entry.

Can the McTime API export approved hours for payroll?

Yes. GET /times supports filtering by approval status and date range; aggregating the result by user and assignment produces the rows needed for a payroll import. Agents typically run this once per pay period and emit a CSV mapped to the payroll system's expected schema.

Does the McTime API expose scheduling?

Yes. GET /assignments returns shifts, projects, or cost codes that employees are assigned to, with start and end dates. Combined with /times, this lets agents compare scheduled to actual hours and flag attendance anomalies.