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_payrollNet pay with EPF, SOCSO, EIS, PCB, and employer contributions
calculate_epfKWSP employee and employer contributions
calculate_socsoPERKESO Category 1 (under 60) or Category 2 (60+)
calculate_eisSIP contributions with citizen/PR eligibility
calculate_pcbMonthly tax deduction (MTD) estimate
calculate_employer_costGross 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.
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
Add the server to your AI host
Use local Node with workspace-resolved
tsxafter install. Avoid barenpx tsxso 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" } } }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