# Malaysia Payroll MCP — HavaHR calculators for AI agents

> Malaysian statutory payroll calculators over the Model Context Protocol. Free, no account, no API key.
> Canonical page: https://www.havahr.com/tools/malaysia-payroll-mcp

Same engine as the HavaHR product and the free calculators on this site, so the numbers agree to the sen.

## Install

Remote — Streamable HTTP, nothing to install:

```json
{
  "mcpServers": {
    "havahr-calculators": {
      "url": "https://www.havahr.com/api/mcp"
    }
  }
}
```

Local — stdio via npm (Node 20+):

```json
{
  "mcpServers": {
    "havahr-calculators": {
      "command": "npx",
      "args": ["-y", "@havahr/mcp-calculators"]
    }
  }
}
```

The remote endpoint is `https://www.havahr.com/api/mcp`; its manifest is at `https://www.havahr.com/.well-known/mcp`.

## Tools

### `calculate_malaysia_payroll` — Malaysia payroll (full statutory)

Calculate Malaysian net pay with EPF, SOCSO, EIS, SKBBK (Lindung 24 Jam), and PCB deductions plus employer contributions. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** A user asks what a Malaysian salary nets after statutory deductions, or wants a payslip breakdown.

### `calculate_epf` — EPF (KWSP)

Calculate Malaysian EPF (KWSP) employee and employer contributions from official Third Schedule rates. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Only the EPF/KWSP employee and employer contribution is needed.

### `calculate_socso` — SOCSO (PERKESO)

Calculate Malaysian SOCSO (PERKESO) contributions (Category 1 under 60, Category 2 for 60+). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Only the SOCSO/PERKESO contribution is needed, including the age 60+ Category 2 split.

### `calculate_eis` — EIS (SIP)

Calculate Malaysian EIS (SIP) contributions with eligibility (citizen or PR, age 18–60). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Only the EIS/SIP contribution is needed, including eligibility by citizenship and age.

### `calculate_skbbk` — SKBBK (Lindung 24 Jam)

Calculate Malaysian SKBBK (Lindung 24 Jam / non-employment injury) employee contribution from the official PERKESO table (≈0.75% schedule, RM6,000 wage ceiling), with effective-date and opt-out eligibility. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Checking the Lindung 24 Jam (SKBBK) employee deduction for a specific wage month, including opt-out handling.

### `calculate_pcb` — PCB (MTD)

Estimate Malaysian PCB / monthly tax deduction (MTD) from salary and tax category inputs. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Estimating monthly income tax withholding (PCB/MTD) for a salary and tax category.

### `calculate_employer_cost` — Employer hiring cost

Calculate total employer outlay for a Malaysian salary: gross plus statutory employer contributions (SKBBK is employee-only). Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** A user asks what an employee really costs the employer, or is budgeting a new hire.

### `calculate_overtime` — Overtime & public holiday pay

Calculate Malaysian overtime pay under the Employment Act 1955: normal day 1.5x, rest day 2x/3x, public holiday 2x daily rate plus 3x hourly OT, with 45-hour week and 104-hour monthly OT compliance checks. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Working out Employment Act 1955 overtime, rest-day, or public-holiday pay, and the 45h/104h compliance limits.

### `calculate_leave_proration` — Annual leave proration

Prorate Malaysian annual leave entitlement for mid-year joiners or leavers by calendar or service year, with optional unpaid-leave adjustment. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Prorating annual leave for a mid-year joiner or leaver, or for an unpaid-leave adjustment.

### `check_employment_act_coverage` — Employment Act coverage check

Check whether an employee is covered by the Malaysian Employment Act 1955 (RM4,000 threshold, manual labor, domestic work) with rationale and references. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Deciding whether Employment Act 1955 entitlements apply to a given employee.

### `calculate_hrd_corp_levy` — HRD Corp (HRDF) levy

Calculate the Malaysian HRD Corp (HRDF) levy: mandatory 1% for 10+ Malaysian employees, voluntary 0.5% for 5-9, with monthly/annual levy and training budget. Malaysia statutory estimates from HavaHR (same engine as https://www.havahr.com free calculators). Estimates only — not official advice. Confirm with KWSP/PERKESO/LHDN or a payroll professional for filing.

**When to use:** Working out the HRD Corp (HRDF) levy and the training budget it funds.

## Also available as REST

Every tool above is also a JSON endpoint under `https://www.havahr.com/api/v1/calculators`, described by `https://www.havahr.com/openapi.json`. The `operationId` in the OpenAPI document matches the MCP tool name.

See https://www.havahr.com/developers for the full API reference.

## Disclaimer

Estimates only — not official advice. Confirm with KWSP, PERKESO, or LHDN before filing.
