Taiwan Payroll
@supra126
About Taiwan Payroll
Taiwan statutory payroll calculation — labor & health insurance, labor pension, 2nd-gen NHI supplementary premium, income-tax withholding, and labor-insurance old-age benefits. Sourced from official gazettes, verified against official sample data. TS (npm) + Python (PyPI) + MCP (
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"taiwan-payroll": {
"command": "npx",
"args": [
"-y",
"taiwan-payroll-mcp"
]
}
}
}Tools
9計算台灣某月薪資的勞保（含就保）、健保、勞退、職災各方（員工/雇主/政府）負擔。支援不同身份別、眷屬、自提、部分工時。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
計算二代健保補充保費（費率 2.11%）。bonus 課徵年度累計超過當月投保額 4 倍部分；其餘五類單次達門檻全額課（單次上限 1,000 萬）。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
計算雇主端二代健保補充保費（費率 2.11%）：(每月支付薪資總額 − 受僱者當月健保投保金額總額) × 費率，無上限。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
計算薪資所得扣繳稅額：居住者固定月薪(公式法)、非每月給付獎金(5%，未達起扣標準免扣)、非居住者(18%；月薪≤1.5倍基本工資為6%)。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
依勞保老年年金法定公式（擇優兩式、提前/延後增減給每年 ±4%，上限 ±5 年（±20%））試算月領金額；年資未滿 15 年不符年金請領資格。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
依勞保老年一次金法定公式（平均月投保薪資 × 給付月數；年資每滿 1 年給 1 個月、逾 60 歲後之年資最多計入 5 年）試算給付金額。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
依勞保一次請領老年給付法定公式（基數制：前 15 年每年 1 個基數、第 16 年起每年 2 個基數、60 歲前最高 45 個基數、逾 60 歲後年資每年 2 個基數最多計 5 年、合併最高 50 個基數）試算給付金額。適用 98 年前已有保險年資者。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
計算月中到職或離職當月的破月保費。勞保/職保/勞退按日（30 日基準）；健保採官方「月底歸屬」——到職當月計整月、離職當月不計。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
列出目前支援的年度、資料版本與基本工資（月薪/時薪）。計算前可先用本工具確認有效的 year 值。
Overview
What is Taiwan Payroll?
Taiwan Payroll is an open-source calculation engine for Taiwan’s statutory labor insurance, health insurance, pension, occupational accident, and second-generation NHI supplementary premium. It supports multiple identities, pro‑rated calculations for mid‑month join/leave, generation of NHI supplementary premium filing CSV files, and old‑age pension benefit trials. The engine is available as TypeScript (npm), Python (PyPI), and an MCP server for AI assistants.
How to use Taiwan Payroll?
Install the core library via npm install taiwan-payroll or pip install taiwan-payroll. For AI assistants, use the MCP server remotely at https://taiwan-payroll.simoko.workers.dev/mcp (Streamable HTTP) or locally with npx taiwan-payroll-mcp (stdio). Call functions like createPayrollEngine({ year }) then engine.calculate(...) with salary and identity parameters.
Key features of Taiwan Payroll
- Zero runtime dependencies in core packages.
- Cross‑language consistency between TypeScript and Python.
- Built‑in official parameters for years 2024–2026.
- Generates NHI supplementary premium filing CSV (Big5).
- Calculates old‑age pension benefits (annuity, lump sum, single payment).
- Pro‑rated calculations follow official “end‑of‑month attribution” rule for health insurance.
Use cases of Taiwan Payroll
- Compute employee and employer contributions for a given monthly salary and identity.
- Pro‑rate labor insurance, pension, and health insurance for employees joining or leaving mid‑month.
- Generate NHI supplementary premium filing files for all six categories.
- Trial old‑age pension amounts (annuity, lump sum, single payment) based on official formulas.
FAQ from Taiwan Payroll
What calculations does Taiwan Payroll support?
It calculates labor insurance (including employment insurance), health insurance, pension, occupational accident premium, and second‑generation NHI supplementary premium for both employee and employer sides. It also handles pro‑rated amounts, supplementary premium filing, and old‑age pension benefits.
What are the runtime dependencies?
The core packages have zero runtime dependencies. The MCP server may require a Node.js runtime but no extra frameworks.
Which years are supported?
Taiwan Payroll includes built‑in parameters for the years 2024, 2025, and 2026. You can specify the year with createPayrollEngine({ year }) and list available years via getAvailableYears().
How can I use Taiwan Payroll as an MCP server with an AI assistant?
You can either use the remote Streamable HTTP endpoint (no local installation) or run the server locally with npx taiwan-payroll-mcp (stdio). The server is listed on the official MCP Registry, Smithery, and Glama.
Is the calculation legally guaranteed?
No. The engine is a reference implementation based on official tables and rates. Actual amounts are determined by the Labor Insurance Bureau and National Health Insurance Administration. Taiwan Payroll does not constitute legal or accounting advice.
Frequently asked questions
What calculations does Taiwan Payroll support?
It calculates labor insurance (including employment insurance), health insurance, pension, occupational accident premium, and second‑generation NHI supplementary premium for both employee and employer sides. It also handles pro‑rated amounts, supplementary premium filing, and old‑age pension benefits.
What are the runtime dependencies?
The core packages have zero runtime dependencies. The MCP server may require a Node.js runtime but no extra frameworks.
Which years are supported?
Taiwan Payroll includes built‑in parameters for the years 2024, 2025, and 2026. You can specify the year with `createPayrollEngine({ year })` and list available years via `getAvailableYears()`.
How can I use Taiwan Payroll as an MCP server with an AI assistant?
You can either use the remote Streamable HTTP endpoint (no local installation) or run the server locally with `npx taiwan-payroll-mcp` (stdio). The server is listed on the official MCP Registry, Smithery, and Glama.
Is the calculation legally guaranteed?
No. The engine is a reference implementation based on official tables and rates. Actual amounts are determined by the Labor Insurance Bureau and National Health Insurance Administration. Taiwan Payroll does not constitute legal or accounting advice.
Basic information
More Other MCP servers
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Codelf
unbugA search tool helps dev to solve the naming things problem.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
ICSS
chokcoco不止于 CSS
Comments