Nepal Payroll MCP Server: Calculators for AI Apps
Free Nepal payroll calculators for AI apps that accept custom servers, such as Claude. No sign-in. Salary tax, SSF, the current minimum wage, Nepali dates, the fiscal year and the BS 2083 holidays, from the same figures as the calculators on this site. This server knows Nepal's payroll rules, not your company's data.
- No sign-in
- Read-only
- FY 2083/84 figures
- No company data
The server in four facts
- Read-only tools
- 6
- Sign-in or account needed
- None
- Tax slabs applied
- FY 2083/84
- Dates it converts
- BS 2000–2090
Server address
Streamable HTTP · No sign-in · Read-only. Paste it wherever your app asks for a remote MCP server URL.
Add the calculators to Claude
- Open Customize, then Connectors.
- Choose Add, then Add custom connector.
- Name it Nepal payroll calculators and paste the server address. Choose Continue.
- Under Authentication, choose No sign in, then Add.
On Team and Enterprise plans an Owner adds it once under Organization settings, Connectors, and members then choose Connect.
Add the calculators to Cursor
Add this to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json for one:
{
"mcpServers": {
"nepal-payroll-calculators": {
"url": "https://nepalhrm.com/mcp"
}
}
}Then switch it on under Customize in Cursor's sidebar.
Add the calculators to ChatGPT
Custom servers in ChatGPT depend on your plan, and on workspace plans an admin may need to turn on developer mode first. Check OpenAI's help centre for yours.
- Turn on developer mode in ChatGPT's settings.
- Create a new app or connector with the server address and no authentication.
- Switch it on from the tools menu in a chat.
The 6 tools
- Nepal salary tax, FY 2083/84
salary_tax_fy_2083_84 - Monthly TDS, PF, CIT or SSF, net take-home pay and employer cost for a gross salary.
- Nepal SSF contribution
ssf_contribution - Employee 11%, employer 20% and the total, monthly and yearly.
- Nepal minimum wage
minimum_wage - The current minimum wage: basic, dearness allowance and the monthly, daily and hourly totals.
- Nepali date conversion, BS and AD
bs_ad_date_convert - Bikram Sambat to Gregorian and back, BS 2000 to 2090.
- Nepal fiscal year
nepali_fiscal_year - Which fiscal year a date falls in, its start and end in both calendars, and its twelve months.
- Nepal public holidays, BS 2083
public_holidays_2083 - The Government of Nepal's BS 2083 holiday notice, with BS and AD dates and who each day applies to.
From a Question to a Checked Figure
The server does arithmetic and lookups. Your AI app decides when to call it and shows you the answer, with its source and a link to check it.
- 1
Copy the server address
https://nepalhrm.com/mcp. It speaks the Streamable HTTP transport and needs no sign-in, so there is nothing else to set up.
- 2
Add it as a custom server
In Claude, Cursor or another app that accepts custom MCP servers, add the address as a new server. The steps for each app are above.
- 3
Ask in plain words
For example: what is the TDS on a monthly salary of NPR 120,000 under SSF, or which BS date is 1 January 2027. The app picks the tool and fills in the numbers.
- 4
Check the figure
Every answer names its source, says what it leaves out, and links to the matching page on this site, so you can check the number yourself.
Last updated · Reviewed by Rajendra Regmi, Co-founder
What the Server Calculates With
The same figures every calculator on this site uses, for FY 2083/84. When one changes, the server and the calculators change together, because they read the same module.
| Figure | Value | Where it comes from |
|---|---|---|
| Income tax, Up to NPR 1,000,000 | 1% (0% for SSF contributors) | Income Tax Act 2058, Schedule 1, FY 2083/84 |
| Income tax, NPR 1,000,001 – 1,500,000 | 10% | Income Tax Act 2058, Schedule 1, FY 2083/84 |
| Income tax, NPR 1,500,001 – 2,500,000 | 20% | Income Tax Act 2058, Schedule 1, FY 2083/84 |
| Income tax, NPR 2,500,001 – 4,000,000 | 27% | Income Tax Act 2058, Schedule 1, FY 2083/84 |
| Income tax, Above NPR 4,000,000 | 29% | Income Tax Act 2058, Schedule 1, FY 2083/84 |
| Provident Fund | 10% employee, 10% employer, of basic | Labour Act 2074, section 52 |
| Social Security Fund | 11% employee, 20% employer, of basic | Contribution Based Social Security Act 2074 |
| Retirement deduction | The lowest of the actual contribution, one-third of assessable income or NPR 500,000 a year | Income Tax Act 2058, section 63 |
| Minimum wage | NPR 19,550 a month (basic NPR 12,170 plus dearness allowance NPR 7,380) | Nepal Gazette, 2082/04/05 BS, in force from Shrawan 1, 2082 |
| Public holidays owed | 13 a year, 14 for female employees | Labour Act 2074, section 41 |
| BS 2083 holiday notice | 34 days for a general employee, binding government offices | Ministry of Home Affairs, Government of Nepal, Nepal Rajpatra, Khanda 75, Sankhya 67, Bhag 5 |
| Date conversion | BS 2000 to 2090; years after 2083 marked provisional | Bikram Sambat month-length table, checked against the MoHA notice |
Does not apply the 10% rebate for women, the Finance Act 2083 reliefs or the SSF monthly contribution ceiling. Every answer is an estimate and says so.
Nepal's Rules, Not Your Records
It never sees company data
This server knows Nepal's payroll rules, not your company's data. A tool receives only what your app sends for one question, such as a salary figure or a date, and keeps none of it. Nothing ties it to a NepalHRM account.
What is logged
The name of the tool that was called, and a daily count. Never the salary, the date or anything else in the question.
Estimates, not tax advice
Each answer is an estimate from NepalHRM's published FY 2083/84 figures and lists what it leaves out: the 10% rebate for women, the Finance Act 2083 reliefs and the SSF monthly contribution ceiling are not applied.
The minimum wage is a lookup
It returns the current minimum wage as published in the Nepal Gazette on 2082/04/05 BS, with the date it took effect. It takes no input and computes nothing.
Dates after BS 2083 are provisional
Published calendar tables agree through BS 2083 and differ after it. A date in BS 2084 or later comes back marked provisional, and a date outside BS 2000 to 2090 is refused rather than guessed.
The holiday notice is not your obligation
The BS 2083 notice binds government offices and public bodies. A private employer owes 13 paid public holidays a year, 14 to a female employee, under section 41 of the Labour Act, and chooses the days. The holiday tool says so in every answer.
Nepal Payroll MCP Server, Answered
MCP, the Model Context Protocol, is an open standard that lets an AI app call tools outside itself. This one gives an app 6 Nepal payroll tools: salary tax, SSF, the current minimum wage, date conversion, the fiscal year and the BS 2083 holidays.
Any app that accepts a custom MCP server over Streamable HTTP. Claude's help centre lists custom connectors on its Free, Pro, Max, Team and Enterprise plans, with one custom connector on Free (checked 16 October 2026). Cursor reads it from mcp.json. In ChatGPT, custom servers depend on your plan and, on workspace plans, on an admin turning on developer mode.
No. This server knows Nepal's payroll rules, not your company's data. It answers from figures it already holds, using only the numbers or dates in your question, and it keeps none of them.
No. The server is free and needs no sign-in, account or registration.
Treat them as estimates, not tax advice. Each answer comes from NepalHRM's published FY 2083/84 figures and says what it leaves out. Before a filing, check the figure against the Inland Revenue Department's rules or with a tax adviser.
The tax slabs and contribution rates are for FY 2083/84. The minimum wage is the rate in force from Shrawan 1, 2082, last checked for a revision on 2026-08-06. The holidays are the BS 2083 notice. The server and this site's calculators read the same source, so they change together.
While You're Here, Try These Too
Every NepalHRM tool is free, runs in your browser and needs no account. See all of the free Nepal payroll and tax calculators.
One Question Here, Every Payslip in NepalHRM
The server answers one calculation at a time. NepalHRM payroll applies the same rules to every employee each month, on the Business and Enterprise plans.
- 30-day free trial
- Payroll on Business and Enterprise
- Free onboarding