PayrollToolsPricingBlog

HavaHR

Malaysia payroll MCP

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

  • No account or API key
  • No workspace data access
  • Same engine as havahr.com

Six tools

One primary payroll call, plus focused statutory tools.

  • calculate_malaysia_payroll

    Net pay with EPF, SOCSO, EIS, 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_pcb

    Monthly tax deduction (MTD) estimate

  • calculate_employer_cost

    Gross plus employer statutory outlay

Install

About 10 minutes. Requires Node.js 20+, Cursor or Claude Desktop, and a HavaHR monorepo checkout you already have access to. Replace /ABSOLUTE/PATH/TO/hava4 with your absolute path.

  1. Use your HavaHR checkout and install dependencies

    Prefer an existing local clone. Run install once at a path you keep on disk — do not clone into shared or untrusted environments.

    Terminal

    cd /ABSOLUTE/PATH/TO/hava4
    npm install
  2. Add the server to your AI host

    Use local Node with workspace-resolved tsx after install. Avoid bare npx tsx so the host does not download packages at runtime.

    Open Cursor Settings → MCP → add a server, or merge this into your mcp.json. Then restart Cursor.

    Cursor mcp.json

    {
      "mcpServers": {
        "havahr-calculators": {
          "command": "node",
          "args": [
            "--import",
            "tsx",
            "packages/mcp-calculators/src/index.ts"
          ],
          "cwd": "/ABSOLUTE/PATH/TO/hava4"
        }
      }
    }
  3. Ask a payroll question

    After restart, 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

      Estimate PCB for a single resident on RM5,000 monthly.

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

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.
  • Install from an authorized checkout only — never share private repo credentials in public 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, PCB built in
  • Employee self-service on web and mobile
  • Built for SMEs, not enterprise config theaters