About Sri Lanka Payslip
Sri Lanka Payslip is a reference calculator for regular primary employment in Sri Lanka, for payroll estimation and review. It estimates APIT/PAYE, EPF, ETF, stamp duty, net pay, and employer cost using documented sources, and offers a local MCP mode that does not transmit salary inputs externally.
Key features
- 01Calculate APIT/PAYE and contributions
- 02Estimate net pay and employer cost
- 03Provide payroll references and sources
- 04Check payslip fields and arithmetic
- 05Keep salary inputs local when run locally
Use cases
- 01Estimate monthly take-home pay in Sri Lanka
- 02Check EPF, ETF, and stamp duty
- 03Prepare or review payslip fields
- 04Query payroll calculations through a local AI assistant
MCP support
It provides three read-only tools to calculate a payslip, retrieve payroll references, and prepare a payslip checklist. It can connect through a remote Streamable HTTP endpoint or run locally over stdio; local mode does not send salary inputs to external services.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mypayslip.lk/api/mcpclaude mcp add --transport http buddhima-jd3-sri-lanka-payslip https://mypayslip.lk/api/mcp{"mcpServers":{"buddhima-jd3-sri-lanka-payslip":{"type":"http","url":"https://mypayslip.lk/api/mcp"}}}Open in Cursor{"servers":{"buddhima-jd3-sri-lanka-payslip":{"type":"http","url":"https://mypayslip.lk/api/mcp"}}}Open in VS Code{"mcpServers":{"buddhima-jd3-sri-lanka-payslip":{"type":"http","url":"https://mypayslip.lk/api/mcp"}}}{"mcpServers":{"buddhima-jd3-sri-lanka-payslip":{"serverUrl":"https://mypayslip.lk/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
ghcr.io/buddhima-jd3/sri-lanka-payslip-mcp:2026.27.2stdioTools
3| Parameter | Type | Required | Description |
|---|---|---|---|
| grossSalary | number | Yes | Gross monthly employment income in Sri Lankan rupees |
| epfEtfEarningsBase | number | No | EPF/ETF-eligible monthly earnings; defaults to gross salary |
| otherEmployeeDeductions | number | No | Optional non-statutory employee deductions, such as a loan repayment |
Details
From the project READMESri Lanka Salary Calculator and Payslip Reference
An inspectable reference implementation for estimating a regular primary employment payslip in Sri Lanka. It calculates monthly APIT (PAYE), employee EPF, employer EPF, employer ETF, stamp duty, net pay, and employer cost.
The current reference is maintained by MyPayslip.lk for the Sri Lanka 2026/27 year of assessment. The latest regular-employment APIT table published by the Inland Revenue Department is labelled 2025/26; the relief and rates effective from 1 April 2025 remain the basis used for 2026/27.
Try the calculator
- Developer reference
- Sri Lanka salary calculator
- Embeddable salary calculator widget
- Payslip generator
- How to read and check a Sri Lankan payslip
- Calculation methodology
No account is required. The hosted calculator runs in the browser, and the public calculation API does not store salary inputs.
Verified example
For a monthly gross salary and EPF/ETF contribution base of LKR 200,000:
| Item | Monthly amount |
|---|---|
| Gross salary | LKR 200,000 |
| APIT / PAYE | LKR 3,000 |
| Employee EPF (8%) | LKR 16,000 |
| Stamp duty | LKR 25 |
| Estimated net pay | LKR 180,975 |
| Employer EPF (12%) | LKR 24,000 |
| Employer ETF (3%) | LKR 6,000 |
Run the same case locally:
node examples/calculate.mjs 200000
Or call the hosted read-only API:
curl "https://mypayslip.lk/api/calc?salary=200000"
Reference implementation
calculator.mjs is intentionally dependency-free. It
accepts a gross monthly salary and an optional EPF/ETF eligible earnings base.
The contribution base should come from payroll records when excluded or
unusual payments make it different from gross salary.
Install the package from npm after its first registry release, or directly from this public repository now:
npm install github:Buddhima-JD3/sri-lanka-salary-calculator
import { calculateSalary } from "sri-lanka-salary-calculator";
const result = calculateSalary({
grossSalary: 200000,
epfEtfEarningsBase: 200000,
});
console.log(result.netPay); // 180975
Verify the published examples:
npm test
Use with an AI assistant
This repository includes a local Model Context Protocol server built with the official MCP SDK. It gives compatible AI assistants three read-only tools:
| Tool | Purpose |
|---|---|
calculate_sri_lanka_payslip | Calculate APIT/PAYE, EPF, ETF, stamp duty, net pay, and employer cost |
get_sri_lanka_payroll_reference | Retrieve maintained assumptions, scope limits, and official sources |
get_sri_lanka_payslip_checklist | Prepare or review the required payslip fields and arithmetic checks |
Use the no-auth Streamable HTTP endpoint when the client supports remote MCP servers:
https://mypayslip.lk/api/mcp
The same tools can run locally over stdio. In that mode, salary inputs are not sent to MyPayslip.lk or another external service.
Official MCP Registry:
io.github.Buddhima-JD3/sri-lanka-payslip
Agent-oriented installation instructions are available in
llms-install.md.
The Registry package is a public AMD64/ARM64 container:
docker run -i --rm ghcr.io/buddhima-jd3/sri-lanka-payslip-mcp:2026.27.2
Add it to an MCP client configuration:
{
"mcpServers": {
"sri-lanka-payslip": {
"command": "npx",
"args": [
"-y",
"github:Buddhima-JD3/sri-lanka-salary-calculator"
]
}
}
}
Or start it from this repository:
npm install
npm run mcp
Machine-readable references
- OpenAPI 3.1 specification
- Calculation methodology and test cases
- Archived v2026.27.2 source
- Live OpenAPI: https://mypayslip.lk/openapi.json
- Live methodology: https://mypayslip.lk/calculation-methodology.json
- Agent guidance: https://mypayslip.lk/llms.txt
Primary sources
- Inland Revenue Department APIT tax tables
- Inland Revenue Department income tax
- Central Bank of Sri Lanka Employees' Provident Fund
- Employees' Trust Fund Board employer guidance
- Inland Revenue Department stamp duty
Scope
This reference covers regular profits from primary employment. Bonus, terminal-benefit, secondary-employment, non-resident, and unusual payroll cases may require a different APIT table or professional review. Results are estimates, not payroll, tax, or legal advice.
When citing a result, use:
MyPayslip.lk, Sri Lanka 2026/27 payslip calculation methodology, verified 17 July 2026.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.