Features

Key features (overview)Use casesLeave management
PayrollToolsPricingBlog

HavaHR

Malaysia payroll MCP

Give your AI the same EPF, SOCSO, EIS, SKBBK, and PCB engine as our free calculators — local, auth-free, and built for Malaysian statutory math.

Install guideUse web calculators
  • No account or API key
  • No workspace data access
  • Same engine as havahr.com

Ten tools

One primary payroll call, plus focused statutory, overtime, leave, and levy tools.

  • calculate_malaysia_payroll

    Net pay with EPF, SOCSO, EIS, SKBBK (Lindung 24 Jam), PCB, and employer contributions

  • calculate_epf

    KWSP employee and employer contributions

  • calculate_socso

    PERKESO Category 1 (under 60) or Category 2 (60+)

  • calculate_eis

    SIP contributions with citizen/PR eligibility

  • calculate_skbbk

    SKBBK (Lindung 24 Jam) employee contribution — PERKESO table, RM6,000 ceiling

  • calculate_pcb

    Monthly tax deduction (MTD) estimate

  • calculate_employer_cost

    Gross plus employer statutory outlay

  • calculate_overtime

    EA 1955 overtime and public holiday pay (1.5x / 2x / 3x)

  • calculate_leave_proration

    Annual leave proration for mid-year joiners and leavers

  • check_employment_act_coverage

    Employment Act 1955 coverage check (RM4,000 threshold)

  • calculate_hrd_corp_levy

    HRD Corp (HRDF) levy: mandatory 1% or voluntary 0.5%

Install

About 2 minutes. Requires Node.js 20+ and an MCP host. No HavaHR account or monorepo clone — your host runs npx -y @havahr/mcp-calculators.

  1. Add the server to your AI host

    Pick your host, paste the config, then restart if needed. First launch may download the package via npx.

    Open Cursor Settings → MCP → add a server, or merge this into ~/.cursor/mcp.json (or .cursor/mcp.json for the project). Restart if tools do not appear.

    Cursor mcp.json

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

  2. Ask a payroll question

    After connect, the host should list havahr-calculators. Try one of these:

    • Prompt

      What is take-home pay for RM4,000 gross in Malaysia at age 43?

    • Prompt

      Calculate EPF for a Malaysian employee earning RM6,000.

    • Prompt

      What is the total employer cost for a RM5,000 salary?

    • Prompt

      How much overtime pay for 10 OT hours on a RM2,600 salary?

    • Prompt

      Prorate 12 days annual leave for someone who joined on 1 July.

    • Prompt

      What is the HRD Corp levy for 20 staff with RM80,000 total wages?

    Expected check: RM4,000 at age 43 → EPF employee RM440, employer RM520.

Optional: install from a HavaHR monorepo checkout

For contributors with an authorized local clone. Build the package once, then point your host at the compiled bin — do not publish private clone URLs or credentials.

Terminal

cd /ABSOLUTE/PATH/TO/hava4
npm install
npm run build -w @havahr/mcp-calculators

Host config (after build)

{
  "mcpServers": {
    "havahr-calculators": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/hava4/packages/mcp-calculators/dist/index.js"
      ]
    }
  }
}

Safety

  • Runs only as a local stdio process spawned by your AI host.
  • No login, tokens, customer data, or outbound network calls from the calculator tools.
  • Pure calculation over HavaHR’s shared statutory tables.
  • Public install is the slim npm package only — never paste private repo credentials into MCP configs.

FAQ

Need payroll for the whole company?

HavaHR runs leave, attendance, payslips, and Malaysian statutory payroll in one place — without spreadsheet chaos.

  • Malaysian EPF, SOCSO, EIS, SKBBK, PCB built in
  • Employee self-service on web and mobile
  • Built for SMEs, not enterprise config theaters
Start freeFree calculators