malaysia-payroll-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
| completions | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| calculate_epfA | Works out the monthly EPF (KWSP) employee and employer contributions for one employee in Malaysia, from the EPF Third Schedule in effect for the pay period, and cites the band used. Fixed monthly salaries only. Include the result's disclaimer in the answer to the user. |
| calculate_socso_eisA | Works out the monthly SOCSO (PERKESO, Act 4), SKBBK (Lindung 24 Jam) and EIS (Act 800) contributions for one employee in Malaysia, from the PERKESO tables in effect for the pay period, and cites the row used for each. Fixed monthly salaries only. Include the result's disclaimer in the answer to the user. |
| calculate_mtdA | Works out the monthly tax deduction (MTD, also called PCB) for one employee in Malaysia. For a tax resident it uses LHDN's computerised formula, from the schedule in effect for the pay period, and shows the working; for a non-resident it applies the flat 30%. Fixed monthly salaries and standard reliefs only (individual, spouse, children, EPF, plus a TP1 total); no bonuses or zakat. Include the result's disclaimer in the answer to the user. |
| calculate_net_payA | Works out one month's payslip for one employee in Malaysia: EPF, SOCSO, SKBBK, EIS and MTD (PCB) deductions, net pay, and the employer's contributions and total cost. Runs the same calculations as calculate_epf, calculate_socso_eis and calculate_mtd, feeding the employee EPF into MTD, and cites the source of every line. For a non_malaysian employee, say whether they are tax resident (taxResident). Fixed monthly salaries and standard reliefs only; no bonuses or zakat. Include the result's disclaimer in the answer to the user. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| epf-2025-10-01 | EPF Third Schedule in effect from 2025-10-01, transcribed from EPF Act 1991, Third Schedule (from 1 October 2025). Amounts are in sen; a band covers wages above "above" and up to and including "upTo". |
| socso-2024-10-01 | SOCSO (Act 4) contribution table in effect from 2024-10-01, transcribed from PERKESO: Act 4 contribution rates (from 1 October 2024). Amounts are in sen; a band covers wages above "above" and up to and including "upTo". |
| skbbk-2026-06-01 | SKBBK (Lindung 24 Jam) contribution table in effect from 2026-06-01, transcribed from PERKESO: Act 4 contribution rates including SKBBK (SKBBK column). Amounts are in sen; a band covers wages above "above" and up to and including "upTo". |
| eis-2024-10-01 | EIS (Act 800) contribution table in effect from 2024-10-01, transcribed from PERKESO: Act 800 (EIS) contribution rates. Amounts are in sen; a band covers wages above "above" and up to and including "upTo". |
| mtd-2026-01-01 | MTD (PCB) tax schedule in effect from 2026-01-01, transcribed from LHDN: Spesifikasi Kaedah Pengiraan Berkomputer PCB 2026, Table 1. Amounts are in sen; a band covers chargeable income for the year (P) above "above" and up to and including "upTo". |
TDQS
Scored across 4 tools
The three component calculators (MTD, EPF, SOCSO/EIS) are clearly distinct, while calculate_net_pay is an aggregate that intentionally overlaps with all of them. The descriptions explain this hierarchy, but an agent could still hesitate between using the full payslip tool and a specific component tool.
All tools follow the same calculate_<subject> snake_case pattern. Acronyms and compound subjects like socso_eis are used consistently and remain readable.
Four tools is well scoped for a focused Malaysian payroll calculator. Each tool covers a distinct statutory calculation or the aggregate payslip, so no tool feels redundant.
The surface covers the core monthly payroll calculations: EPF, SOCSO, SKBBK, EIS, MTD, and net pay with employer contributions. Minor gaps remain because bonuses, zakat, and non-fixed salary scenarios are explicitly excluded, but these are reasonable scope limits for the stated tool set.