MCP server

Employment Hero Payroll MCP by usefulapi

io.usefulapi/keypay

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read Employment Hero Payroll pay runs, payslips, timesheets and leave; approve or decline leave.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

26

Token cost

About 6,873 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http keypay https://keypay.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.keypay]
url = "https://keypay.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"keypay":{"httpUrl":"https://keypay.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"keypay":{"url":"https://keypay.usefulapi.io/mcp"}}}

VS Code

{"servers":{"keypay":{"type":"http","url":"https://keypay.usefulapi.io/mcp"}}}

Antigravity

agy mcp add keypay https://keypay.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"keypay","server_url":"https://keypay.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"keypay","server_url":"https://keypay.usefulapi.io/mcp"}

Tools

• keypay_approve_leave_request ~251 tokens
  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.
• keypay_decline_leave_request ~262 tokens
  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.
• keypay_get_business ~132 tokens
  One business by id: name, legal name, contact, address, ABN/company details, leave year, standard hours, pay cycle. GET /business/{businessId}.
• keypay_get_employee ~243 tokens
  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
• keypay_get_leave_balances ~216 tokens
  An employee's leave balances per leave category (accrued amount and unit), optionally as at a date. GET /business/{businessId}/employee/{employeeId}/leavebalances.
• keypay_get_leave_request ~220 tokens
  One leave request: employee, category, dates, hours, status, notes. GET /business/{businessId}/employee/{employeeId}/leaverequest/{leaveRequestId}.
• keypay_get_pay_run ~172 tokens
  One pay run by id: pay schedule, period, date paid, whether it is finalised, notation. GET /business/{businessId}/payrun/{payRunId}.
• keypay_get_pay_run_payslips ~253 tokens
  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}/paysli
• keypay_get_pay_run_summary ~161 tokens
  One pay run with its total hours, gross wages and net wages. GET /business/{businessId}/payrun/{payRunId}/summary.
• keypay_get_pay_run_totals ~185 tokens
  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.
• keypay_get_timesheet ~161 tokens
  One timesheet line by id. GET /business/{businessId}/timesheet/{timesheetLineId}.
• keypay_get_user ~74 tokens
  The Employment Hero Payroll user this API key belongs to: id, email, display name and time zone. GET /user.
• keypay_list_businesses ~285 tokens
  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).
• keypay_list_employees ~366 tokens
  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/
• keypay_list_leave_categories ~323 tokens
  Leave categories of the business (annual, personal/sick, long service...): id, name, unit type, accrual rule. GET /business/{businessId}/leavecategory (OData).
• keypay_list_leave_requests ~400 tokens
  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.
• keypay_list_locations ~315 tokens
  Locations of the business (sites, departments): id, name, parent, fully qualified name, state. GET /business/{businessId}/location (OData).
• keypay_list_pay_categories ~323 tokens
  Pay categories (earnings types) of the business: id, name, rate unit, loadings, super rate, whether leave accrues. GET /business/{businessId}/paycategory (OData).
• keypay_list_pay_run_summaries ~320 tokens
  Pay runs with their totals: total hours, gross wages and net wages, plus the usual pay run fields. GET /business/{businessId}/payrun/summary (OData).
• keypay_list_pay_run_warnings ~182 tokens
  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.
• keypay_list_pay_runs ~338 tokens
  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).
• keypay_list_pay_schedules ~326 tokens
  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).
• keypay_list_timesheets ~364 tokens
  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, $
• keypay_list_work_types ~311 tokens
  Work types of the business: id, name, pay category, leave category, short code. GET /business/{businessId}/worktype (OData).
• keypay_report_gross_to_net ~409 tokens
  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}/r
• keypay_report_leave_balances ~281 tokens
  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.

Browse

• Email
• Payments
• Legal research

Related MCP servers

• PaySpace MCP by usefulapi
  Read PaySpace employees, organization, payroll runs, payslips and leave records. Read-only.
• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• Jet HR MCP by usefulapi
  Read Jet HR employees, absences, clockings, payroll; create, approve, delete leave; create expenses.
• Deputy MCP by usefulapi
  See rosters, timesheets, leave and staff in Deputy, and create shifts, leave and memos.
• Lintelly HR Deutschland
  German employment law for small companies: notice periods, costs, sick pay, contracts. No sign-in.
• Connecteam MCP by usefulapi
  Read Connecteam users, shifts, time clock, jobs, time off, tasks and forms; create shifts and tasks.
• Sri Lanka Payslip
  Source-backed Sri Lanka payslip tools for APIT/PAYE, EPF, ETF, stamp duty, and net pay.
• Tamigo MCP by usefulapi
  Read Tamigo departments, employees, shifts, absences and opening hours; register attendance.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/keypay.svg)](https://aptlynx.net/servers/io.usefulapi/keypay)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents