Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Employment Hero Payroll MCP by usefulapi is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Read Employment Hero Payroll pay runs, payslips, timesheets and leave; approve or decline leave.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http employment-hero-payroll-mcp-by-usefulapi https://keypay.usefulapi.io/mcp
# 2 — ask your agent for something these tools do
# keypay_get_user, keypay_list_businesses, keypay_get_business and 23 more
Employment Hero Payroll MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http employment-hero-payroll-mcp-by-usefulapi https://keypay.usefulapi.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
26 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
The Employment Hero Payroll user this API key belongs to: id, email, display name and time zone. GET /user.
No parameter schema on file.
List the payroll businesses this user can access: id, name, region, legal name, contact details, pay cycle, number of employees. Start here: most other tools need a business id. GET /business (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
One business by id: name, legal name, contact, address, ABN/company details, leave year, standard hours, pay cycle. GET /business/{businessId}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
List the business's employees with basic details: id, name, preferred name, gender, date of birth, contact details, address, start and end date, external id. Tax file, bank and super details are not part of this list. Filter with OData, e.g. "Surname eq 'Smith'". GET /business/{businessId}/employee/details (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
One employee's full record: name, contact, employment type, status, start/end date, pay schedule, primary location and pay category, rate and rate unit, hours per week, award, leave template, work types, tags. Tax file / national insurance / IRD / NRIC numbers, bank accounts and super member numbers are removed. GET /business/{businessId}/employee/unstructured/{employeeId}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| employee_id | integer | yes | Employee id (from keypay_list_employees). |
An employee's leave balances per leave category (accrued amount and unit), optionally as at a date. GET /business/{businessId}/employee/{employeeId}/leavebalances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| employee_id | integer | yes | Employee id. |
| as_at_date | string | no | Balance as at this date (yyyy-mm-dd); default today. |
List the business's pay runs: id, pay schedule, pay period start/end, date paid, finalised flag, payslips published, notation. Newest first with orderby "PayPeriodEnding desc". GET /business/{businessId}/payrun (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
One pay run by id: pay schedule, period, date paid, whether it is finalised, notation. GET /business/{businessId}/payrun/{payRunId}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| pay_run_id | integer | yes | Pay run id (from keypay_list_pay_runs). |
Pay runs with their totals: total hours, gross wages and net wages, plus the usual pay run fields. GET /business/{businessId}/payrun/summary (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
One pay run with its total hours, gross wages and net wages. GET /business/{businessId}/payrun/{payRunId}/summary.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| pay_run_id | integer | yes | Pay run id. |
Per-employee totals of a pay run (gross, net, tax withheld, super and the like; the fields depend on the region). Bank payment details are removed. GET /business/{businessId}/payrun/{payRunId}/totals.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| pay_run_id | integer | yes | Pay run id. |
Pay slip data for every employee in a pay run, keyed by employee: earnings lines, deductions, tax, super, leave taken and accrued, gross/net and year-to-date totals. Large for big pay runs. Bank account numbers and tax/identity numbers are removed. GET /business/{businessId}/payrun/{payRunId}/payslips.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| pay_run_id | integer | yes | Pay run id. |
| show_all_data | boolean | no | Include all pay slip data, not only what is printed on the slip (default false). |
Warnings on a pay run (for example an employee paid below their award rate or with a negative net pay): type, employee and message. GET /business/{businessId}/payrun/{payRunId}/warnings.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| pay_run_id | integer | yes | Pay run id. |
List the business's timesheet lines: employee, start/end time, units, work type, location, status, comments, breaks. Filter by employee or date with OData, e.g. "EmployeeId eq 123 and StartTime gt datetime'2026-04-01T00:00:00'". GET /business/{businessId}/timesheet (OData: $filter, $orderby, $top, $skip).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
One timesheet line by id. GET /business/{businessId}/timesheet/{timesheetLineId}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| timesheet_id | integer | yes | Timesheet line id (from keypay_list_timesheets). |
List the business's leave requests: employee, leave category, from/to date, total hours, status (Approved, Pending, Rejected, Cancelled), notes. Filter by status, dates, category, location or employee. GET /business/{businessId}/leaverequest.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| status | string | no | Only requests with this status. |
| from_date | string | no | Only leave starting on or after this date (yyyy-mm-dd). |
| to_date | string | no | Only leave ending on or before this date (yyyy-mm-dd). |
| leave_category_id | integer | no | Only this leave category (keypay_list_leave_categories). |
| location_id | integer | no | Only this location (keypay_list_locations). |
| employee_id | integer | no | Only this employee. |
One leave request: employee, category, dates, hours, status, notes. GET /business/{businessId}/employee/{employeeId}/leaverequest/{leaveRequestId}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| employee_id | integer | yes | Employee id. |
| leave_request_id | integer | yes | Leave request id (from keypay_list_leave_requests). |
Leave categories of the business (annual, personal/sick, long service...): id, name, unit type, accrual rule. GET /business/{businessId}/leavecategory (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
Pay schedules of the business: id, name, frequency, last date paid, last pay run. Bank and tax account details are removed. GET /business/{businessId}/payschedule (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
Locations of the business (sites, departments): id, name, parent, fully qualified name, state. GET /business/{businessId}/location (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
Pay categories (earnings types) of the business: id, name, rate unit, loadings, super rate, whether leave accrues. GET /business/{businessId}/paycategory (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
Work types of the business: id, name, pay category, leave category, short code. GET /business/{businessId}/worktype (OData).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| top | integer | no | Results per request, 1-100 (default 25; the API caps it at 100). |
| skip | integer | no | Results to skip (default 0). Pass the previous reply's next_skip. |
| filter | string | no | OData v3 $filter. Property names are capitalised, e.g. "Surname eq 'Smith'", "StartTime gt datetime'2026-04-01T00:00:00'", "DefaultSuperRate ne 9.5M". |
| orderby | string | no | OData $orderby, e.g. "Name" or "PayPeriodEnding desc". |
Gross-to-net report per employee: earnings by pay category, tax, deductions, super, net pay. Choose a date range (from_date + to_date) or one finalised pay run (pay_run_id). The report has no paging: at most 200 rows are returned (narrow with employee_id or location_id). GET /business/{businessId}/report/grosstonet.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| pay_run_id | integer | no | A pay run id: report that pay run (then from_date/to_date are ignored). |
| from_date | string | no | Start of the date range (yyyy-mm-dd), with to_date. |
| to_date | string | no | End of the date range (yyyy-mm-dd). |
| employee_id | integer | no | Only this employee. |
| location_id | integer | no | Only this location. |
| pay_schedule_id | integer | no | Only this pay schedule. |
Leave balances of all employees as at a date, per leave category. The report has no paging: at most 200 rows are returned (narrow with location_id or leave_category_id). For one employee use keypay_get_leave_balances. GET /business/{businessId}/report/leavebalances.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| as_at_date | string | no | Balances as at this date (yyyy-mm-dd); default today. |
| location_id | integer | no | Only this location. |
| leave_category_id | integer | no | Only this leave category. |
WRITE: approves a pending leave request (the employee is notified and the leave is applied to their pay). Check the request first with keypay_get_leave_request. Cannot be undone through this server. POST /business/{businessId}/employee/{employeeId}/leaverequest/{leaveRequestId}/approve.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| employee_id | integer | yes | Employee id. |
| leave_request_id | integer | yes | Leave request id. |
WRITE: declines a leave request, with an optional reason the employee sees. Check the request first with keypay_get_leave_request. POST /business/{businessId}/employee/{employeeId}/leaverequest/{leaveRequestId}/decline.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| business_id | integer | yes | Business id (from keypay_list_businesses). |
| employee_id | integer | yes | Employee id. |
| leave_request_id | integer | yes | Leave request id. |
| reason | string | no | Reason shown to the employee. |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Employment Hero Payroll MCP by usefulapi or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| coverage-honesty | manifest | inspection depth (manifest) — how much of the target the scan could see | −4 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
The scan read each tool’s name, description, input schema and annotations exactly as the server listed them the last time it answered us; no code was reviewed. We ask the server again about once a month, and a list that changed is graded again.
The implementation source was not read — this reflects the declared tool metadata only.
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| keypay_get_user | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_businesses | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_business | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_employees | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_employee | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_leave_balances | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_pay_runs | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_pay_run | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_pay_run_summaries | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_pay_run_summary | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_pay_run_totals | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_pay_run_payslips | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_pay_run_warnings | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_timesheets | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_timesheet | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_leave_requests | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_get_leave_request | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_leave_categories | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_pay_schedules | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_locations | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_pay_categories | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_list_work_types | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_report_gross_to_net | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_report_leave_balances | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| keypay_approve_leave_request | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
| keypay_decline_leave_request | external-sink | external-sink: declares readOnlyHint: false, destructiveHint: true, openWorldHint: true |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.20.2.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Employment Hero Payroll MCP by usefulapi can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.