Microkeeper MCP by usefulapi is an MCP server published by io.usefulapi, hosted at microkeeper.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including microkeeper_get_employees, microkeeper_get_group_config, microkeeper_get_locations, microkeeper_get_roles, microkeeper_get_jobs.
Read staff, rosters, timesheets and leave, and add or update staff in Microkeeper.
4,033 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Read staff profiles. Give changed_since (yyyy-mm-dd, up to a year back) for everyone changed since then, or ids with id_type for specific staff. With neither, returns all active staff. Action get_employees (HR/Staff, Read Only).
| Parameter | Type | Description |
|---|---|---|
| ids | array | Staff IDs of the kind in id_type. |
| id_type | string | The kind of ID in ids. |
| changed_since | string | Staff changed on or after this date. |
{
"name": "microkeeper_get_employees",
"title": "Get employees",
"description": "Read staff profiles. Give changed_since (yyyy-mm-dd, up to a year back) for everyone changed since then, or ids with id_type for specific staff. With neither, returns all active staff. Action get_employees (HR/Staff, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Staff IDs of the kind in id_type."
},
"id_type": {
"enum": [
"EmployeeID",
"EID",
"eusername"
],
"type": "string",
"description": "The kind of ID in ids."
},
"changed_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Staff changed on or after this date."
}
}
},
"annotations": {
"title": "Get employees",
"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.
Read the account's Groups (teams and sites that staff belong to). Action get_group_config (HR/Staff, Read Only).
| Parameter | Type | Description |
|---|---|---|
| active_status | string | Default "active". |
{
"name": "microkeeper_get_group_config",
"title": "Get groups",
"description": "Read the account's Groups (teams and sites that staff belong to). Action get_group_config (HR/Staff, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"active_status": {
"enum": [
"active",
"hidden",
"all"
],
"type": "string",
"description": "Default \"active\"."
}
}
},
"annotations": {
"title": "Get groups",
"readOnlyHint": true
}
}Read every Location (site) with its LID, third_ID, address, active flag and managers. Action get_locations (Account, Read Only).
No parameters.
{
"name": "microkeeper_get_locations",
"title": "Get locations",
"description": "Read every Location (site) with its LID, third_ID, address, active flag and managers. Action get_locations (Account, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get locations",
"readOnlyHint": true
}
}Read every Role (active and inactive) with its ROID and required skills. Action get_roles (Account, Read Only).
No parameters.
{
"name": "microkeeper_get_roles",
"title": "Get roles",
"description": "Read every Role (active and inactive) with its ROID and required skills. Action get_roles (Account, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get roles",
"readOnlyHint": true
}
}Read Jobs (projects, sites or functions staff clock to). Give JID or JobID lists for specific Jobs; otherwise status all or finished. Action get_jobs (Account, Read Only).
| Parameter | Type | Description |
|---|---|---|
| JID | array | Microkeeper Job IDs. |
| JobID | array | Your software's Job IDs. |
| status | string | Default "all" (every Job that is not finished). |
{
"name": "microkeeper_get_jobs",
"title": "Get jobs",
"description": "Read Jobs (projects, sites or functions staff clock to). Give JID or JobID lists for specific Jobs; otherwise status all or finished. Action get_jobs (Account, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"JID": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Microkeeper Job IDs."
},
"JobID": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Your software's Job IDs."
},
"status": {
"enum": [
"all",
"finished"
],
"type": "string",
"description": "Default \"all\" (every Job that is not finished)."
}
}
},
"annotations": {
"title": "Get jobs",
"readOnlyHint": true
}
}Read rostered shifts for every employee at active Locations, for up to 31 days (inclusive). Action get_roster (Roster, Read Only).
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | Last day, yyyy-mm-dd. |
| start_date * | string | First day, yyyy-mm-dd. |
{
"name": "microkeeper_get_roster",
"title": "Get roster",
"description": "Read rostered shifts for every employee at active Locations, for up to 31 days (inclusive). Action get_roster (Roster, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
}
}
},
"annotations": {
"title": "Get roster",
"readOnlyHint": true
}
}Read worked shifts for up to 31 days (inclusive), for all staff or the usernames given. Action get_timesheet (Roster, Read Only).
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | |
| eusernames | array | Microkeeper usernames. Leave out for all staff. |
| start_date * | string |
{
"name": "microkeeper_get_timesheet",
"title": "Get timesheets",
"description": "Read worked shifts for up to 31 days (inclusive), for all staff or the usernames given. Action get_timesheet (Roster, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"eusernames": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Microkeeper usernames. Leave out for all staff."
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "Get timesheets",
"readOnlyHint": true
}
}Read leave requests that start, end or run through a date range: type, dates and status. Action get_leave (Payroll, Read Only).
| Parameter | Type | Description |
|---|---|---|
| end_date * | string | |
| start_date * | string |
{
"name": "microkeeper_get_leave",
"title": "Get leave requests",
"description": "Read leave requests that start, end or run through a date range: type, dates and status. Action get_leave (Payroll, Read Only).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"start_date",
"end_date"
],
"properties": {
"end_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"start_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
}
},
"annotations": {
"title": "Get leave requests",
"readOnlyHint": true
}
}Add new staff or update existing ones (matched by EmployeeID, then eusername, then EID). Only the fields you send change. A new employee gets a login email only if you set welcome. Action upsert_employees (HR/Staff, Read/Write).
| Parameter | Type | Description |
|---|---|---|
| employees * | array | Staff to add or update. |
{
"name": "microkeeper_upsert_employees",
"title": "Add or update employees",
"description": "Add new staff or update existing ones (matched by EmployeeID, then eusername, then EID). Only the fields you send change. A new employee gets a login email only if you set welcome. Action upsert_employees (HR/Staff, Read/Write).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"employees"
],
"properties": {
"employees": {
"type": "array",
"items": {
"type": "object",
"required": [
"firstname",
"lastname"
],
"properties": {
"EID": {
"type": "string",
"description": "Microkeeper's employee ID. Updates only."
},
"city": {
"type": "string"
},
"email": {
"type": "string",
"description": "Changing it asks the employee to verify the new address."
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"phoneno": {
"type": "string",
"description": "Changing it asks the employee to verify the new number."
},
"lastname": {
"type": "string",
"minLength": 1,
"description": "Required on every employee, updates included."
},
"postcode": {
"type": "string"
},
"eusername": {
"type": "string",
"description": "Microkeeper username. Updates only."
},
"firstname": {
"type": "string",
"minLength": 1,
"description": "Required on every employee, updates included."
},
"EmployeeID": {
"type": "string",
"description": "Your software's ID for the person. A known ID updates; a new ID adds."
}
},
"additionalProperties": {}
},
"minItems": 1,
"description": "Staff to add or update."
}
}
},
"annotations": {
"title": "Add or update employees",
"idempotentHint": true,
"destructiveHint": true
}
}Add Locations or update them (matched by LID, or by third_ID). Locations you do not send stay as they are. Action upsert_locations (Account, Read/Write).
| Parameter | Type | Description |
|---|---|---|
| locations * | array | Locations to add or update. |
{
"name": "microkeeper_upsert_locations",
"title": "Add or update locations",
"description": "Add Locations or update them (matched by LID, or by third_ID). Locations you do not send stay as they are. Action upsert_locations (Account, Read/Write).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"locations"
],
"properties": {
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"active"
],
"properties": {
"LID": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Microkeeper's Location ID. A known LID updates; 0 with a new third_ID adds."
},
"title": {
"type": "string",
"minLength": 1
},
"active": {
"enum": [
"0",
"1"
],
"type": "string",
"description": "\"1\" active, \"0\" inactive."
},
"third_ID": {
"type": "string",
"description": "Your software's ID for the Location."
},
"manager_eusername": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": {}
},
"minItems": 1,
"description": "Locations to add or update."
}
}
},
"annotations": {
"title": "Add or update locations",
"idempotentHint": true,
"destructiveHint": true
}
}Add Jobs or update them (matched by JobID, or by JID; JID 0 adds). Jobs you do not send are not changed. Action update_jobs (Account, Read/Write).
| Parameter | Type | Description |
|---|---|---|
| jobs * | array | Jobs to add or update. |
{
"name": "microkeeper_update_jobs",
"title": "Add or update jobs",
"description": "Add Jobs or update them (matched by JobID, or by JID; JID 0 adds). Jobs you do not send are not changed. Action update_jobs (Account, Read/Write).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"jobs"
],
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "object",
"required": [
"title"
],
"properties": {
"JID": {
"type": [
"string",
"number"
],
"description": "Microkeeper's Job ID. 0 adds a Job."
},
"JobID": {
"type": "string",
"description": "Your software's ID for the Job."
},
"title": {
"type": "string",
"minLength": 1
},
"status": {
"enum": [
"Active",
"Finished"
],
"type": "string"
},
"enddate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"startdate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"additionalProperties": {}
},
"minItems": 1,
"description": "Jobs to add or update."
}
}
},
"annotations": {
"title": "Add or update jobs",
"idempotentHint": true,
"destructiveHint": true
}
}Tools for Microkeeper, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Who is rostered at our Melbourne site next week?"; "Which staff have leave requests in the next month?"; "Show the timesheets for the last 7 days for all staff.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Microkeeper data. Free plan: 50 tool calls per month. Run microkeeper_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 microkeeper_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 microkeeper_upgrade without a plan: it returns both plans, each with a payment link for the user to open. microkeeper_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.