@supra126
Basic information
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 (
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"taiwan-payroll": {
"command": "npx",
"args": [
"-y",
"taiwan-payroll-mcp"
]
}
}
}計算台灣某月薪資的勞保（含就保）、健保、勞退、職災各方（員工/雇主/政府）負擔。支援不同身份別、眷屬、自提、部分工時。結果僅供參考，以勞保局、健保署核發之繳款單為準，不構成法律或會計建議。
計算二代健保補充保費（費率 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 值。
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.
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.
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.
The core packages have zero runtime dependencies. The MCP server may require a Node.js runtime but no extra frameworks.
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()`.
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.
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.
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
Model Context Protocol Servers
A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi
Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea
Comments