Protime MCP by usefulapi is an MCP server published by io.usefulapi, hosted at protime.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 12 tools, including protime_list_clockings, protime_list_absences, protime_list_assignments, protime_list_contracts, protime_list_people.
Read clockings, absences, assignments, contracts, people and departments in Protime.
4,042 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 time clockings (in/out, reasons, activities) for a date range. Deleted clockings have status Deleted. Location data is left out. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-clockings.read.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Last day, yyyy-mm-dd. |
| from * | string | First day, yyyy-mm-dd. |
| kind | string | one of ["InOut","Reason","Activity","ActivityEnd"] |
| person | array | Internal person IDs. Leave out for all people. |
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.
| continuationToken |
| string |
| continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_clockings",
"title": "List clockings",
"description": "List time clockings (in/out, reasons, activities) for a date range. Deleted clockings have status Deleted. Location data is left out. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-clockings.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"kind": {
"enum": [
"InOut",
"Reason",
"Activity",
"ActivityEnd"
],
"type": "string"
},
"person": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"description": "Internal person IDs. Leave out for all people."
},
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List clockings",
"readOnlyHint": true
}
}List absence instances (leave, sickness) for a date range. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absences.read.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Last day, yyyy-mm-dd. |
| from * | string | First day, yyyy-mm-dd. |
| person | array | Internal person IDs. Leave out for all people. |
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_absences",
"title": "List absences",
"description": "List absence instances (leave, sickness) for a date range. A date range is required (at most one year). Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absences.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"person": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"description": "Internal person IDs. Leave out for all people."
},
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List absences",
"readOnlyHint": true
}
}List work assignments (planned and registered activities) for a date range. A date range is required. Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-assignments.read.
| Parameter | Type | Description |
|---|---|---|
| to * | string | Last day, yyyy-mm-dd. |
| from * | string | First day, yyyy-mm-dd. |
| person | array | Internal person IDs. Leave out for all people. |
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_assignments",
"title": "List assignments",
"description": "List work assignments (planned and registered activities) for a date range. A date range is required. Returns one page: pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-assignments.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"person": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"description": "Internal person IDs. Leave out for all people."
},
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List assignments",
"readOnlyHint": true
}
}List employment contracts (percentage, hours, dates). Optional person filter. Returns one page: pass continuationToken for the next. Read only. Needs scope connector-protimeapi-contracts.read.
| Parameter | Type | Description |
|---|---|---|
| person | array | Internal person IDs. Leave out for all people. |
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_contracts",
"title": "List contracts",
"description": "List employment contracts (percentage, hours, dates). Optional person filter. Returns one page: pass continuationToken for the next. Read only. Needs scope connector-protimeapi-contracts.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"person": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"description": "Internal person IDs. Leave out for all people."
},
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List contracts",
"readOnlyHint": true
}
}List people with name, work email and service dates. Home address, birth date, bank, passport and social security data are never returned. Optional person filter. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-people.read.
| Parameter | Type | Description |
|---|---|---|
| person | array | Internal person IDs. Leave out for all people. |
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_people",
"title": "List people",
"description": "List people with name, work email and service dates. Home address, birth date, bank, passport and social security data are never returned. Optional person filter. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-people.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"person": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 100,
"description": "Internal person IDs. Leave out for all people."
},
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List people",
"readOnlyHint": true
}
}List all departments configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-departments.read.
| Parameter | Type | Description |
|---|---|---|
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_departments",
"title": "List departments",
"description": "List all departments configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-departments.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List departments",
"readOnlyHint": true
}
}List all jobs configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-jobs.read.
| Parameter | Type | Description |
|---|---|---|
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_jobs",
"title": "List jobs",
"description": "List all jobs configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-jobs.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List jobs",
"readOnlyHint": true
}
}List all work locations configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-work-locations.read.
| Parameter | Type | Description |
|---|---|---|
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_work_locations",
"title": "List work locations",
"description": "List all work locations configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-work-locations.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List work locations",
"readOnlyHint": true
}
}List all shift definitions (codes and names) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-shift-definitions.read.
| Parameter | Type | Description |
|---|---|---|
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_shift_definitions",
"title": "List shift definitions (codes and names)",
"description": "List all shift definitions (codes and names) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-shift-definitions.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List shift definitions (codes and names)",
"readOnlyHint": true
}
}List all absence definitions (codes, groups) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-definitions.read.
| Parameter | Type | Description |
|---|---|---|
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_absence_definitions",
"title": "List absence definitions (codes, groups)",
"description": "List all absence definitions (codes, groups) configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-definitions.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List absence definitions (codes, groups)",
"readOnlyHint": true
}
}List all absence groups configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-groups.read.
| Parameter | Type | Description |
|---|---|---|
| continuationToken | string | continuationToken from the previous page (use the same other arguments). |
{
"name": "protime_list_absence_groups",
"title": "List absence groups",
"description": "List all absence groups configured in the tenant. No filters. Pass continuationToken for the next page. Read only. Needs scope connector-protimeapi-absence-groups.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"continuationToken": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "continuationToken from the previous page (use the same other arguments)."
}
}
},
"annotations": {
"title": "List absence groups",
"readOnlyHint": true
}
}Get one person by internal ID: name, work email, service dates. Sensitive personal data is never returned. Read only. Needs scope connector-protimeapi-people.read.
| Parameter | Type | Description |
|---|---|---|
| id * | integer |
{
"name": "protime_get_person",
"title": "Get person",
"description": "Get one person by internal ID: name, work email, service dates. Sensitive personal data is never returned. Read only. Needs scope connector-protimeapi-people.read.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get person",
"readOnlyHint": true
}
}Tools for Protime, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show the clockings of person 42 for last week."; "Who is absent next Monday, and with which absence type?"; "List all departments and work locations in our Protime tenant.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Protime data. Free plan: 50 tool calls per month. Run protime_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 protime_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 protime_upgrade without a plan: it returns both plans, each with a payment link for the user to open. protime_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.